简介：面向Android应用开发者的SDK Build-Tools 29.0.2离线补全包，针对Android 10（API级别29）的构建链，解决本地SDK缺少build-tools组件时无法正常编译、打包和签名的问题。压缩包共173个文件，主要类型包括C/C++头文件、动态库（.so/.dll）、可执行程序（.exe）、JAR类库、批处理脚本（.bat）以及字节码与资源描述文件，整体大小约37.16MB，可快速部署到离线环境或CI服务器；其中头文件与动态库支撑原生工具运行，可执行程序与批处理脚本负责命令行调用，JAR包则面向Gradle插件提供内部接口，这些文件共同构成一套完整的Android构建工具链。核心组件覆盖AAPT2资源编译与链接、d8/R8代码转换与缩减混淆、Zipalign对齐优化、apksigner多方案签名，还包含RenderScript编译支持，Gradle构建时可自动调用，完成资源处理、DEX生成、APK优化与安全签名全流程。已有1370人学习下载，适合需要锁定构建工具版本、解决API 29构建异常或手动维护Android SDK环境的开发者参考。 上周在帮一个老项目升级构建环境时，我盯着终端里红色报错看了好几分钟：The following SDK component was not installed: android sdk build-tools 29.0.2。手动打开Android SDK目录后，我在build-tools文件夹里发现了一个孤零零的build-tools.29.0.2.zip。这个文件让我折腾了大半天，也让我把Android SDK离线安装这件事彻底搞明白了。如果你也是因为下载失败、网络不稳、或者某个夹在缓存里的zip包而卡在“组件未安装”上，这篇文章应该能帮你少走不少弯路。
1. 这个 build-tools.29.0.2.zip 是怎么跑到你电脑上的
1.1 SDK管理器下载中断留下的小尾巴
很多人第一次看到这个zip，不是在下载网站，而是在自己的SDK目录里。原因其实不复杂：Android SDK Manager在安装组件时，不会直接一步到位，而是先把压缩包下载到临时缓存，完整下载并校验通过后，再解压到正式目录。如果下载中途取消、网络中断、磁盘空间不够，或是IDE被强制关闭，压缩包就可能残留在缓存目录里，而IDE和Gradle并不知道它“半路夭折”了。
所以你在build-tools文件夹旁边看到的build-tools.29.0.2.zip，八成是下载缓存留下的半成品。它本身不是病毒，也不算毒瘤，但如果你不知道它的来路，很容易误以为“把zip手动扔到SDK目录里就等于装好了”——这是一个让很多新手困惑的误区。
1.2 Build Tools 到底在 Android 构建链路里干什么
要理解为什么这个zip这么重要，先得知道Build Tools在Android工程里的角色。Gradle在打包APK时，不是自己闷头生成所有东西。它需要调用一系列外部工具，比如：
aapt2：把Android资源文件编译、链接成二进制资源表；aidl：处理AIDL接口文件，生成跨进程通信的Java桩代码；zipalign：优化APK包内的资源对齐，提升安装后运行时的读取效率；apksigner：对APK进行签名验证；d8/dx：把Java字节码转换成安卓虚拟机能够执行的DEX格式。
这些工具就打包在Build Tools里。没有它们，哪怕你的代码写得再漂亮，Gradle也会在资源处理、DEX转换或者签名环节直接卡死。29.0.2这个版本，恰好是Android Gradle Plugin（AGP）3.5.x时代默认使用的Build Tools版本，很多老项目、旧模块、第三方SDK的构建脚本里都会写死buildToolsVersion "29.0.2"，少它不行。
2. 拿到 zip 之后，怎样才算“装好了”
2.1 目标目录长什么样
先说最标准的做法。假设你的Android SDK根目录是$ANDROID_HOME，在Windows上通常长这样：
%LOCALAPPDATA%\Android\Sdk在macOS或Linux上长这样：
~/Library/Android/sdkbuild-tools目录下，每一个具体版本对应一个文件夹，比如：
build-tools/ ├── 29.0.2/ │ ├── aapt2 │ ├── aidl │ ├── apksigner │ ├── d8 │ ├── source.properties │ ├── package.xml │ └── lib/ ├── 30.0.3/ └── 34.0.0/所以如果你拿到手的是build-tools.29.0.2.zip，正确操作应该是把压缩包解压，然后把里面的29.0.2文件夹放到build-tools目录下，而不是把zip压缩包原封不动扔进去。这个顺序看着简单，但真的是很多人踩坑的重灾区。
2.2 解压之后还差临门一脚：元数据文件
解压到位不等于万事大吉。正常的Build Tools目录里，除了那些可执行文件，还必须有source.properties和package.xml这类元数据文件。source.properties里记录着Pkg.Revision=29.0.2这样的版本信息，SDK Manager靠它来判断这个目录属于哪个组件版本；package.xml则是包管理器用来追踪安装状态的文件。
如果你下载的zip是从可靠渠道完整打包过来的，里面通常会带上这些文件。但如果你是从IDE缓存目录里捡回来的半成品，或者从某些不明网站下载的“精简约减版”，很可能会发现解压后只有一堆.jar和二进制文件，却没有元数据。
这时候就算Gradle临时能找到目录里的aapt2，Android Studio的SDK Manager也会认为29.0.2根本没安装，下一次同步项目时照样报“组件未安装”。我遇到过最蛋疼的情况就是：文件夹里该有的可执行文件都有，但source.properties缺失，结果Gradle一直提示找不到Build Tools 29.0.2。
3. 排错实录：一次典型的“组件未安装”处理过程
3.1 报错信息到底在说什么
先看一条最常见的报错：
The following SDK component was not installed: android sdk build-tools 29.0.2这句话拆开看，是说Gradle在启动构建时，试图确认当前工程需要的Build Tools版本是否存在，结果在SDK目录里没找到，或者找到的目录不完整。注意，它不是让你“下载”一个zip，而是要求SDK目录里已经有一个可用的Build Tools版本。
遇到这个报错，我的排查顺序一般是这样：
- 先看
build-tools目录下有没有对应的版本文件夹； - 如果有，进去看
aapt2、apksigner这些核心文件在不在； - 再看
source.properties和package.xml在不在； - 最后用SDK Manager命令行工具确认它是否被“官方”识别为已安装组件。
3.2 用命令行工具确认并注册
如果你的build-tools/29.0.2文件夹已经存在，但SDK Manager还是说没装，最直接的办法是让sdkmanager自己把状态刷一遍。命令行工具在cmdline-tools/latest/bin/sdkmanager（Windows下是sdkmanager.bat）。先看看当前已安装的东西：
sdkmanager --list_installed --sdk_root="$ANDROID_HOME"如果输出里没有build-tools;29.0.2，说明SDK Manager不认为这个版本已注册。这时有两种处理方式：
第一种，网络条件允许的话，直接让sdkmanager装一遍：
sdkmanager --sdk_root="$ANDROID_HOME" "build-tools;29.0.2"它会把缺失的元数据、依赖文件补齐。如果之前已经手动解压过完整内容，这个过程可能很快，因为重复文件会被跳过或覆盖。
第二种，网络实在不行，需要手动补元数据。至少确保29.0.2目录下存在source.properties，内容形式类似：
Pkg.Revision=29.0.2 Pkg.Desc=Android SDK Build-Tools 29.0.2 Pkg.License=Android-SDK具体字段顺序不用完全一样，但Pkg.Revision必须对得上版本号。至于package.xml，如果是从另一个完整版本目录里复制过来的，记得改掉里面的版本相关字段，否则可能引发混乱。
3.3 手动装完后如何让 Gradle 闭嘴
还有一个很常见的场景：文件夹完整、工具也能执行，但Gradle还是提示找不到。这时候先不要急着反复重装，先确认工程里的配置：
android { buildToolsVersion "29.0.2" }如果你在build.gradle里写死了29.0.2，那Gradle会严格检查这个版本。哪怕你已经装了34.0.0，它也不会拿新版去替代。反过来，如果工程里压根没指定buildToolsVersion，那么AGP会根据自身版本选一个默认值。这种情况下，你要装的是AGP默认对应的那个版本，而不是你“以为”的那个版本。
手动放好目录后，回到Android Studio里执行一次File -> Sync Project with Gradle Files，让它重新扫描。如果Gradle的守护进程还缓存着旧的失败状态，可以试着执行：
./gradlew --stop再重新构建，很多时候报错就消失了。
4. 为什么建议大家别把 Build Tools 版本随手升级
4.1 版本与 AGP、CompileSdk 的搭配关系
build-tools.29.0.2.zip背后有一个很现实的问题：为什么是老版本？很多人习惯看到最新版本号就直接下载，觉得版本越新越好。但在Android构建工具链里，Build Tools、AGP、compileSdk这三者之间是有匹配关系的，不是越新越稳。
AGP 3.5.x默认使用Build Tools 29.0.2，AGP 4.0.x默认使用30.0.0，AGP 7.x开始又把默认版本推到了30.0.3甚至更高。如果你强行给AGP 3.5配一个Build Tools 34，可能会因为新版工具依赖更高的JDK版本、或者产出的AAPT2版本与AGP不兼容，遇到一些莫名其妙的报错。反过来说，一个老项目要的就是29.0.2，你装再多个新版本也解决不了“缺这个版本”的问题。
所以看到关于android sdk build-tools 34下载或者更奇怪版本号的热词，我第一反应都是：先搞清楚工程里到底写没写死版本号，别被“装最新版”的惯性思维带偏。
4.2 多版本共存与空间占用
Build Tools和Android SDK里的其他组件不一样，它并不要求“一个版本号只能有一个”。build-tools目录下完全可以同时存在29.0.2、30.0.3、34.0.0好几个版本，不同项目会用各自需要的版本，互不干扰。这种做法反而是最稳的。
唯一要注意的是体积。老版本Build Tools里的lib目录动辄一两百MB，多个版本堆在一起，占用的空间其实不小。如果你有清理SDK的习惯，千万别看哪个版本“老”就随手删了——万一某个项目还在用它，你下一次打开项目就会收获熟悉的“组件未安装”大礼包。
5. 关于这个 zip，我踩过的一些坑和最后建议
5.1 不要直接拿解压工具往 SDK 目录里覆盖
如果你决定手动解压，我建议先解压到临时目录，确认里面文件结构没问题，再整体复制到build-tools下。不要直接用解压工具把zip里的内容“释放到”SDK的build-tools根目录。因为有些zip包内部层级可能多包了一层，比如解压出来是android-sdk/build-tools/29.0.2，结果你直接释放，生成了一堆乱七八糟的嵌套目录，后面排查起来相当痛苦。
另外，Windows用户要特别注意，build-tools目录下有一些可执行文件，比如aapt2，对权限和路径长度很敏感。如果你把SDK放在C:\Program Files\这种带空格、且权限要求高的路径下，解压时很容易弹权限错误，或者干脆解压了一部分文件就静默失败。我自己的习惯是把Android SDK放在一个纯英文、无空格的路径下，比如D:\Android\Sdk。
5.2 安全软件拦截和下载源完整性
Build Tools压缩包里全是可执行文件和动态库，有些激进的安全软件会把它识别成可疑程序，尤其是从浏览器缓存文件夹里捞出来的zip。别问我怎么知道的，我之前有台Windows开发机上，整个Build Tools被安全软件当场隔离过，导致Gradle构建时提示找不到一堆工具。
为了避免这类问题，尽量从官方渠道或可信镜像下载。拿到zip后，有条件的话先看一下文件大小和SHA-256校验值，和官方记录对一下再解压。网络上确实存在一些被篡改过的SDK组件包，里面可能被塞了额外的东西。压缩包这玩意儿，打开之前多留个心眼总没错。
5.3 实在折腾不明白时的兜底方案
如果你试了手动解压、补source.properties、命令行安装，还是报The following SDK component was not installed，别死磕了。我的兜底方案是直接删掉build-tools/29.0.2这个目录，以及那个半成品的zip，然后打开Android Studio的SDK Manager，把Android SDK Build-Tools下的29.0.2重新勾选下载一遍。
这一步会自动还原所有元数据、把依赖关系理清楚，比你手动折腾半天靠谱得多。因为SDK Manager在安装时会做完整性校验，确保所有文件到位、版本登记正确。只要你的网络别太离谱，基本都能成功。
说回build-tools.29.0.2.zip这个文件，它其实就是一个“残缺的下载产物”，背后真正的问题不是这个zip本身，而是本地SDK状态与工程需求脱节。你只要理解了Build Tools是什么、SDK Manager怎么识别它、Gradle怎么找它，以后再遇到任何版本的Build Tools缺失，都能用同一套思路快速解决。我个人在排完这个问题之后，做的第一件事就是在README里给老项目补了一句：构建这个项目必须提前装好Build Tools 29.0.2，别再让下一个接手的人踩同一个坑了。
本文还有配套的精品资源，点击获取
