简介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 Luna4.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.exeEclipse 下载 32 位版本装好后在环境变量里把JAVA_HOME指向 32 位 JDK 的安装目录。这样做的原因除了规避 JNI 报错之外还有一个附加好处老 Android SDK 里不少构建工具在 64 位组合下偶尔会有奇怪问题32 位反而稳。在实际维护老项目的场景里“能跑就行”永远是第一原则。顺便提一个很容易忽略的点Eclipse 解压路径不要带中文和空格最好放在类似D:\dev\eclipse这种纯英文目录。老版 SDK 和 ADT 的本地构建对路径里的特殊字符非常敏感犯不着在这种地方给自己挖坑。2.2 离线包到底要下载哪几样很多人一听到“ADT 离线包”就以为只要下载一个 ADT 的 zip其他什么都不用管这是理解偏差。一个完整可用的离线环境至少需要下面这几样东西名称用途建议版本Eclipse IDE宿主 IDE4.4 Luna SR232 位JDKJava 运行环境32 位 JDK 1.8ADT 插件包离线安装 Eclipse 安卓插件的源ADT-23.0.6.zipAndroid SDK Tools包含 SDK Manager 等基础工具25.2.5 及以下Platform-Toolsadb、fastboot 等调试工具较新版本即可Platformandroid-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 23CPU/ABI 选 x86 并且确保 HAXM 已经装好。RAM 不建议给太大768MB 到 1GB 就够用给 2GB 反而容易启动失败。如果电脑支持虚拟化加速在 AVD 的配置里勾选“Use Host GPU”模拟器启动速度和画面流畅度都会好很多。3.4 拿老项目做一次完整验收环境装好不代表完事最好拿一个真实的老项目跑一遍确认整条链路是通的。导入项目的入口是File - Import - Existing Projects into Workspace选择项目根目录后勾选导入。导入成功之后先看项目根目录的project.properties里面的targetandroid-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就能完整体验同一个环境这才是真正意义上的“终极离线包”。本文还有配套的精品资源点击获取 
长河君 · 2026/9/7 9:56:30 · 阅读 1.2k Eclipse ADT离线安装全攻略：版本匹配与实操详解
简介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 Luna4.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.exeEclipse 下载 32 位版本装好后在环境变量里把JAVA_HOME指向 32 位 JDK 的安装目录。这样做的原因除了规避 JNI 报错之外还有一个附加好处老 Android SDK 里不少构建工具在 64 位组合下偶尔会有奇怪问题32 位反而稳。在实际维护老项目的场景里“能跑就行”永远是第一原则。顺便提一个很容易忽略的点Eclipse 解压路径不要带中文和空格最好放在类似D:\dev\eclipse这种纯英文目录。老版 SDK 和 ADT 的本地构建对路径里的特殊字符非常敏感犯不着在这种地方给自己挖坑。2.2 离线包到底要下载哪几样很多人一听到“ADT 离线包”就以为只要下载一个 ADT 的 zip其他什么都不用管这是理解偏差。一个完整可用的离线环境至少需要下面这几样东西名称用途建议版本Eclipse IDE宿主 IDE4.4 Luna SR232 位JDKJava 运行环境32 位 JDK 1.8ADT 插件包离线安装 Eclipse 安卓插件的源ADT-23.0.6.zipAndroid SDK Tools包含 SDK Manager 等基础工具25.2.5 及以下Platform-Toolsadb、fastboot 等调试工具较新版本即可Platformandroid-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 23CPU/ABI 选 x86 并且确保 HAXM 已经装好。RAM 不建议给太大768MB 到 1GB 就够用给 2GB 反而容易启动失败。如果电脑支持虚拟化加速在 AVD 的配置里勾选“Use Host GPU”模拟器启动速度和画面流畅度都会好很多。3.4 拿老项目做一次完整验收环境装好不代表完事最好拿一个真实的老项目跑一遍确认整条链路是通的。导入项目的入口是File - Import - Existing Projects into Workspace选择项目根目录后勾选导入。导入成功之后先看项目根目录的project.properties里面的targetandroid-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就能完整体验同一个环境这才是真正意义上的“终极离线包”。本文还有配套的精品资源点击获取