因為工作的關係，遇到需要透過 Azure DevOps 進行建置的工作，其環境是使用自家的 VM 作為 Agent (self–hosted agent)，所以需要在上面安裝相關的套件與設定環境變數。在設定過程中，若在 Agent 伺服器上藉由安裝 Android Studio 達到安裝 Android SDK 與 Gradle 其實不太合理，所以本篇文章會透過 Android Command line tools 來進行套件安裝。若有錯誤或任何建議，請各位前輩不吝提出。






另外，因應有些 self-hosted agent 無法對外連線，下列還有一些相關問題，在 Android Offline 時會遇到，包含：

1. 了解 Android Studio 使用的 Gradle library 來源
2. Android Studio 啟用 Gradle offline 方法 
3. 官方 offline build dependencies 使用方法
4. 完全無網路情境下，如何透過 Azure DevOps 進行 Android Build
5. Gradle HTTP Proxy Server 設定方法 



本篇文章大致上可以分成下列四個章節

1. 安裝 Build Agent 
2. 安裝 Java SDK
3. 透過 Android Command line tools 下載 platform-tool
4. Azure DevOps 設定 Pipeline (continuous integration)



安裝 Build Agent

1. 開啟 https://github.com/Microsoft/azure-pipelines-agent/releases，下載最新版本的 Agent 並解壓縮檔案至 C:\agent 底下，解壓縮完成你的資料夾內應該呈現如下



2. 開啟命令提示字元 (command line)，切換目錄至此資料夾 (cd c:\agent)





3. 輸入指令 config.cmd 開始執行安裝程序，過程中會詢問一些問題。請依據您的情境進行設定，下圖是參考內容。 注意：請在 run agent as service 設定選擇 Yes




4. 回到你的 Azure DevOps 或 TFS，你能看見 Agent 運作正常



透過 Android Command line tools 下載 platform-tool

1. 先到官方網站下載 Command line tools



2. 解壓縮至 C:\AndroidSDK (只需內部 cmdline-tools資料夾)，完成後應該如下圖：




3. 開啟 cmdline-tools ，建立新資料夾 latest，並將所有檔案移至剛剛建立的資料夾



完成後，你的資料夾與路徑如下圖






4. 接下來，我們要設定環境變數。點左下角開始按鈕，輸入環境變數，選擇編輯環境變數；




5. 選擇環境變數 > 新增



6. 設定環境變數 ANDROID_ROOT_SDK，值為 C:\AndroidSDK，點選OK



7. 開啟命令提示字元，切換目錄至 C:\AndroidSDK\cmdline-tools\lasest\bin




9. 輸入下列指令開始下載套件，我們要下載的套件為 platform 29 與 30，請依據你的需求進行安裝

sdkmanager "platform-tools" "platforms;android-29"

sdkmanager "platform-tools" "platforms;android-30"



中間會需要同意，輸入 Y，繼續安裝





9. 接下來，我們要設定環境變數。點左下角開始按鈕，輸入環境變數，選擇編輯環境變數；




6. 選擇環境變數 > 新增



7. 設定環境變數 ANDROID_HOME，值為 C:\AndroidSDK，點選OK



8.  接下來，選擇 Path 路徑 > 點選編輯 > 新增 > 加入兩個新的 Path，分別為%ANDROID_HOME%\tools 與%ANDROID_HOME%\platform-tools， 即完成 AndroidSDK 安裝







安裝 Java SDK

1. 首先，我們先下載 Java SDK 並進行安裝 (持續下一步直至安裝完成即可，所以安裝過程省略)



2. 接下來，我們要設定環境變數。點左下角開始按鈕，輸入環境變數，選擇編輯環境變數；




3. 選擇環境變數 > 新增



4. 分別在變數輸入 JAVA_HOME、值輸入 Java 安裝路徑 (預設是在C:\Program Files\Java\jre1.8.0_291，請依據你的版號不同更換路徑)，設定完成後點選 OK。



5.  接下來，選擇 Path 路徑 > 點選編輯 > 新增 > 加入新的 Path %JAVA_HOME_bin%，即完成 JAVA 安裝



6. 最後，完成 AndroidSDK 與 Java 安裝，重新啟動電腦，你可以在代理程式集區功能內，確定有讀取到 JAVA 與 AndroidSDK 環境變數




Azure DevOps 設定 Pipeline (continuous integration)

1. 開啟 Azure DevOps > 組建與版本 > 點選右上角 +新增 按鈕



2. 選擇 Android 範本


3. 選擇 android 存放庫與分支 (我們使用最基本的 Hello World 專案進行測試) > 點選右上角儲存與排入佇列




4. 選擇正確的代理程式佇列，點選排入佇列



5. 等待執行完成