# 使用 Chocolatey 安裝 Gradle 流程分享 (Windows 開發環境)

> 本文記錄了在 Windows 環境下，為了解決一個不完整的 Gradle 專案問題，從零開始安裝 Chocolatey 套件管理器，並透過它來安裝 Gradle 開發工具的完整步驟與心得。

:::info
## 遇到的問題：無法執行的 Gradle 專案
:::

在執行一個 BDD 任務時，我們拿到了一個 Gradle 專案。然而，在嘗試執行 `.\gradlew.bat` 指令時，終端機持續回報「不是內部或外部命令」，經檢查後發現，專案資料夾內**根本沒有 `gradlew.bat` 這個 Gradle Wrapper 啟動器腳本**。

嘗試執行 `gradle wrapper` 指令來產生此檔案，但系統回報 `gradle` 指令本身不存在。這讓我們意識到問題的根源：**本機電腦上並未安裝 Gradle 這個全域的建置工具**。

---

:::info
## 解決方案：透過套件管理器進行乾淨安裝
:::

為了避免手動下載、解壓縮、並設定複雜的環境變數 (PATH)，我們決定採用更現代、更可靠的方式：使用 Windows 上的套件管理器 **Chocolatey** 來安裝 Gradle。這能確保一次性安裝到位，並自動處理好環境變數。

---

:::warning
## 安裝步驟
:::

### 步驟一：安裝 Chocolatey (Windows 套件管理器)

1. **以系統管理員身分執行 PowerShell**：
在 Windows 開始選單中找到 PowerShell，按右鍵選擇「以系統管理員身分執行」。這是執行安裝指令的必要權限。

2. **執行安裝腳本**：
在打開的藍色系統管理員 PowerShell 視窗中，貼上並執行 Chocolatey 官網提供的安裝指令：

    Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('[https://community.chocolatey.org/install.ps1](https://community.chocolatey.org/install.ps1)'))

3. **完成安裝**：
腳本執行完畢後，會提示 `Chocolatey (choco.exe) is now ready.`。依照提示，需要**關閉並重開** PowerShell 視窗，新的設定才會生效。

[此處應有截圖：Chocolatey 安裝成功的畫面]

### 步驟二：透過 Chocolatey 安裝 Gradle

1. **以系統管理員身分再次打開 PowerShell**。

2. **執行 Gradle 安裝指令**：
在新的系統管理員 PowerShell 視窗中，輸入 `choco install` 指令：

    choco install gradle

3. **同意執行**：
安裝過程中，會詢問是否同意執行腳本 `Do you want to run the script?`，輸入 `Y` 或 `A` (Yes to all) 並按下 `Enter` 即可。

4. **完成安裝**：
看到 `The install of gradle was successful.` 的訊息，就代表 Gradle 已經成功安裝。

[此處應有截圖：choco install gradle 成功運行的畫面]

### 步驟三：驗證安裝

1. **重新啟動終端機**：為了讓新的 PATH 環境變數生效，再次關閉所有 PowerShell 視窗，並打開一個**新的、普通的**終端機（VS Code 內建的或直接開 `cmd` 皆可）。

2. **執行版本驗證指令**：
輸入 `gradle -v` 來驗證 Gradle 是否安裝成功且可以被系統正確呼叫。

    gradle -v

3. **確認結果**：
成功的話，畫面上會顯示詳細的 Gradle 與 JVM 版本資訊，代表我們的開發環境已經完全準備就緒。

[此處應有截圖：gradle -v 成功顯示版本資訊的畫面]

---

:::success
## 結論
:::

透過以上步驟，成功地在 Windows 系統上建立了一個乾淨、可靠的 Gradle 開發環境。使用 Chocolatey 這樣的套件管理器，大大簡化了以往繁瑣的安裝與環境變數設定流程，可專注於解決主要的開發問題。

接下來，便可以回到原本的專案，執行 `gradle wrapper` 指令，來修復並完成開發任務了。