簡(jiǎn)介資源為面向 Linux 開(kāi)發(fā)者的 Android 命令行工具壓縮包適合不希望安裝完整 Android Studio、希望通過(guò)腳本化方式管理 SDK 組件的中高級(jí)開(kāi)發(fā)者。壓縮包內(nèi)含 108 個(gè)文件主要類型包括 95 個(gè) jar 工具庫(kù)如 r8、d8、lint、apkanalyzer 等、sdkmanager、avdmanager、screenshot2 等可執(zhí)行腳本以及配置屬性和說(shuō)明文檔。包體積 157.13MB核心是 cmdline-tools 目錄解壓并配置環(huán)境變量后即可通過(guò) sdkmanager 下載、更新 NDK、模擬器及其他平臺(tái)組件。資源已有 284 人學(xué)習(xí)。通過(guò)該工具包開(kāi)發(fā)者能獲得輕量級(jí)的 SDK 管理入口在自動(dòng)化構(gòu)建和持續(xù)集成流程中快速管理 Android 開(kāi)發(fā)組件是 Linux 環(huán)境下提升開(kāi)發(fā)可控性與效率的實(shí)用選擇。1. 一個(gè) zip 裝出整套 Android 構(gòu)建環(huán)境commandlinetools 到底管什么我剛拿到一臺(tái)干凈的 Ubuntu 服務(wù)器時(shí)第一件事不是裝 Android Studio而是下載這個(gè) Android 命令行工具包c(diǎn)ommandlinetools-linux-13114758-latest.zip。它不占幾個(gè) G解壓后是一組 shell 腳本和 jar 包卻能干完“拉 SDK、裝 build-tools、建模擬器、分析 APK”這一整套臟活。很多人在 Android Studio 里點(diǎn)半天鼠標(biāo)才能完成的事在這套工具里就是幾條命令的事。這個(gè)包管的是 Android SDK 的入口層sdkmanager 負(fù)責(zé)下載和管理各個(gè) SDK 組件avdmanager 負(fù)責(zé)創(chuàng)建虛擬設(shè)備apkanalyzer 負(fù)責(zé)拆 APK。它解決的核心問(wèn)題是“沒(méi)有圖形界面、不裝全家桶照樣能把 Android 工程跑起來(lái)”。尤其適合三類人靠 CI 出包的運(yùn)維和腳本黨、在遠(yuǎn)程 Linux 上調(diào)試的開(kāi)發(fā)者以及被 Android Studio 下載慢折磨到想換方案的人。需要先說(shuō)明白這不是一個(gè)“能編譯 APK 的編譯器”本身不帶 platform 和 build-tools它是個(gè)工具入口。你拿到這個(gè) zip 只是開(kāi)始后面要通過(guò)它把真正的 SDK 組件一個(gè)個(gè)裝進(jìn)來(lái)。整條鏈路跑通之后你會(huì)發(fā)現(xiàn)自己對(duì) Android 工程的理解比天天點(diǎn) IDE 的人清楚得多因?yàn)槊恳徊蕉紨[在你面前。2. 拆包看貨解壓后的目錄里藏著哪幾個(gè)命令與 latest 目錄約定2.1 先解壓開(kāi)看bin/ 下到底有哪些可執(zhí)行文件拿到 zip 的第一步永遠(yuǎn)是先解開(kāi)看一眼別急著配環(huán)境變量。我一般會(huì)解壓到一個(gè)臨時(shí)目錄然后再?zèng)Q定怎么擺放。用 unzip 直接解壓再用 find 把前幾層文件列出來(lái)。mkdir -p ~/android-sdk unzip -q commandlinetools-linux-13114758-latest.zip -d ~/android-sdk find ~/android-sdk -maxdepth 3 -type f | sort這里的-q是安靜模式解壓過(guò)程不刷屏-d指定解壓目標(biāo)目錄。解壓后你會(huì)看到頂層是一個(gè)cmdline-tools文件夾里面才是真正的內(nèi)容。find列出文件后重點(diǎn)關(guān)注cmdline-tools/bin/下的幾個(gè)可執(zhí)行腳本sdkmanager、avdmanager、apkanalyzer、lint、retrace外加一些 .bat 批處理那是給 Windows 用的和 .jar 包。這個(gè) bin 目錄才是整套工具的精華所在。sdkmanager 是 SDK 組件管理器下載和卸載都靠它avdmanager 管虛擬設(shè)備apkanalyzer 用來(lái)分析 APK 包lint 做靜態(tài)檢查。很多人到處找獨(dú)立的 aapt2、adb 下載包其實(shí)正確的姿勢(shì)是先裝好這套命令行工具再用 sdkmanager 把那些組件拉下來(lái)版本和依賴才不容易亂。2.2 latest 目錄不是裝樣子sdkmanager 的位置約定這里有個(gè)新手幾乎必踩的坑sdkmanager 對(duì)自身所在目錄有嚴(yán)格要求不是放在哪都能跑。它要求工具必須位于$ANDROID_HOME/cmdline-tools/latest/bin這樣的層級(jí)里也就是cmdline-tools下必須套一個(gè)latest子目錄。如果你直接把解壓出來(lái)的cmdline-tools原封不動(dòng)放到 SDK 根目錄運(yùn)行sdkmanager --version大概率會(huì)報(bào)錯(cuò)或者行為詭異。正確的擺放方式是這樣的cd ~/android-sdk mkdir -p cmdline-tools/latest mv cmdline-tools/bin cmdline-tools/lib cmdline-tools/NOTICE.txt cmdline-tools/source.properties cmdline-tools/latest/這里把原來(lái)cmdline-tools目錄里的內(nèi)容全部挪進(jìn)latest/子目錄最終結(jié)構(gòu)是~/android-sdk/cmdline-tools/latest/bin/sdkmanager。source.properties這個(gè)文件里寫(xiě)的Pkg.Revision就是構(gòu)建版本號(hào) 13114758你可以用它核對(duì)當(dāng)前工具版本。為什么官方要這么設(shè)計(jì)因?yàn)橐院竽闵?jí)工具時(shí)新版本解壓后可以替換latest目錄里的內(nèi)容或者并行放一個(gè)帶版本號(hào)的目錄再通過(guò)latest做軟鏈切換。常見(jiàn)的做法是保留cmdline-tools/11.0.0、cmdline-tools/12.0.0這樣的舊版本出問(wèn)題時(shí)能快速回滾而不是覆蓋到不可恢復(fù)。2.3 構(gòu)建號(hào) 13114758、latest 與 API Level 到底是什么關(guān)系每次下載這個(gè) zip文件名里都會(huì)帶一串?dāng)?shù)字這串 13114758 是構(gòu)建號(hào)build number它只代表這一版 Android 命令行工具自身的迭代版本跟 Android 系統(tǒng)的 API Level比如 34、35完全是兩套編號(hào)。同一個(gè)構(gòu)建號(hào)可以下載所有 API Level 的 platform 和 build-tools兩個(gè)維度不互相依賴。還有一個(gè)容易誤解的點(diǎn)文件名里的latest是下載頁(yè)面用來(lái)區(qū)分“當(dāng)前推薦版”的命名方式不代表這個(gè) zip 解壓后會(huì)自己更新。你裝好之后要升級(jí)工具靠的是sdkmanager --update命令而不是重新下載一遍latest.zip。我見(jiàn)過(guò)同事每次都重新下 zip 覆蓋安裝結(jié)果越覆蓋越亂。那這個(gè)包和 Android Studio 是什么關(guān)系A(chǔ)ndroid Studio 安裝時(shí)的 SDK 組件就是通過(guò)這套命令行工具拉取的只是把過(guò)程封裝到了圖形界面里。如果你已經(jīng)裝了 Android Studio它自帶的 SDK 里通常也有 cmdline-tools 目錄。但對(duì) CI、服務(wù)器、無(wú)頭環(huán)境來(lái)說(shuō)命令行工具包是更輕量的唯一合理入口。它能做到 Android Studio 能做的大部分 SDK 管理事情卻不帶幾百 MB 的 IDE 開(kāi)銷。3. 在 Linux 上從零裝好 commandlinetoolsJDK、解壓、路徑與第一個(gè)實(shí)例3.1 前置條件JDK 版本和系統(tǒng)架構(gòu)先搞清楚動(dòng)手之前先跑兩條命令否則后面報(bào)了錯(cuò)再回頭排查就慢了。grumpy 的經(jīng)驗(yàn)是這套工具對(duì) Java 版本非常敏感新構(gòu)建號(hào)基本都要求 JDK 17 起步裝個(gè) OpenJDK 17 是最省心的選擇。java -version uname -m第一條看 JDK 版本第二條看 CPU 架構(gòu)。uname -m輸出x86_64就是 64 位 x86aarch64是 ARM 64這兩個(gè)架構(gòu)官方都有對(duì)應(yīng)可用版本但 32 位系統(tǒng)直接放棄新版工具早就不支持了。如果java -version報(bào)找不到命令先裝 OpenJDKDebian/Ubuntu 上一般apt install openjdk-17-jdk-headlessCentOS/RHEL 用dnf install java-17-openjdk-devel。無(wú)頭環(huán)境裝 headless 版就夠不需要圖形模塊。有人問(wèn)能不能用 JDK 11 或 JDK 8低版本的構(gòu)建號(hào)配 JDK 8 是能跑的但 13114758 這種新包配老 JDK 會(huì)直接報(bào)UnsupportedClassVersionError現(xiàn)象就是 Java 啟動(dòng)類失敗看起來(lái)像工具壞了其實(shí)是版本不匹配。所以別折騰直接上 17。還有個(gè)容易忽略的點(diǎn)如果你機(jī)器上有多個(gè) Java 版本java命令指向的可能不是你以為的那個(gè)版本用update-alternatives --config java或者顯式把 JDK 17 的 bin 目錄放最前面。3.2 把 zip 放到哪、解壓到哪、目錄結(jié)構(gòu)怎么擺目錄規(guī)劃很關(guān)鍵因?yàn)楹竺嫠新窂蕉紩?huì)跟它掛鉤。個(gè)人開(kāi)發(fā)機(jī)我一般放~/android-sdk團(tuán)隊(duì)共用服務(wù)器放/opt/android-sdk。選好根目錄后先建目錄再解壓到臨時(shí)位置最后挪成latest結(jié)構(gòu)。這個(gè)“先解壓再挪”的順序可以避免直接解壓后目錄層級(jí)不對(duì)的問(wèn)題。export ANDROID_HOME~/android-sdk export ANDROID_SDK_ROOT$ANDROID_HOME mkdir -p $ANDROID_HOME unzip -q commandlinetools-linux-13114758-latest.zip -d /tmp/cmdtools-unzip mkdir -p $ANDROID_HOME/cmdline-tools/latest mv /tmp/cmdtools-unzip/cmdline-tools/* $ANDROID_HOME/cmdline-tools/latest/ rm -rf /tmp/cmdtools-unzip這里設(shè)置了ANDROID_HOME和ANDROID_SDK_ROOT兩個(gè)變量ANDROID_HOME是主路徑ANDROID_SDK_ROOT是為了兼容一些老工具和舊項(xiàng)目腳本兩個(gè)都設(shè)成同一個(gè)路徑最省事。解壓到/tmp再移動(dòng)是為了讓目標(biāo)目錄干凈最后刪除臨時(shí)目錄。注意mv /tmp/cmdtools-unzip/cmdline-tools/*里的通配符會(huì)把所有內(nèi)容挪進(jìn) latest 子目錄最終結(jié)構(gòu)是~/android-sdk/cmdline-tools/latest/bin。有個(gè)細(xì)節(jié)別把整個(gè)cmdline-tools目錄直接移進(jìn)去那會(huì)變成cmdline-tools/latest/cmdline-tools/bin多套一層導(dǎo)致腳本找不到自身位置。3.3 環(huán)境變量與 PATHsdkmanager 如何被找到目錄擺好之后要讓系統(tǒng)能找到這些命令。把下面幾行寫(xiě)進(jìn)~/.bashrc或~/.zshrcPATH 里要同時(shí)包含 cmdline-tools 的 bin 和 platform-tools后者是裝完 adb 之后才有用的但可以先把路徑寫(xiě)好。platform-tools 還沒(méi)裝的時(shí)候這個(gè)路徑存在但不生效不影響什么。export ANDROID_HOME$HOME/android-sdk export ANDROID_SDK_ROOT$ANDROID_HOME export PATH$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools:$PATH寫(xiě)完之后source ~/.bashrc讓變量立即生效。然后驗(yàn)證最核心的東西sdkmanager --version如果輸出一個(gè)版本號(hào)說(shuō)明工具本身已經(jīng)能跑環(huán)境變量也認(rèn)到了。如果提示command not found先echo $ANDROID_HOME看變量是否空再看ls $ANDROID_HOME/cmdline-tools/latest/bin里有沒(méi)有 sdkmanager。我見(jiàn)過(guò)很多次翻車(chē)是路徑里多個(gè)斜杠或者拼錯(cuò)大小寫(xiě)因?yàn)?Linux 路徑區(qū)分大小寫(xiě)Android 目錄名全是小寫(xiě)。一個(gè)需要留意的點(diǎn)如果之前裝過(guò)舊版 Android 工具鏈PATH 里可能已經(jīng)有一個(gè)cmdline-tools/bin路徑指向舊版本。新舊同時(shí)存在時(shí)which sdkmanager出來(lái)的那個(gè)才真正生效建議把老的路徑從 PATH 里去掉避免兩個(gè)版本互相干擾。3.4 第一個(gè)實(shí)例接受許可并安裝 platform-tools工具能跑之后第一件事是接受所有 SDK 組件的許可協(xié)議然后安裝最小可用集合。第一次跑 sdkmanager 的時(shí)候它會(huì)往$ANDROID_HOME/licenses目錄寫(xiě)授權(quán)文件這個(gè)步驟不做后面安裝任何組件都會(huì)卡在確認(rèn)環(huán)節(jié)。用yes |管道可以直接把所有協(xié)議一并接受省去手動(dòng)輸入 y 的麻煩。yes | sdkmanager --licenses sdkmanager --install platform-tools platforms;android-34 build-tools;34.0.0第一條命令把當(dāng)前 SDK 已知的所有 license 接受并落盤(pán)。第二條安裝三樣?xùn)|西platform-tools是 adb、fastboot 等調(diào)試工具的集合platforms;android-34是 Android 14 的平臺(tái)文件里面有 android.jar編譯時(shí)要用build-tools;34.0.0是構(gòu)建工具包括 aapt2、zipalign、apksigner。組件名里的分號(hào)是包名的一部分不能省略也不能替換成別的符號(hào)。安裝完成后驗(yàn)證一下 adb 是否可用adb version如果輸出 Android Debug Bridge version 相關(guān)信息說(shuō)明整個(gè)鏈路已經(jīng)通了。第一次跑 sdkmanager 時(shí)終端會(huì)輸出下載進(jìn)度網(wǎng)絡(luò)不好時(shí)進(jìn)度條可能停很久不要急著 CtrlC可以先看是不是卡在 license 確認(rèn)上。這一步跑通之后后面裝什么組件都只是換個(gè)包名的事。4. 不打開(kāi) Android Studio 的日常sdkmanager、avdmanager 與 apkanalyzer 實(shí)戰(zhàn)4.1 sdkmanager 的完整用法列出、安裝、精確匹配sdkmanager 是整套工具里使用頻率最高的命令它的核心操作就三類列出、安裝、卸載。剛裝好工具時(shí)你可能想知道現(xiàn)在哪個(gè) API Level 的 platform 是可用的或者自己裝了什么。兩條 list 命令的差別要分清--list列出服務(wù)器上所有可安裝的組件--list_installed只列本機(jī)已裝的。sdkmanager --list sdkmanager --list_installed sdkmanager --install platform-tools platforms;android-34 sdkmanager --uninstall build-tools;34.0.0--list的輸出會(huì)很長(zhǎng)建議用sdkmanager --list | grep platforms;android過(guò)濾只看 platforms。包名必須精確匹配比如platforms;android-34和platforms;android-33是兩個(gè)不同包不存在模糊匹配。--uninstall同樣要寫(xiě)完整包名卸載不會(huì)刪依賴需要你手動(dòng)評(píng)估哪些相關(guān)的包可以一起卸。還有幾個(gè)實(shí)用參數(shù)值得記一下--channel3可以列出金絲雀版本適合想提前體驗(yàn)新 API 的開(kāi)發(fā)者但別用在構(gòu)建機(jī)上--verbose輸出詳細(xì)日志排查網(wǎng)絡(luò)問(wèn)題時(shí)有幫助--sdk_root$ANDROID_HOME顯式指定根目錄適用于沒(méi)設(shè)置環(huán)境變量的場(chǎng)景。注意新版 sdkmanager 用--install參數(shù)安裝舊版習(xí)慣是直接寫(xiě)包名sdkmanager platforms;android-34新版也兼容這種寫(xiě)法但推薦用帶參數(shù)的格式。如果你發(fā)現(xiàn)裝的 platform 版本和項(xiàng)目要求的對(duì)不上先用sdkmanager --list_installed確認(rèn)現(xiàn)狀再用--install補(bǔ)裝對(duì)應(yīng)版本。Gradle 構(gòu)建時(shí)經(jīng)常報(bào)錯(cuò)說(shuō)缺少某個(gè) build-tools 版本就是因?yàn)?sdkmanager 裝的版本和build.gradle里buildToolsVersion指定的不一致命令行這邊裝一下就好了。4.2 avdmanager不啟動(dòng) IDE 建模擬器avdmanager 負(fù)責(zé)虛擬設(shè)備AVD的創(chuàng)建和銷毀。命令行建模擬器最大的價(jià)值在于 CI 場(chǎng)景無(wú)頭跑 UI 測(cè)試時(shí)需要一臺(tái)啟動(dòng)的模擬器而不可能讓 Jenkins 去打開(kāi) Android Studio 點(diǎn)創(chuàng)建。用 avdmanager 建 AVD 之前需要先裝 system-image 和 emulator 兩個(gè)組件否則之后創(chuàng)建會(huì)失敗。sdkmanager --install system-images;android-34;google_apis;x86_64 emulator avdmanager create avd -n ci_test -k system-images;android-34;google_apis;x86_64 -d pixel_5 avdmanager list avd第一行安裝模擬器程序和系統(tǒng)鏡像。system-image 的包名三個(gè)分號(hào)分段system-images;android-34是 API 版本google_apis表示帶谷歌 APIx86_64是鏡像架構(gòu)如果你的機(jī)器是 ARM 就選arm64-v8a。第二行創(chuàng)建 AVD-n是設(shè)備名-k是鏡像包名-d是設(shè)備配置文件。第一次創(chuàng)建時(shí)終端會(huì)問(wèn)是否創(chuàng)建自定義硬件配置直接輸入no回車(chē)用默認(rèn)配置就行。啟動(dòng)模擬器的命令在 emulator 目錄下面不建 AVD 也能執(zhí)行但沒(méi)有設(shè)備可啟動(dòng)。無(wú)頭模式跑測(cè)試時(shí)一般這樣啟動(dòng)$ANDROID_HOME/emulator/emulator -avd ci_test -no-window -no-audio -gpu swiftshader_indirect-no-window是不顯示模擬器窗口-no-audio關(guān)掉音頻-gpu swiftshader_indirect用軟件渲染這三個(gè)參數(shù)組合是 CI 上跑模擬器的標(biāo)準(zhǔn)配置。啟動(dòng)后可以用adb wait-for-device等待設(shè)備就緒再跑測(cè)試。注意模擬器啟動(dòng)需要幾秒到幾十秒CI 腳本里要留足等待時(shí)間。4.3 apkanalyzer 與 lintAPK 的體檢和靜態(tài)檢查拿到一個(gè) APK 之后想快速了解它是什么包名、targetSdk 多少、用了哪些權(quán)限不需要反編譯工具apkanalyzer 就夠了。它在命令行工具包里自帶直接對(duì) APK 文件執(zhí)行。這個(gè)命令在排查問(wèn)題時(shí)特別有用比如客戶反饋的包版本不對(duì)用一條命令就能確認(rèn)這個(gè) APK 到底是不是最新的。apkanalyzer manifest print app-debug.apk apkanalyzer apk summary app-debug.apk apkanalyzer dex packages app-debug.apk第一條打印 APK 的 AndroidManifest.xml 內(nèi)容能看到包名、版本號(hào)、權(quán)限聲明、四大組件等第二條輸出 APK 的基本信息摘要包含最低 Android 版本、目標(biāo) SDK 版本第三條列出 dex 文件里的包結(jié)構(gòu)和類數(shù)量可以用來(lái)快速判斷一個(gè) APK 是否打過(guò)混淆、是否包含某個(gè)類。這些命令不需要啟動(dòng)任何服務(wù)執(zhí)行速度和文件大小有關(guān)一般一秒內(nèi)出結(jié)果。lint 靜態(tài)檢查在命令行工具里也有對(duì)應(yīng)入口但對(duì)單個(gè) APK 文件檢查比較少見(jiàn)更多是對(duì)工程源碼跑。常見(jiàn)做法是直接執(zhí)行./gradlew lint生成的報(bào)告在app/build/reports/lint-results-debug.html。命令行工具包里的 lint 腳本主要用于脫離 Gradle 的場(chǎng)景比如在 CI 里對(duì)一份 pull 下來(lái)的代碼單獨(dú)檢查。靜態(tài)檢查的坑在于默認(rèn)規(guī)則集有時(shí)候過(guò)嚴(yán)很多團(tuán)隊(duì)會(huì)在lint.xml里把不必要的規(guī)則關(guān)掉不然構(gòu)建分會(huì)掛在一些無(wú)傷大雅的告警上。4.4 把這套工具接進(jìn) CI無(wú) UI 場(chǎng)景的最小配方命令行工具在 CI 里的定位是“基礎(chǔ)鏡像的一部分”而不是每次構(gòu)建時(shí)現(xiàn)下載。GitHub Actions 和 Jenkins 常見(jiàn)做法是把下載、解壓、裝 SDK 組件的過(guò)程固化成腳本緩存 SDK 目錄讓每次構(gòu)建復(fù)用。第一次構(gòu)建先把環(huán)境鋪好后續(xù)構(gòu)建直接走緩存省掉最耗時(shí)的下載環(huán)節(jié)。set -e curl -fsSL -o /tmp/cmdtools.zip https://dl.google.com/android/repository/commandlinetools-linux-13114758_latest.zip unzip -q /tmp/cmdtools.zip -d $ANDROID_HOME yes | sdkmanager --licenses sdkmanager --install platform-tools platforms;android-34 build-tools;34.0.0 sdkmanager --list_installed | tee /opt/android-sdk/packages.txt這里的set -e讓腳本在任一步失敗時(shí)立即退出避免在殘缺環(huán)境下繼續(xù)構(gòu)建。注意下載鏈接里的版本號(hào)用下劃線連接和文件名commandlinetools-linux-13114758-latest.zip里的連字符不同拼錯(cuò)會(huì) 404。CI 腳本里我一般會(huì)把版本號(hào)單獨(dú)定義成一個(gè)變量比如CMDTOOLS_VERSION13114758方便以后升級(jí)時(shí)只改一行。最重要的一個(gè)經(jīng)驗(yàn)不要把 CI 腳本寫(xiě)成每次都拉最新包。文件名里的latest會(huì)害人今天最新的版本過(guò)兩個(gè)月就變了鎖版本號(hào)才能保證構(gòu)建可復(fù)現(xiàn)。團(tuán)隊(duì)內(nèi)部如果網(wǎng)絡(luò)到 Google 倉(cāng)庫(kù)不穩(wěn)定常見(jiàn)做法是把 zip 和常用 SDK 組件打包放到內(nèi)網(wǎng)對(duì)象存儲(chǔ)或者 Nexus 上CI 從內(nèi)網(wǎng)拉取。這種方案同時(shí)解決了下載速度和版本固定兩個(gè)問(wèn)題。5. 命令行工具常見(jiàn)坑與排錯(cuò)從 java 報(bào)錯(cuò)到 SDK 裝完用不了的 5 個(gè)現(xiàn)場(chǎng)5.1 sdkmanager 一執(zhí)行就報(bào) Java 異?，F(xiàn)象執(zhí)行sdkmanager --version時(shí)直接拋Error: Could not find or load main class com.android.sdklib.tool.sdkmanager.SdkManagerCli看起來(lái)像是工具包不完整。原因絕大多數(shù)情況是 JDK 版本不對(duì)。新版 commandlinetools 的 jar 包編譯目標(biāo)版本較高用 JDK 8 跑會(huì)因版本過(guò)低無(wú)法加載類。其次是目錄結(jié)構(gòu)錯(cuò)誤sdkmanager 腳本通過(guò)自身路徑定位 lib 下的 jar 包如果cmdline-tools/latest層級(jí)不對(duì)腳本就找不到主類。解決先java -version確認(rèn)版本低于 17 就先升級(jí)。再確認(rèn)目錄結(jié)構(gòu)ls $ANDROID_HOME/cmdline-tools/latest/lib能看到一堆 .jar 文件source.properties在上一級(jí)。如果目錄層級(jí)多了或少了重新按 3.2 節(jié)的方式整理。有個(gè)命令行能直接定位問(wèn)題which sdkmanager看它是否指向了你以為的路徑以此排除 PATH 里多個(gè)版本沖突。5.2 下載組件卡在 Fetching 或提示 Cannot download現(xiàn)象sdkmanager --install執(zhí)行后終端長(zhǎng)時(shí)間停在Fetching階段進(jìn)度條不動(dòng)或報(bào)Cannot download后中斷。重試多次仍失敗偶爾成功但下次又不行。原因sdkmanager 默認(rèn)從 Google 倉(cāng)庫(kù)下載組件網(wǎng)絡(luò)鏈路慢或超時(shí)會(huì)被視為失敗。另一個(gè)隱藏原因是 license 未接受時(shí)部分版本會(huì)一直掛在確認(rèn)狀態(tài)不報(bào)錯(cuò)看起來(lái)像卡死。重試時(shí)重復(fù)的臨時(shí)文件有可能殘留影響下一步操作。解決先把 license 處理掉yes | sdkmanager --licenses。然后用--verbose重跑一次安裝看日志停留在哪個(gè) URL判斷是哪個(gè)組件拉取失敗。對(duì)依賴公網(wǎng)下載的環(huán)境常見(jiàn)做法是配置國(guó)內(nèi)鏡像源通過(guò)修改$ANDROID_HOME/cmdline-tools/latest/lib/sdkmanager.cfg指定倉(cāng)庫(kù)地址sdkman.repohttps://mirrors.example.com/android/repository這里mirrors.example.com是假設(shè)的內(nèi)網(wǎng)鏡像域名實(shí)際部署時(shí)換成自己團(tuán)隊(duì)維護(hù)的鏡像地址。改完后用sdkmanager --list驗(yàn)證鏡像是否可用能看到組件列表就說(shuō)明倉(cāng)庫(kù)生效。每次安裝前也可以--verbose看實(shí)際請(qǐng)求路徑確認(rèn)走的是鏡像而不是默認(rèn)倉(cāng)庫(kù)。刪掉$ANDROID_HOME下帶 .tmp 后綴的殘留臨時(shí)文件再重試能解決一部分“裝了半截”的怪問(wèn)題。5.3 裝完 build-tools 卻找不到 aapt2現(xiàn)象Gradle 構(gòu)建時(shí)報(bào)Failed to find Build Tools revision 34.0.0或 Android Studio 提示 SDK Build Tools 缺失。但運(yùn)行sdkmanager --list_installed明明顯示build-tools;34.0.0已經(jīng)安裝了。原因第一種可能是 Gradle 請(qǐng)求的 build-tools 版本和你安裝的版本不完全一致比如項(xiàng)目要34.0.0而你裝的是34.0.0-rc1這在只裝了 preview 版本時(shí)經(jīng)常發(fā)生。第二種是ANDROID_HOME環(huán)境變量指向的 SDK 路徑和項(xiàng)目實(shí)際使用的 SDK 路徑不同Gradle 沒(méi)認(rèn)到sdkmanager裝的那個(gè) SDK。第三種是構(gòu)建工具安裝時(shí)目錄寫(xiě)入權(quán)限有問(wèn)題文件沒(méi)寫(xiě)全。解決先確認(rèn)本機(jī)到底裝了哪個(gè)版本直接看目錄ls $ANDROID_HOME/build-tools/ ls $ANDROID_HOME/build-tools/34.0.0/aapt2如果目錄里沒(méi)有對(duì)應(yīng)版本用sdkmanager --install build-tools;34.0.0補(bǔ)裝。如果版本存在但 Gradle 報(bào)缺失檢查項(xiàng)目根目錄local.properties里的sdk.dir是否指向ANDROID_HOME用絕對(duì)路徑寫(xiě)死是最可靠的方案。另外可以用aapt2 version驗(yàn)證二進(jìn)制能否執(zhí)行如果提示權(quán)限不足chmod x加可執(zhí)行權(quán)限。5.4 Android Studio 與命令行工具互不認(rèn)SDK 路徑不一致現(xiàn)象命令行里 adb、sdkmanager 都能跑但 Android Studio 打開(kāi)項(xiàng)目報(bào)SDK location not found。兩個(gè)環(huán)境各認(rèn)各的路徑互不相通。原因Android Studio 通過(guò)local.properties或自身的 SDK Location 設(shè)置來(lái)確定 SDK 路徑不會(huì)自動(dòng)讀取 shell 的環(huán)境變量。命令行工具通過(guò)ANDROID_HOME定位兩邊獨(dú)立管理。如果你先在命令行裝了 SDK 在~/android-sdk而 Android Studio 默認(rèn)找~/Library/Android/sdkmacOS或其他路徑自然找不到。解決以命令行安裝的目錄為準(zhǔn)在項(xiàng)目根目錄創(chuàng)建或修改local.propertiessdk.dir/home/yourname/android-sdk把路徑換成自己的絕對(duì)路徑。如果是新建工程也可以直接在 Android Studio 的 Project Structure 里把 SDK 路徑指定到同一目錄。一個(gè)反面典型是兩邊各自裝了獨(dú)立 SDK占了兩份磁盤(pán)空間還經(jīng)常因?yàn)榘姹静煌霈F(xiàn)怪問(wèn)題。經(jīng)驗(yàn)是開(kāi)發(fā)機(jī)上只維護(hù)一份 SDK命令行和 IDE 都用它。5.5 手滑刪錯(cuò)目錄或權(quán)限被 root 占用現(xiàn)象sdkmanager 安裝組件時(shí)寫(xiě)到一半報(bào) Permission denied或者整個(gè) SDK 目錄被人誤刪所有環(huán)境變量都失效。原因最常見(jiàn)的兩種一是有同事為了方便用sudo sdkmanager安裝組件導(dǎo)致 SDK 下所有目錄的 owner 變成 root普通用戶之后想裝任何東西都沒(méi)有寫(xiě)權(quán)限越補(bǔ)越亂二是有人rm -rf $ANDROID_HOME時(shí)少打了一個(gè)字母把整個(gè) SDK 連同 cmdline-tools 一起刪了。解決權(quán)限錯(cuò)亂的情況一個(gè)命令就能治好sudo chown -R $USER:$USER $ANDROID_HOME把所有文件歸回當(dāng)前用戶之后不要再碰 sudo。誤刪目錄沒(méi)有后悔藥只能按第 3 章的流程重新下載 zip、解壓、重裝 SDK 組件。但有個(gè)能減少損失的習(xí)慣把sdkmanager --list_installed的輸出保存下來(lái)重裝的時(shí)候照著列表一條條裝回去。這個(gè)文件我一般放在 SDK 根目錄外面避免隨 SDK 一起被誤刪。刪除操作前先echo $ANDROID_HOME確認(rèn)路徑是否為空這能攔下大部分手滑。6. 驗(yàn)證安裝與進(jìn)階配置一條命令確認(rèn) SDK 狀態(tài)與三個(gè)高頻技巧6.1 快速健康檢查一條命令連串驗(yàn)證平時(shí)我檢查一臺(tái)機(jī)器的 Android 環(huán)境是否健康會(huì)直接把三個(gè)命令連起來(lái)跑先看工具版本再看已裝組件清單最后看 adb。三步都通過(guò)這個(gè)環(huán)境基本就能直接開(kāi)干。sdkmanager --version sdkmanager --list_installed adb version保證前一條成功才執(zhí)行下一條任一步失敗就能定位問(wèn)題在哪個(gè)環(huán)節(jié)。sdkmanager 版本號(hào)報(bào)錯(cuò)多半是 JDK 或目錄問(wèn)題list 結(jié)果缺失組件說(shuō)明安裝不完整adb 報(bào) command not found 則檢查 PATH 里是否包含 platform-tools。這套檢查同樣適合寫(xiě)成一個(gè)check_android_env.sh腳本新入職同事拉下來(lái)跑一遍就能確認(rèn)環(huán)境就緒。6.2 三個(gè)用過(guò)就回不去的小配置第一個(gè)是別名。命令行操作里sdkmanager --list輸出太長(zhǎng)我會(huì)在.bashrc里加alias sdklistsdkmanager --list加alias sdksdkmanager --install少打一串是一串。第二個(gè)是對(duì) AVD 設(shè)備名的約定團(tuán)隊(duì)里建模擬器統(tǒng)一用“項(xiàng)目名_用途_架構(gòu)”格式比如ci_test_x86_64避免 AVD 一多根本分不清誰(shuí)是誰(shuí)。第三個(gè)是環(huán)境變量在 CI 里的留檔習(xí)慣把每個(gè)版本號(hào)寫(xiě)進(jìn)一個(gè) environment 文件讓整個(gè)構(gòu)建鏈路用的同一個(gè) SDK。我自己踩得最狠的一次是第 5 章的 5.1新工具配了舊 JDK報(bào)錯(cuò)報(bào)得莫名其妙查了半天才發(fā)現(xiàn)是版本不匹配?，F(xiàn)在拿到任何新版本的 commandlinetools我會(huì)先java -version再?zèng)Q定要不要繼續(xù)裝。這套工具的坑不算少但摸清楚規(guī)律之后它確實(shí)是 Linux 上搓 Android 構(gòu)建環(huán)境最直接的路。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取