简介这份资源是面向 Linux 平台的 Android 命令行工具包适合不想安装完整 Android Studio、却需要构建与调试 Android 应用的开发者尤其是习惯命令行工作流的中高级用户。压缩包共 101 个文件以 91 个 jar 库为核心辅以 sdkmanager、avdmanager、apkanalyzer、lint、retrace、profgen、screenshot2 等可执行脚本及说明文档整体约 127.32MB覆盖 SDK 包管理、虚拟设备创建、APK 分析、代码检查与混淆还原等常用环节。借助其中的 sdkmanager可按需下载其他 SDK 组件灵活搭建轻量开发环境。目前已有 225 人学习下载可作为搭建持续集成、自动化构建或服务器端 Android 工具链的基础素材帮助读者快速获得一套可直接调用的命令行工具集减少对图形界面的依赖。1. 从一串版本号说起commandlinetools-linux-9477386-latest.zip 到底是什么如果你在 CI 流水线里见过commandlinetools-linux-9477386-latest.zip这个文件名大概率是在配 Android 构建环境时被它卡过一次。它不是一个普通压缩包而是 Android SDK 的命令行工具集Command-line Tools版本号 9477386 对应的是某个具体的构建号latest只是官方下载页的固定命名习惯。这个包解决的核心问题是在没有 Android Studio 图形界面的 Linux 服务器、容器或远程开发机上只靠命令行完成 SDK 组件安装、许可证接受、构建工具拉取和 APK 打包。适合谁适合需要把 Android 构建塞进 Docker 镜像、Jenkins/GitLab CI 流水线或者单纯不想在服务器上装几个 G 图形界面的后端和运维同学。它不包含模拟器也不包含 IDE只给你sdkmanager、avdmanager、adb、fastboot这几个关键命令。2. 拆开这个压缩包目录结构、组件与选型理由2.1 解压后到底有什么把commandlinetools-linux-9477386-latest.zip解压到任意目录你会看到cmdline-tools/下有一个bin/和一个lib/。bin/里就是sdkmanager、avdmanager、lint、retrace等脚本lib/里是它们依赖的 jar 包。注意这个包本身不包含platform-tools也就是adb也不包含任何 Android 平台或构建工具那些都需要通过sdkmanager联网下载。所以解压完直接敲adb是找不到命令的这是新手第一个容易懵的点。2.2 为什么不用 Android Studio 自带的 SDKAndroid Studio 安装时会顺带装一份 SDK但那份 SDK 的路径通常绑定在用户目录下且体积巨大。在 CI 场景里你不可能在每个构建节点装一个完整的 IDE。命令行工具包只有几十 MB解压即用配合sdkmanager按需拉取指定版本的platforms和build-tools能把镜像体积压到最小。另一个理由是版本可控9477386这个构建号对应的工具版本是固定的不会因为某天官方更新latest导致流水线突然行为不一致。我一般会在 Dockerfile 里显式写死这个文件名而不是用latest去下载避免缓存失效和版本漂移。2.3 版本号 9477386 意味着什么这个数字是 Google 内部的构建 ID不是语义化版本。它对应的是 Command-line Tools 的某个具体修订版。不同构建号之间sdkmanager的默认行为、支持的 Java 版本、以及--sdk_root参数的处理方式可能有细微差别。比如较老的构建号在 Java 17 下会报NoClassDefFoundError而较新的构建号已经适配。如果你在 CI 里遇到莫名其妙的java.lang.NoSuchMethodError先确认你用的构建号是否和当前 JDK 匹配。常见做法是JDK 17 配较新的构建号JDK 8 配老构建号不要混搭。2.4 最小可用目录布局sdkmanager对目录结构有硬性要求。它期望在sdk_root/cmdline-tools/latest/bin/sdkmanager这个路径下找到自己。如果你直接把解压出来的cmdline-tools放在sdk_root/cmdline-tools它会报Could not determine SDK root。正确的做法是手动建一层latest目录把解压出来的内容挪进去。这个坑几乎每个人都会踩一次下面用命令演示。# 假设下载到 /tmp准备安装到 /opt/android-sdk mkdir -p /opt/android-sdk/cmdline-tools cd /tmp unzip commandlinetools-linux-9477386-latest.zip -d /tmp/cmdline-tools-temp # 关键一步把解压出的 cmdline-tools 内容挪到 latest 下 mv /tmp/cmdline-tools-temp/cmdline-tools /opt/android-sdk/cmdline-tools/latest # 验证目录结构 ls /opt/android-sdk/cmdline-tools/latest/bin/sdkmanager逻辑说明sdkmanager脚本内部会通过自身路径反推sdk_root它假设自己的父目录名是latest再往上一级才是cmdline-tools再往上一级才是 SDK 根。如果你不建latest这一层它反推出来的根目录就是错的。参数上-d指定解压目标目录mv那一步不能省。执行完ls能看到sdkmanager文件存在才算布局正确。3. 在无界面 Linux 上跑通 SDK 安装与许可证接受3.1 配置环境变量与 PATH装好目录结构后需要把sdkmanager和后续的platform-tools加进 PATH。我一般会在~/.bashrc或 CI 的 env 里写三行ANDROID_SDK_ROOT、ANDROID_HOME、以及把cmdline-tools/latest/bin和platform-tools追加到 PATH。ANDROID_SDK_ROOT和ANDROID_HOME现在建议都设成同一个值因为不同工具读的变量名不一样只设一个容易在某些脚本里翻车。export ANDROID_SDK_ROOT/opt/android-sdk export ANDROID_HOME/opt/android-sdk export PATH$PATH:$ANDROID_SDK_ROOT/cmdline-tools/latest/bin export PATH$PATH:$ANDROID_SDK_ROOT/platform-tools逻辑说明ANDROID_SDK_ROOT是较新工具链推荐使用的变量ANDROID_HOME是历史遗留但很多 Gradle 插件仍在读。两个都设避免兼容性问题。PATH 里先加cmdline-tools再加platform-tools因为platform-tools里才有adb而cmdline-tools里才有sdkmanager顺序不影响功能但分开写更清晰。3.2 用 sdkmanager 安装指定组件sdkmanager的基本用法是sdkmanager 包名。包名有固定格式比如platforms;android-34、build-tools;34.0.0、platform-tools。注意分号在 shell 里需要引号包起来否则会被当成命令分隔符。安装前可以先--list看有哪些可用包但--list会联网拉取仓库元数据首次执行可能较慢。# 查看已安装和可用包 sdkmanager --list # 安装平台、构建工具和 platform-tools sdkmanager platforms;android-34 build-tools;34.0.0 platform-tools # 指定 sdk_root当环境变量没设时 sdkmanager --sdk_root/opt/android-sdk platforms;android-34逻辑说明--list会输出两大块Installed packages和Available Packages。安装时如果包名拼错它会提示Warning: Failed to find package。--sdk_root参数在环境变量已设的情况下可以省略但在 Docker 构建的某些阶段环境变量还没生效显式传更稳妥。安装完成后platforms/android-34和build-tools/34.0.0目录会出现。3.3 非交互式接受许可证CI 环境没有 TTYsdkmanager安装时如果遇到未接受的许可证会卡住等待输入。解决办法是用yes管道把y灌进去。这是最常用也最稳的方式比--licenses交互式接受更适合脚本。yes | sdkmanager --licenses # 或者安装时直接带 yes yes | sdkmanager platforms;android-34 build-tools;34.0.0逻辑说明yes命令会无限输出y管道给sdkmanager后所有许可证提示都会被自动确认。--licenses子命令会遍历所有需要接受的许可证并逐个提示。注意如果sdkmanager因为网络问题提前退出yes会收到SIGPIPE但不会报错所以执行完最好再跑一次sdkmanager --list确认目标包已安装。3.4 验证安装结果安装完不能只看命令没报错要实际验证目录和命令。adb version能输出版本号说明platform-tools就位ls $ANDROID_SDK_ROOT/platforms能看到android-34说明平台就位。这一步在 Docker 构建里建议写成RUN指令构建失败能立刻暴露。adb version ls $ANDROID_SDK_ROOT/platforms ls $ANDROID_SDK_ROOT/build-tools逻辑说明adb version读的是platform-tools里的二进制如果 PATH 没配好会报command not found。ls两个目录是确认sdkmanager真的把文件写到了预期位置。有些 CI 缓存会把旧版本目录带进来导致ls看到多个版本这时要确认 Gradle 里指定的compileSdk和buildToolsVersion与实际安装的一致。4. 避坑与排查那些让流水线红掉的细节4.1 报错 Could not determine SDK root现象执行sdkmanager时直接报Could not determine SDK root命令退出。原因解压后没有把cmdline-tools内容放到latest子目录下sdkmanager反推根目录失败。解决按 2.4 节的目录布局重新整理确保路径是sdk_root/cmdline-tools/latest/bin/sdkmanager。如果已经装错删掉cmdline-tools重新解压挪动即可。4.2 Java 版本不匹配导致 NoClassDefFoundError现象sdkmanager启动时报NoClassDefFoundError或UnsupportedClassVersionError。原因构建号 9477386 对应的工具版本对 JDK 有要求用 JDK 8 跑较新工具或反过来都可能出问题。解决先java -version确认当前 JDK然后要么换 JDK要么换一个匹配的构建号。CI 里建议把 JDK 版本和命令行工具构建号一起锁在 Dockerfile 里不要依赖宿主机默认 Java。4.3 许可证接受后仍然报 license not accepted现象明明跑过yes | sdkmanager --licensesGradle 构建时仍报You have not accepted the license agreements。原因许可证文件写在$ANDROID_SDK_ROOT/licenses/下如果构建时用的ANDROID_SDK_ROOT和接受许可证时的根目录不是同一个Gradle 读不到。解决确认接受许可证和构建使用同一个 SDK 根路径检查licenses目录下是否有android-sdk-license文件。Docker 多阶段构建时尤其容易把许可证留在上一个阶段。4.4 网络超时导致包下载一半失败现象sdkmanager下载到一半卡住或报Connection timed out。原因默认仓库地址在部分网络环境下不稳定或者 CI 节点没有外网访问权限。解决配置 HTTP 代理如果环境允许或者提前把需要的包缓存到本地目录用--sdk_root指向缓存。另一个办法是在 Dockerfile 里把sdkmanager安装步骤放在网络稳定的构建阶段并把结果提交进镜像层。4.5 目录权限导致写入失败现象sdkmanager报Permission denied写$ANDROID_SDK_ROOT。原因Docker 里用非 root 用户运行但 SDK 目录是 root 创建的。解决在 Dockerfile 里chown -R给运行用户或者把 SDK 装到用户有写权限的路径下。CI 里如果缓存目录由不同用户创建也会出现类似问题清理缓存或统一用户即可。5. 把它塞进 Docker 与 CI一个可复用的最小构建镜像5.1 Dockerfile 分层策略把命令行工具、SDK 组件、许可证接受分成三层利用 Docker 缓存。命令行工具包很少变放最底层SDK 组件按需安装放中间层许可证接受放上层。这样改应用代码时不会触发 SDK 重装。FROM ubuntu:22.04 # 安装基础依赖 RUN apt-get update apt-get install -y openjdk-17-jdk unzip wget rm -rf /var/lib/apt/lists/* # 下载并解压命令行工具 ENV ANDROID_SDK_ROOT/opt/android-sdk RUN mkdir -p $ANDROID_SDK_ROOT/cmdline-tools \ wget -q https://example.com/commandlinetools-linux-9477386-latest.zip -O /tmp/tools.zip \ unzip -q /tmp/tools.zip -d /tmp/tools \ mv /tmp/tools/cmdline-tools $ANDROID_SDK_ROOT/cmdline-tools/latest \ rm -rf /tmp/tools /tmp/tools.zip ENV PATH$PATH:$ANDROID_SDK_ROOT/cmdline-tools/latest/bin # 安装 SDK 组件并接受许可证 RUN yes | sdkmanager platform-tools platforms;android-34 build-tools;34.0.0 \ yes | sdkmanager --licenses ENV PATH$PATH:$ANDROID_SDK_ROOT/platform-tools逻辑说明wget那行的 URL 需要替换成实际可访问的下载地址这里用占位符表示。mv到latest是必须的。yes | sdkmanager两行分别安装组件和接受许可证顺序不能反因为安装时可能触发新的许可证提示。ENV PATH分两次设置确保adb和sdkmanager都在 PATH 里。5.2 CI 缓存与增量更新在 GitLab CI 或 GitHub Actions 里可以把$ANDROID_SDK_ROOT目录缓存起来key 用构建号加组件列表的哈希。这样后续流水线不用重复下载。但要注意缓存命中时sdkmanager可能因为目录已存在而跳过安装导致许可证文件缺失。稳妥做法是缓存后仍然跑一次yes | sdkmanager --licenses成本很低。# 以 GitLab CI 为例的缓存片段 cache: key: android-sdk-9477386 paths: - /opt/android-sdk/逻辑说明key里带上构建号避免不同工具版本共用缓存。paths指向 SDK 根目录。缓存恢复后构建脚本里仍然要执行许可证接受和组件校验不能假设缓存一定完整。5.3 验证镜像是否真的可用构建完镜像后不要只看docker build成功。跑一个临时容器执行sdkmanager --list和adb version确认输出正常。如果sdkmanager --list报错说明目录布局或 Java 环境有问题如果adb version找不到命令说明 PATH 没生效。docker run --rm my-android-builder sdkmanager --list docker run --rm my-android-builder adb version逻辑说明--rm让容器退出后自动删除避免残留。两条命令分别验证命令行工具和平台工具。如果第一条报Could not determine SDK root回去检查latest目录如果第二条报command not found检查ENV PATH是否包含platform-tools。5.4 一个容易忽略的细节时区和 localesdkmanager在某些 locale 下会输出乱码或解析异常尤其是LANG没设成 UTF-8 时。Docker 基础镜像默认可能是POSIX建议在 Dockerfile 里设ENV LANGC.UTF-8。时区不影响 SDK 安装但会影响构建日志时间戳CI 里统一设成 UTC 更利于排查。ENV LANGC.UTF-8 ENV TZUTC逻辑说明LANG影响 Java 的默认字符集C.UTF-8在大多数 Linux 发行版上可用。TZ设成 UTC 避免日志时间跳变。这两行放在 Dockerfile 靠前位置利用缓存。5.5 进阶技巧用 sdkmanager 的 --channel 控制更新通道sdkmanager默认走稳定通道但可以通过--channel3切到 canary 通道拿预览版工具。生产环境不建议用 canary但如果你需要某个只在预览通道修复的 bug可以临时切。切完记得切回来否则后续安装的组件可能不稳定。sdkmanager --channel3 --list sdkmanager --channel0 platforms;android-34逻辑说明--channel0是稳定通道--channel3是 canary。--list配合 channel 可以看到不同通道的包版本差异。这个参数在排查“为什么官方文档说的包我这儿没有”时很有用因为有些包只在特定通道发布。我自己在流水线里踩过最疼的一次是缓存了 SDK 目录但没缓存许可证文件结果构建到一半报 license 未接受排查了半小时才定位到缓存 key 没包含许可证状态。从那以后我习惯在 Dockerfile 里把许可证接受和组件安装放在同一层并且每次构建都重新跑一遍yes | sdkmanager --licenses多花几秒换来确定性。希望帮到你。本文还有配套的精品资源点击获取
