Skip to content
项目

lzhiyong/android-sdk-tools

在 GitHub 查看

lzhiyong/android-sdk-tools has 667 GitHub stars and 137 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-17 05:00 UTC. Last push 2026-10-15.

这些数字如何统计

实测星标增长

24小时
0
7天
正在收集历史
15天
正在收集历史
1个月
正在收集历史

各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。

关于

building android-sdk tools for Android

开发工具

README_cn.md

原文

android-sdk-tools

English | 简体中文

使用 CMake 从 AOSP 源码编译 Android 的 platform-tools 和 build-tools,例如 aapt aapt2 aidl zipalign adb fastboot 等。

  • 默认静态编译:可执行文件完全静态链接,没有运行时依赖
  • 多工具链:Android NDK、zig、本机编译器,或任意 CMake 工具链文件
  • 多架构:aarch64、arm、x86_64、i686
  • 预编译产物:由 GitHub Actions 编译并发布到 Releases

如果需要其他工具,可以参考现有工具的写法添加 CMake 文件。

工具列表

目录 工具
build-tools aapt aapt2 aidl zipalign dexdump split-select
platform-tools adb fastboot sqlite3 etc1tool hprof-conv e2fsdroid sload_f2fs mke2fs make_f2fs make_f2fs_casefold
others veridex

工具链

工具链 libc 产物
ndk(默认) bionic Android 可执行文件
zig musl(静态)/ glibc(动态) Linux 可执行文件,静态版本也可以在 Android 上运行
host 本机($CC/$CXX,默认 clang) 本机可执行文件
custom 任意 CMake 工具链文件 交叉 gcc / clang / musl-cross 等

--arch 也接受 Android ABI 名称:arm64-v8a、armeabi-v7a、x86。

zig 工具链目前属于实验性支持:构建系统已经支持,但部分 AOSP 源码上游只在 bionic / glibc 下编译过, 在 musl 下可能还需要额外的补丁。

下载

从 Releases 下载 android-sdk-tools-static-<架构>.zip。 Release 的 tag 来自 patches/misc/platform_tools_version.h 中的 PLATFORM_TOOLS_VERSION,例如 36.0.0。

使用 Docker 编译

Dockerfile 提供了包含 NDK、zig 及全部依赖的编译环境,项目目录以挂载方式进入容器。

docker build --platform linux/amd64 -t android-sdk-tools .

# 获取源码并使用 NDK 编译
docker run --rm -it --platform linux/amd64 -u "$(id -u):$(id -g)" -v "$PWD:/work" android-sdk-tools \
    sh -c "python3 get_source.py && python3 build.py --arch aarch64"

# 使用 zig 编译
docker run --rm -it --platform linux/amd64 -u "$(id -u):$(id -g)" -v "$PWD:/work" android-sdk-tools \
    python3 build.py --toolchain zig --arch aarch64

构建参数:NDK_VERSION(默认 r29)和 ZIG_VERSION(默认 0.16.0), 设为空即可跳过安装,例如 --build-arg ZIG_VERSION=。

手动编译

1. 依赖

git patch python3 cmake (>= 3.19) ninja bison flex go、本机 C/C++ 编译器, 以及要使用的工具链(NDK 或 zig)。

# Debian / Ubuntu
sudo apt install git patch python3 cmake ninja-build bison flex golang-go build-essential

2. 获取源码

get_source.py 会克隆 repository.json 中的所有仓库并应用补丁, 默认 tag 为 platform-tools-<PLATFORM_TOOLS_VERSION>。

python get_source.py

# 指定分支或 tag
# 可用的 tag 见 https://android.googlesource.com/platform/frameworks/base/+refs
python get_source.py --tags platform-tools-36.0.0

# 其他选项:--jobs(并行克隆数)、--retries(重试次数)、--skip-patch(不打补丁)
python get_source.py --help

源码补丁只适用于特定的 tag,无法应用到当前 tag 的补丁会被跳过并给出提示。

3. 编译

build.py 会自动编译本机的 protoc(用于生成 aapt2 和 adb 的源码), 然后编译所有工具,并打包为 android-sdk-tools-<static|shared>-<架构>.zip。

# NDK(默认工具链),静态链接(默认)
python build.py --ndk=/path/to/android-ndk-xxx --arch=aarch64

# zig,静态 musl 可执行文件
python build.py --toolchain=zig --arch=aarch64

# 动态链接
python build.py --ndk=/path/to/android-ndk-xxx --arch=aarch64 --link=shared

# 本机编译器
python build.py --toolchain=host --arch=x86_64 --cc=clang --cxx=clang++

# 其他工具链,使用 CMake 工具链文件
python build.py --toolchain=custom --toolchain-file=/path/to/toolchain.cmake --arch=aarch64

# 使用已有的本机 protoc
python build.py --ndk=/path/to/android-ndk-xxx --arch=aarch64 --protoc=/path/to/protoc

# 只编译指定目标,便于定位错误
python build.py --ndk=/path/to/android-ndk-xxx --arch=aarch64 --target aapt2 adb

# 在 -- 之后传入额外的 cmake 参数
python build.py --toolchain=zig --arch=x86_64 -- -DSDK_STRIP=OFF

# 查看全部选项
python build.py --help

NDK 路径也可以通过环境变量 ANDROID_NDK_HOME / ANDROID_NDK_ROOT 指定。 编译目录为 build/<工具链>-<链接方式>-<架构>,可执行文件位于其中的 bin 目录。

直接使用 CMake

选项 默认值 说明
SDK_STATIC ON 完全静态链接
SDK_STRIP ON 链接时去除符号(Release)
PROTOC_PATH 本机 protoc 路径
ZIG_TARGET cmake/toolchains/zig.cmake 的目标,例如 aarch64-linux-musl
ZIG_CPU 可选,zig 的 -mcpu,例如 cortex_a53
cmake -GNinja -B build/zig -DCMAKE_TOOLCHAIN_FILE=cmake/toolchains/zig.cmake \
    -DZIG_TARGET=aarch64-linux-musl -DPROTOC_PATH=/path/to/protoc
ninja -C build/zig

项目结构

├── CMakeLists.txt            顶层工程、第三方库
├── cmake/
│   ├── platform.cmake        静态链接、strip、系统库(与工具链无关)
│   ├── zlib.cmake            内置的静态 zlib
│   ├── modules/FindZLIB.cmake  将 find_package(ZLIB) 重定向到内置 zlib
│   └── toolchains/zig.cmake  zig 工具链文件
├── lib/                      AOSP 基础库(libbase、libutils、liblog 等)
├── build-tools/              aapt、aapt2、aidl 等
├── platform-tools/           adb、fastboot 等
├── others/                   veridex
├── patches/                  源码补丁和预生成文件
├── repository.json           源码仓库列表
├── get_source.py             获取源码
├── build.py                  编译与打包
├── Dockerfile                编译环境
└── .github/workflows/        CI

GitHub Actions

.github/workflows/build.yml 在每次 push 时使用 NDK 编译所有架构 (手动运行时可以选择 zig),然后发布 release:

  • tag 为 PLATFORM_TOOLS_VERSION,例如 36.0.0,标题为 v36.0.0
  • release 描述为最新的 commit 信息(每次替换,不会追加)
  • PLATFORM_TOOLS_VERSION 没有变化时不创建新的 release, 而是覆盖上传已有 release 的文件,并把 tag 移动到最新的 commit
  • 压缩包按架构区分:android-sdk-tools-static-aarch64.zip、android-sdk-tools-static-arm.zip、 android-sdk-tools-static-x86_64.zip、android-sdk-tools-static-i686.zip

Pull request 只编译,不发布。

许可证

Apache License 2.0