簡(jiǎn)介資源為面向 Linux 開發(fā)者的 Android 命令行工具壓縮包適合不希望安裝完整 Android Studio、希望通過腳本化方式管理 SDK 組件的中高級(jí)開發(fā)者。壓縮包內(nèi)含 108 個(gè)文件主要類型包括 95 個(gè) jar 工具庫(kù)如 r8、d8、lint、apkanalyzer 等、sdkmanager、avdmanager、screenshot2 等可執(zhí)行腳本以及配置屬性和說明文檔。包體積 157.13MB核心是 cmdline-tools 目錄解壓并配置環(huán)境變量后即可通過 sdkmanager 下載、更新 NDK、模擬器及其他平臺(tái)組件。資源已有 284 人學(xué)習(xí)。通過該工具包開發(fā)者能獲得輕量級(jí)的 SDK 管理入口在自動(dòng)化構(gòu)建和持續(xù)集成流程中快速管理 Android 開發(fā)組件是 Linux 環(huán)境下提升開發(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。它解決的核心問題是“沒有圖形界面、不裝全家桶照樣能把 Android 工程跑起來”。尤其適合三類人靠 CI 出包的運(yùn)維和腳本黨、在遠(yuǎn)程 Linux 上調(diào)試的開發(fā)者以及被 Android Studio 下載慢折磨到想換方案的人。需要先說明白這不是一個(gè)“能編譯 APK 的編譯器”本身不帶 platform 和 build-tools它是個(gè)工具入口。你拿到這個(gè) zip 只是開始后面要通過它把真正的 SDK 組件一個(gè)個(gè)裝進(jìn)來。整條鏈路跑通之后你會(huì)發(fā)現(xiàn)自己對(duì) Android 工程的理解比天天點(diǎn) IDE 的人清楚得多因?yàn)槊恳徊蕉紨[在你面前。2. 拆包看貨解壓后的目錄里藏著哪幾個(gè)命令與 latest 目錄約定2.1 先解壓開看bin/ 下到底有哪些可執(zhí)行文件拿到 zip 的第一步永遠(yuǎn)是先解開看一眼別急著配環(huán)境變量。我一般會(huì)解壓到一個(gè)臨時(shí)目錄然后再?zèng)Q定怎么擺放。用 unzip 直接解壓再用 find 把前幾層文件列出來。mkdir -p ~/android-sdk unzip -q commandlinetools-linux-13114758-latest.zip -d ~/android-sdk find ~/android-sdk -maxdepth 3 -type f | sort這里的-q是安靜模式解壓過程不刷屏-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 用來分析 APK 包lint 做靜態(tài)檢查。很多人到處找獨(dú)立的 aapt2、adb 下載包其實(shí)正確的姿勢(shì)是先裝好這套命令行工具再用 sdkmanager 把那些組件拉下來版本和依賴才不容易亂。2.2 latest 目錄不是裝樣子sdkmanager 的位置約定這里有個(gè)新手幾乎必踩的坑sdkmanager 對(duì)自身所在目錄有嚴(yán)格要求不是放在哪都能跑。它要求工具必須位于$ANDROID_HOME/cmdline-tools/latest/bin這樣的層級(jí)里也就是cmdline-tools下必須套一個(gè)latest子目錄。如果你直接把解壓出來的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/這里把原來cmdline-tools目錄里的內(nèi)容全部挪進(jìn)latest/子目錄最終結(jié)構(gòu)是~/android-sdk/cmdline-tools/latest/bin/sdkmanager。source.properties這個(gè)文件里寫的Pkg.Revision就是構(gòu)建版本號(hào) 13114758你可以用它核對(duì)當(dāng)前工具版本。為什么官方要這么設(shè)計(jì)因?yàn)橐院竽闵?jí)工具時(shí)新版本解壓后可以替換latest目錄里的內(nèi)容或者并行放一個(gè)帶版本號(hào)的目錄再通過latest做軟鏈切換。常見的做法是保留cmdline-tools/11.0.0、cmdline-tools/12.0.0這樣的舊版本出問題時(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è)面用來區(qū)分“當(dāng)前推薦版”的命名方式不代表這個(gè) zip 解壓后會(huì)自己更新。你裝好之后要升級(jí)工具靠的是sdkmanager --update命令而不是重新下載一遍latest.zip。我見過同事每次都重新下 zip 覆蓋安裝結(jié)果越覆蓋越亂。那這個(gè)包和 Android Studio 是什么關(guān)系A(chǔ)ndroid Studio 安裝時(shí)的 SDK 組件就是通過這套命令行工具拉取的只是把過程封裝到了圖形界面里。如果你已經(jīng)裝了 Android Studio它自帶的 SDK 里通常也有 cmdline-tools 目錄。但對(duì) CI、服務(wù)器、無頭環(huán)境來說命令行工具包是更輕量的唯一合理入口。它能做到 Android Studio 能做的大部分 SDK 管理事情卻不帶幾百 MB 的 IDE 開銷。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。無頭環(huán)境裝 headless 版就夠不需要圖形模塊。有人問能不能用 JDK 11 或 JDK 8低版本的構(gòu)建號(hào)配 JDK 8 是能跑的但 13114758 這種新包配老 JDK 會(huì)直接報(bào)UnsupportedClassVersionError現(xiàn)象就是 Java 啟動(dòng)類失敗看起來像工具壞了其實(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è)人開發(fā)機(jī)我一般放~/android-sdk團(tuán)隊(duì)共用服務(wù)器放/opt/android-sdk。選好根目錄后先建目錄再解壓到臨時(shí)位置最后挪成latest結(jié)構(gòu)。這個(gè)“先解壓再挪”的順序可以避免直接解壓后目錄層級(jí)不對(duì)的問題。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)能找到這些命令。把下面幾行寫進(jìn)~/.bashrc或~/.zshrcPATH 里要同時(shí)包含 cmdline-tools 的 bin 和 platform-tools后者是裝完 adb 之后才有用的但可以先把路徑寫好。platform-tools 還沒裝的時(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寫完之后source ~/.bashrc讓變量立即生效。然后驗(yàn)證最核心的東西sdkmanager --version如果輸出一個(gè)版本號(hào)說明工具本身已經(jīng)能跑環(huán)境變量也認(rèn)到了。如果提示command not found先echo $ANDROID_HOME看變量是否空再看ls $ANDROID_HOME/cmdline-tools/latest/bin里有沒有 sdkmanager。我見過很多次翻車是路徑里多個(gè)斜杠或者拼錯(cuò)大小寫因?yàn)?Linux 路徑區(qū)分大小寫Android 目錄名全是小寫。一個(gè)需要留意的點(diǎn)如果之前裝過舊版 Android 工具鏈PATH 里可能已經(jīng)有一個(gè)cmdline-tools/bin路徑指向舊版本。新舊同時(shí)存在時(shí)which sdkmanager出來的那個(gè)才真正生效建議把老的路徑從 PATH 里去掉避免兩個(gè)版本互相干擾。3.4 第一個(gè)實(shí)例接受許可并安裝 platform-tools工具能跑之后第一件事是接受所有 SDK 組件的許可協(xié)議然后安裝最小可用集合。第一次跑 sdkmanager 的時(shí)候它會(huì)往$ANDROID_HOME/licenses目錄寫授權(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 接受并落盤。第二條安裝三樣?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)信息說明整個(gè)鏈路已經(jīng)通了。第一次跑 sdkmanager 時(shí)終端會(huì)輸出下載進(jìn)度網(wǎng)絡(luò)不好時(shí)進(jìn)度條可能停很久不要急著 CtrlC可以先看是不是卡在 license 確認(rèn)上。這一步跑通之后后面裝什么組件都只是換個(gè)包名的事。4. 不打開 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過濾只看 platforms。包名必須精確匹配比如platforms;android-34和platforms;android-33是兩個(gè)不同包不存在模糊匹配。--uninstall同樣要寫完整包名卸載不會(huì)刪依賴需要你手動(dòng)評(píng)估哪些相關(guān)的包可以一起卸。還有幾個(gè)實(shí)用參數(shù)值得記一下--channel3可以列出金絲雀版本適合想提前體驗(yàn)新 API 的開發(fā)者但別用在構(gòu)建機(jī)上--verbose輸出詳細(xì)日志排查網(wǎng)絡(luò)問題時(shí)有幫助--sdk_root$ANDROID_HOME顯式指定根目錄適用于沒設(shè)置環(huán)境變量的場(chǎng)景。注意新版 sdkmanager 用--install參數(shù)安裝舊版習(xí)慣是直接寫包名sdkmanager platforms;android-34新版也兼容這種寫法但推薦用帶參數(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ò)說缺少某個(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)景無頭跑 UI 測(cè)試時(shí)需要一臺(tái)啟動(dòng)的模擬器而不可能讓 Jenkins 去打開 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ì)問是否創(chuàng)建自定義硬件配置直接輸入no回車用默認(rèn)配置就行。啟動(dòng)模擬器的命令在 emulator 目錄下面不建 AVD 也能執(zhí)行但沒有設(shè)備可啟動(dòng)。無頭模式跑測(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è)命令在排查問題時(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ù)量可以用來快速判斷一個(gè) APK 是否打過混淆、是否包含某個(gè)類。這些命令不需要啟動(dòng)任何服務(wù)執(zhí)行速度和文件大小有關(guān)一般一秒內(nèi)出結(jié)果。lint 靜態(tài)檢查在命令行工具里也有對(duì)應(yīng)入口但對(duì)單個(gè) APK 文件檢查比較少見更多是對(duì)工程源碼跑。常見做法是直接執(zhí)行./gradlew lint生成的報(bào)告在app/build/reports/lint-results-debug.html。命令行工具包里的 lint 腳本主要用于脫離 Gradle 的場(chǎng)景比如在 CI 里對(duì)一份 pull 下來的代碼單獨(dú)檢查。靜態(tài)檢查的坑在于默認(rèn)規(guī)則集有時(shí)候過嚴(yán)很多團(tuán)隊(duì)會(huì)在lint.xml里把不必要的規(guī)則關(guān)掉不然構(gòu)建分會(huì)掛在一些無傷大雅的告警上。4.4 把這套工具接進(jìn) CI無 UI 場(chǎng)景的最小配方命令行工具在 CI 里的定位是“基礎(chǔ)鏡像的一部分”而不是每次構(gòu)建時(shí)現(xiàn)下載。GitHub Actions 和 Jenkins 常見做法是把下載、解壓、裝 SDK 組件的過程固化成腳本緩存 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 腳本寫成每次都拉最新包。文件名里的latest會(huì)害人今天最新的版本過兩個(gè)月就變了鎖版本號(hào)才能保證構(gòu)建可復(fù)現(xiàn)。團(tuán)隊(duì)內(nèi)部如果網(wǎng)絡(luò)到 Google 倉(cāng)庫(kù)不穩(wěn)定常見做法是把 zip 和常用 SDK 組件打包放到內(nèi)網(wǎng)對(duì)象存儲(chǔ)或者 Nexus 上CI 從內(nèi)網(wǎng)拉取。這種方案同時(shí)解決了下載速度和版本固定兩個(gè)問題。5. 命令行工具常見坑與排錯(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看起來像是工具包不完整。原因絕大多數(shù)情況是 JDK 版本不對(duì)。新版 commandlinetools 的 jar 包編譯目標(biāo)版本較高用 JDK 8 跑會(huì)因版本過低無法加載類。其次是目錄結(jié)構(gòu)錯(cuò)誤sdkmanager 腳本通過自身路徑定位 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è)命令行能直接定位問題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ò)看起來像卡死。重試時(shí)重復(fù)的臨時(shí)文件有可能殘留影響下一步操作。解決先把 license 處理掉yes | sdkmanager --licenses。然后用--verbose重跑一次安裝看日志停留在哪個(gè) URL判斷是哪個(gè)組件拉取失敗。對(duì)依賴公網(wǎng)下載的環(huán)境常見做法是配置國(guó)內(nèi)鏡像源通過修改$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)證鏡像是否可用能看到組件列表就說明倉(cāng)庫(kù)生效。每次安裝前也可以--verbose看實(shí)際請(qǐng)求路徑確認(rèn)走的是鏡像而不是默認(rèn)倉(cāng)庫(kù)。刪掉$ANDROID_HOME下帶 .tmp 后綴的殘留臨時(shí)文件再重試能解決一部分“裝了半截”的怪問題。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 沒認(rèn)到sdkmanager裝的那個(gè) SDK。第三種是構(gòu)建工具安裝時(shí)目錄寫入權(quán)限有問題文件沒寫全。解決先確認(rèn)本機(jī)到底裝了哪個(gè)版本直接看目錄ls $ANDROID_HOME/build-tools/ ls $ANDROID_HOME/build-tools/34.0.0/aapt2如果目錄里沒有對(duì)應(yīng)版本用sdkmanager --install build-tools;34.0.0補(bǔ)裝。如果版本存在但 Gradle 報(bào)缺失檢查項(xiàng)目根目錄local.properties里的sdk.dir是否指向ANDROID_HOME用絕對(duì)路徑寫死是最可靠的方案。另外可以用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 打開項(xiàng)目報(bào)SDK location not found。兩個(gè)環(huán)境各認(rèn)各的路徑互不相通。原因Android Studio 通過local.properties或自身的 SDK Location 設(shè)置來確定 SDK 路徑不會(huì)自動(dòng)讀取 shell 的環(huán)境變量。命令行工具通過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占了兩份磁盤空間還經(jīng)常因?yàn)榘姹静煌霈F(xiàn)怪問題。經(jīng)驗(yàn)是開發(fā)機(jī)上只維護(hù)一份 SDK命令行和 IDE 都用它。5.5 手滑刪錯(cuò)目錄或權(quán)限被 root 占用現(xiàn)象sdkmanager 安裝組件時(shí)寫到一半報(bào) Permission denied或者整個(gè) SDK 目錄被人誤刪所有環(huán)境變量都失效。原因最常見的兩種一是有同事為了方便用sudo sdkmanager安裝組件導(dǎo)致 SDK 下所有目錄的 owner 變成 root普通用戶之后想裝任何東西都沒有寫權(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。誤刪目錄沒有后悔藥只能按第 3 章的流程重新下載 zip、解壓、重裝 SDK 組件。但有個(gè)能減少損失的習(xí)慣把sdkmanager --list_installed的輸出保存下來重裝的時(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è)命令連起來跑先看工具版本再看已裝組件清單最后看 adb。三步都通過這個(gè)環(huán)境基本就能直接開干。sdkmanager --version sdkmanager --list_installed adb version保證前一條成功才執(zhí)行下一條任一步失敗就能定位問題在哪個(gè)環(huán)節(jié)。sdkmanager 版本號(hào)報(bào)錯(cuò)多半是 JDK 或目錄問題list 結(jié)果缺失組件說明安裝不完整adb 報(bào) command not found 則檢查 PATH 里是否包含 platform-tools。這套檢查同樣適合寫成一個(gè)check_android_env.sh腳本新入職同事拉下來跑一遍就能確認(rèn)環(huán)境就緒。6.2 三個(gè)用過就回不去的小配置第一個(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)寫進(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)擊獲取