简介：Eclipse ADT（安卓开发工具）离线安装包专为网络受限或希望快速搭建安卓开发环境的开发者准备，将谷歌官方整套 ADT 插件完整打包，省去在线下载依赖的步骤，特别适合企业内网、学校机房及移动网络不稳定的场景。离线包包含 ADT 核心编辑、设备调试服务、NDK 原生开发集成、布局层级查看器等主要插件，配合站点描述文件，可在 Eclipse 中通过“安装新软件”导入本地归档完成安装。资源共 18 个文件，以插件包为主体，另含站点描述、样式转换及层叠样式等辅助文件，整体约 12.94 兆字节，轻量实用。目前已有 1035 人学习或下载。解压后即得插件与功能特性目录，结构标准清晰，其中包含的调试与性能分析工具能有效支撑日常开发与问题排查，尤其适合刚开始接触安卓开发的初学者，或需要在内网环境下快速恢复开发工具链的程序员使用。 还在折腾 Eclipse ADT 离线包的人，我猜你大概率是下面这两类中的某一类：要么接手了一个七八年前的老安卓项目，必须原封不动地在 Eclipse 里维护；要么就是在线安装 ADT 装到崩溃，被那漫长的进度条和动不动就超时的“Install New Software”折磨得没脾气。不管哪种情况，离线包这条路都是最省心的解法。
这篇文章我会把整套“Eclipse 安装 ADT”的离线方案讲透：版本怎么搭配、离线包到底要下哪几样、一步步怎么装、装完怎么验收、踩坑了怎么排。全程按真实操作过的流程来写，不绕弯子，直接给你一份能照抄的作业。
1. ADT 离线包到底解决什么问题
1.1 在线安装的三座大山
先聊为什么会冒出“离线包”这个需求。ADT 是 Android Developer Tools 的缩写，它本质上是 Eclipse 的插件集，包含了项目创建、布局编辑器、DDMS、LogCat、AVD Manager 等一系列安卓开发工具。官方在 Eclipse 里给出的在线安装地址，指向的是 Google 的更新站点，虽然地址本身没毛病，但实际体验非常糟糕。
第一，下载速度不稳定。Eclipse 的插件安装机制是先拉取元数据，再解析依赖，最后下载插件本体。这个流程如果网速不稳，任何一个环节断了，整个安装直接失败，而且没有断点续传，只能从头再来。在线装 ADT 装到一半报错、重试四五次都是常态，运气差的话一下午都耗在这个进度条上。
第二，官方早已停止更新 ADT。Google 在 2015 年前后就把重点放到了 Android Studio 上，ADT 的最终版本停在 23.0.6，后续官方维护基本冻结。这就导致很多教程里给的在线更新地址，在不同网络环境下时好时坏，甚至部分地区已经很难访问。与其赌运气，不如直接把离线包下到本地，一劳永逸。
第三，很多开发环境本身就是内网隔离的，或者公司网络对访问外网有严格限制。在这种环境里，在线安装根本走不通，唯一的办法就是提前把 zip 包准备好，通过 U 盘、共享盘拷贝进去安装。所以“离线包”这三个字，代表的不只是一种下载方式，更是内网开发环境下的刚需。
1.2 ADT、Eclipse、SDK、JDK 的四角关系
这是整篇文章最值得画圈的地方。很多人在线安装失败，或者装完之后 Eclipse 起不来，绝大多数不是网络问题，而是版本匹配问题。
ADT 23.0.6 是最后一个版本，往后没有更新。和它配合最好的 Eclipse 是 4.4 Luna，4.3、4.2 也能用，但如果你用 4.5 以上的版本，ADT 的兼容性会明显变差，到了 Eclipse 4.7 之后基本就是装不上的状态。所以不用纠结“为什么我装了最新版 Eclipse 却装不了 ADT”，因为官方路线早就变了。
JDK 这块也容易踩坑。老 ADT 推荐搭配 32 位 JDK 1.7 或 1.8，同时 Eclipse 也要选 32 位版本。这里说的“位数”不是看操作系统，而是看软件本身的位数。很多人电脑是 64 位 Windows，装了 64 位 JDK，又下载了 32 位 Eclipse，结果一启动就弹 JNI 错误，或者干脆双击没反应，排查半天才发现位数对不上。
Android SDK 建议用 API 23 及以下的平台。原因很简单，ADT 的老版本对高版本 SDK 的布局预览、lint 检查已经跟不上，你装一个 API 30 的平台进去，很多东西反而不识别。我之前给一个老项目配环境，SDK 只装了 android-23 和对应的 build-tools，构建、真机调试都完全正常，即便手机是 Android 11 也没问题，只要 platform-tools 里的 adb 版本够新就行。
2. 安装前必须准备的离线物资清单
2.1 位数匹配：最容易翻车的坑
先花一分钟把位数问题落实。打开命令行，输入java -version，如果输出里有“64-Bit”，那当前 JDK 是 64 位；如果输出“32-Bit”，则是 32 位。Eclipse 的位数要看下载时选择的是 Windows 32-Bit 还是 64-Bit 版本。
我这里给出的建议是：整套环境尽量统一成 32 位。JDK 下载 32 位安装包（比如 jdk-8uXXX-windows-i586.exe），Eclipse 下载 32 位版本，装好后在环境变量里把JAVA_HOME指向 32 位 JDK 的安装目录。这样做的原因除了规避 JNI 报错之外，还有一个附加好处：老 Android SDK 里不少构建工具在 64 位组合下偶尔会有奇怪问题，32 位反而稳。在实际维护老项目的场景里，“能跑就行”永远是第一原则。
顺便提一个很容易忽略的点：Eclipse 解压路径不要带中文和空格，最好放在类似D:\dev\eclipse这种纯英文目录。老版 SDK 和 ADT 的本地构建对路径里的特殊字符非常敏感，犯不着在这种地方给自己挖坑。
2.2 离线包到底要下载哪几样
很多人一听到“ADT 离线包”就以为只要下载一个 ADT 的 zip，其他什么都不用管，这是理解偏差。一个完整可用的离线环境，至少需要下面这几样东西：
| 名称 | 用途 | 建议版本 |
|---|---|---|
| Eclipse IDE | 宿主 IDE | 4.4 Luna SR2，32 位 |
| JDK | Java 运行环境 | 32 位 JDK 1.8 |
| ADT 插件包 | 离线安装 Eclipse 安卓插件的源 | ADT-23.0.6.zip |
| Android SDK Tools | 包含 SDK Manager 等基础工具 | 25.2.5 及以下 |
| Platform-Tools | adb、fastboot 等调试工具 | 较新版本即可 |
| Platform（android-23） | 可编译的 API 库 | 按老项目实际 target 选择 |
| Build-Tools | 编译、打包、签名工具 | 23.0.1 及以上 |
| Intel HAXM（可选） | 模拟器硬件加速 | 官方安装包 |
Eclipse 和 ADT 的安装包，可以去官网或国内高校的开源镜像站找历史归档。SDK 的各个组件比较麻烦，如果找不到现成的完整 SDK 目录，可以先在能联网的机器上把需要的组件下载齐，再拷贝到离线机器。实操里最省事的办法，就是找同事或同行要一份现成的 SDK 目录整体拷过来，然后自己核对版本再补充。
2.3 下载后的校验小习惯
下载离线包这件事，最怕遇到文件损坏或不完整。ADT 的 zip 如果下载到一半断了、或者文件本身有问题，安装时概率性报错，而且报错信息很迷惑，比如“Cannot complete the install because one or more required items could not be found”，你很难第一时间想到是包坏了。
所以从官网或镜像站下载完任何 zip 之后，建议做一个哈希校验。Windows 下直接在命令行执行：
certutil -hashfile ADT-23.0.6.zip SHA256把输出的哈希值和官方页面标注的 SHA-256 对一下，一致再用。Eclipse、JDK 安装包也建议这么验一遍。这个习惯在下载任何离线包时都通用，后续你下 Gradle 发行包、下 SDK 组件，都可以用同样的方法确认文件的完整性。
3. 完整离线安装 ADT 的实操记录
3.1 装 JDK 和解压 Eclipse 的细节
先把 JDK 1.8 的 32 位安装包跑完。安装时建议把“公共 JRE”也勾上，虽然我们配置了JAVA_HOME，但有些老 Eclipse 在启动时会优先找系统的 JRE，顺手勾上能少一个报错源。装完 JDK 之后，检查环境变量，确保JAVA_HOME指向 JDK 目录，PATH里包含%JAVA_HOME%\bin，并且这个条目排在 PATH 的前面，避免和其他 JDK 版本冲突。
Eclipse 的解压没什么技术含量，解压到D:\dev\eclipse即可。解压完成后不用急着启动，在启动之前可以先找到eclipse.ini，确认-vm参数指向的是正确的javaw.exe路径。这个参数如果写错，Eclipse 会直接打不开，连报错都不弹，是我们后面要排查的重点之一。
3.2 用 Archive 方式安装 ADT 插件
启动 Eclipse 后，菜单栏找到Help -> Install New Software，这个入口是 Eclipse 装插件的标准方式。在线安装是从更新地址拉取，离线方案则用右上角的Add按钮，弹窗里 Name 随意填，比如“ADT 23.0.6”，Location 那边先点Local...或Archive...，选择之前下好的 ADT zip 文件。
如果按钮显示的是Archive...，直接选中 zip 路径即可。点 OK 后 Eclipse 会解析这个 zip 的内容，一段时间后在列表中列出“Android Developer Tools”以及 DDMS、Hierarchy Viewer 等子组件，一般全选，然后一路 Next。
到许可协议页面时要特别注意：列表中每一项许可都要选中“I accept the terms of the license agreements”，漏选任何一个都无法继续。点 Finish 后进入后台安装，右下角能看到进度。这个过程通常需要几分钟，中途一定别关 Eclipse。安装完成后会提示重启 IDE，选重启。
注意：如果在勾选组件后点 Next 报错，先别怀疑 zip 有问题。检查 Eclipse 版本是否过高，ADT 23.0.6 在 Eclipse 4.5 以上经常出现兼容性错误，最稳妥的是退回 Eclipse 4.4 再装一次。
3.3 配置 SDK 并创建模拟器
重启后，打开Window -> Preferences -> Android，右侧会有一个 SDK Location 输入框。把 SDK 目录路径填进去，点 Apply。如果路径正确、SDK 能正常识别，下方会列出已安装的 Android 平台版本；如果显示红色错误，说明路径不对或者 SDK 目录缺失关键文件。
接着打开Window -> Android SDK Manager，检查 Platform、Build Tools、Platform-Tools 是否都已经安装。如果你的机器是离线环境，SDK Manager 里那些没安装的项目就不要点勾选了，因为点了也只能下载失败。提前把 platform 目录复制到 SDK 文件夹里，比在 SDK Manager 里等待下载靠谱得多。
创建模拟器的入口是Window -> AVD Manager，点击 Create。Device 类型可以选 Nexus 5 这类常见机型，Target 选你实际上有的平台，比如 Android 6.0 API 23，CPU/ABI 选 x86 并且确保 HAXM 已经装好。RAM 不建议给太大，768MB 到 1GB 就够用，给 2GB 反而容易启动失败。如果电脑支持虚拟化加速，在 AVD 的配置里勾选“Use Host GPU”，模拟器启动速度和画面流畅度都会好很多。
3.4 拿老项目做一次完整验收
环境装好不代表完事，最好拿一个真实的老项目跑一遍，确认整条链路是通的。导入项目的入口是File -> Import -> Existing Projects into Workspace，选择项目根目录后勾选导入。
导入成功之后，先看项目根目录的project.properties，里面的target=android-XX必须指向你已经安装的 API 版本。如果 target 指向一个没装的平台，项目会报红，右键项目 -> Properties -> Android 也无法正确显示。遇到这种情况，要么下载对应的 Platform，要么把 target 改成你本地已有的版本，然后执行一次Project -> Clean重新编译。
右键项目 ->Run As -> Android Application，等模拟器启动，如果 APK 能成功安装、页面能正常拉起，说明你这套 Eclipse ADT 离线环境已经验收合格。到这里核心安装流程就算完整结束了。
4. 安装与使用中的高频问题排查
4.1 Eclipse 打不开、双击没反应
这是离线安装中出现频率最高的问题。优先级最高的怀疑对象是 JDK 位数和 Eclipse 位数不一致，32 位 Eclipse 配 64 位 JDK，大概率双击之后毫无反应，或者报“Failed to load the JNI shared library”。解决办法就是按前面说的，统一换成 32 位 JDK，并在eclipse.ini里显式配置-vm参数指向 JDK 下的javaw.exe。
如果位数没问题，还有一种常见情况是工作空间损坏。用命令行启动 Eclipse 并带上清理参数，指令如下：
eclipse.exe -clean -refresh这会清理插件缓存并刷新工作空间。如果还是打不开，就到工作空间目录下的.metadata\.log里看错误日志，日志里通常会写明卡在哪个插件上，比盲猜靠谱得多。
4.2 插件安装失败与残留处理
安装 ADT 时如果中途断掉或者失败，Eclipse 的 p2 安装器有时会留下半装状态，导致你重新安装时报“无法完成安装”。这时候不要急着重试，先打开Help -> About Eclipse -> Installation Details，在已安装软件列表里找到任何和 Android 相关的残留条目，选中并卸载，重启后再重新执行 Archive 安装。
另外还有一类问题：安装 ADT 后软件列表里明明能看到插件，但菜单里就是没有 Android 相关的入口。这种情况多数是 Eclipse 缓存了旧的插件状态，执行一次带-clean参数的启动，或者删掉工作空间里.metadata下和插件相关的缓存文件，基本能解决。
4.3 项目导入后一片飘红
老项目导入后最常见的报错是“Android requires compiler compliance level 5.0. Please fix project properties”。这是因为 Eclipse 默认的 Java 编译级别比较低，而老项目的构建配置和 Android 工具链要求更高。右键项目 -> Properties -> Java Compiler，把 Compiler compliance level 调成 1.6 或 1.7，再执行 Clean 重新构建，红色错误通常会消失。
如果报错形式是“Unable to resolve target 'android-XX'”，说明本地 SDK 缺少对应平台。先打开 SDK Manager 看看已经装了哪些 API 版本，如果缺失的版本实在找不到离线包，就把project.properties里的target改成已安装的版本。改 target 有时候会触发代码层面的一些 API 差异，但绝大多数老项目只依赖很基础的系统 API，风险可控。
4.4 模拟器黑屏卡死
模拟器启动后黑屏或者一直卡在启动画面，常见原因有三个：没装 HAXM、AVD 选了 ARM 镜像、RAM 分配太大。排查顺序是：确认 CPU 虚拟化已在 BIOS 开启，确认 HAXM 安装成功，确认 AVD 的 CPU/ABI 选的是 x86 而不是 ARM，然后适当调低 RAM 到 1GB 左右。按这个顺序走，绝大多数模拟器问题都能解决。
实在不行的时候，还有一个笨办法：直接用真机调试。只要 platform-tools 里的 adb 能识别到手机，开启 USB 调试后连接电脑，然后Run As -> Android Application选择真机运行，可以完全绕开模拟器的各种折腾。在维护老项目的场景里，有时候真机比模拟器省心得多。
4.5 和 Tomcat 共存的“找不到主类”问题
很多人手头不只做安卓，还会在同一个 Eclipse 里配置 Tomcat 做 Java Web 开发。这时候偶尔会出现报错“找不到或无法加载主类 org.apache.catalina.startup.Bootstrap”。这个问题的根源往往不是 Tomcat 本身，而是 JDK 配置混乱。
排查思路是在Window -> Preferences -> Server -> Runtime Environments里选中 Tomcat Runtime，点 Edit，确认它关联的是 32 位 JDK 而不是 JRE。如果同时安装了多个 JDK 版本，记得把服务器 Runtime 里关联的 JRE 改成和 Eclipse 一致的 32 位 JDK。这个坑在混用开发环境时比较容易遇到，排查逻辑和 Eclipse 启动失败基本一致：先看位数，再看路径。
5. 从 ADT 到 Android Studio：离线思路的延伸
5.1 用 Android Studio 正确导入 Eclipse 工程
老项目用 ADT 跑通之后，迟早要考虑迁移。Android Studio 打开 Eclipse 工程时，File 菜单里那个Open是直接打开项目目录，但对 Eclipse 工程来说效果并不理想，正确的入口是File -> New -> Import Project，也就是导入向导。
导入向导会自动识别 Eclipse 的项目结构，并生成对应的 Gradle 构建文件。迁移完成后，原本的project.properties、.classpath就不再起作用了，取而代之的是build.gradle。如果导入过程报依赖缺失，多半是 Gradle 版本和插件版本不匹配，需要调整build.gradle里 classpath 的 gradle 插件版本号。
5.2 Gradle 离线包与依赖缓存迁移
老项目迁移到 Android Studio 之后，面临的就是 Gradle 构建的问题。在离线环境里，Android Studio 首次打开工程时会自动去下载对应的 Gradle 发行版，这一步没有网络基本卡死。这里的离线方案和 ADT 离线包的思路一模一样：提前把 Gradle 发行版的 zip 准备好，放到本地的GRADLE_USER_HOME/wrapper/dists目录下，Android Studio 检测到之后就会直接使用。
依赖库的缓存也可以迁移。在联网机器上把工程完整构建一次，所有依赖都会被下载到~/.gradle/caches/modules-2里。构建完成之后，把这个目录整体拷贝到离线机器的对应位置，构建时加上--offline参数，就能实现完全离线的依赖解析。这一点和 ADT 离线包的逻辑很像：提前准备好真实文件，让工具链不再依赖网络。
5.3 这套老环境现在还有多少人需要
说实话，现在还在配 Eclipse ADT 环境的，无非就是老项目维护、老旧教学资源、或者极端的内网环境。如果你手头的老项目能顺利迁移到 Android Studio，我依然建议迁移，因为 Android 新版本的 SDK 工具链对老 Eclipse 的兼容性只会越来越差。但如果你的目标只是“把旧代码跑起来”，那 Eclipse ADT 离线包这套方案，花费最少，见效最快。
我在实际配置过程中最深的体会是：这套环境的难点从来不是某个操作有多难，而是版本组合和位数匹配。只要把这些前置条件理清楚，离线安装其实比在线安装更快、更省心。
最后再分享一个小技巧：环境全部配置好、老项目成功跑起来之后，把整个 Eclipse 安装目录、SDK 目录、JDK 安装包以及 ADT 的 zip，一起打成压缩包放到共享盘里。下次同事需要同样的环境时，直接把这个压缩包拷过去解压，改一下JAVA_HOME，就能完整体验同一个环境，这才是真正意义上的“终极离线包”。
本文还有配套的精品资源，点击获取
