企业官网建设流程全解析

简介：Eclipse ADT 离线安装包面向无法稳定联网、却仍需在 Eclipse 中搭建 Android 开发环境的开发者，尤其适合教学机房、内网办公与旧项目维护场景。包内共 18 个文件，以 15 个 jar 插件为主体，涵盖 ADT 主插件、DDMS 调试监控、NDK、层级查看器与 GL 调试器等组件，另含 site.xml 更新站点描述、xsl 与 css 网页样式文件，压缩包约 12.94MB，解压后即可通过本地归档方式完成安装。已有 1038 人学习下载，说明其在离线部署需求中具备一定参考价值。借助这份资源，读者可省去逐一下载插件的麻烦，直接获得一套版本统一的 ADT 组件，用于创建 Android 项目、可视化编辑 XML 布局、调试应用并管理 SDK，适合希望快速复现经典 Eclipse 开发流程的中级开发者。

1. 老项目还在用 Eclipse ADT，离线包到底怎么装才不翻车

接手一个维护了七八年的安卓老工程，打开开发机发现 Eclipse 里 ADT 插件是空的，SDK 路径也指不到，这时候最省事的做法不是重装整套环境，而是把 ADT 离线包重新装回去。Eclipse ADT 离线安装这件事，本质上就是把 ADT 插件的 zip 包通过本地站点方式喂给 Eclipse 的 p2 安装器，绕开在线更新地址失效、网络受限、版本对不上的问题。它解决的是老项目维护、教学环境复现、内网机器无法访问外部更新源这三类场景。适合谁？手上还压着 Eclipse 工程、需要快速把 ADT 插件补回来的人；如果你已经在用 Android Studio，这篇对你意义不大，但如果你要打开一个只有 Eclipse 工程结构的老仓库，这套流程能让你少折腾半天。下面按「包是什么 → 怎么装 → 坑在哪」的顺序拆开讲。

2. 先搞清 ADT 离线包的结构：p2 站点不是普通压缩包

2.1 ADT 插件的两种分发形态

ADT 插件在历史上主要有两种分发方式。一种是早期的dropins目录投放，把解压后的plugins、features直接丢进 Eclipse 安装目录下的dropins文件夹，重启生效；另一种是 p2 更新站点形态，也就是一个包含content.jar、artifacts.jar、features/、plugins/的目录结构，通过 Eclipse 的 Install New Software 指向本地路径或本地 HTTP 服务来安装。现在能拿到的所谓「ADT 离线包」，绝大多数是第二种，也就是一个完整的 p2 仓库目录，而不是单个 jar。

这个区别很关键。很多人拿到离线包后直接解压到dropins，结果 Eclipse 启动报错或者插件列表里根本看不到 ADT，就是因为包的结构是 p2 站点，不是 dropins 布局。判断方法很简单：看解压后的根目录有没有content.jar和artifacts.jar，有就是 p2 站点，没有再看有没有plugins和features两个并列目录，那才是 dropins 布局。

2.2 版本匹配：Eclipse 主版本和 ADT 版本要对得上

ADT 插件对 Eclipse 主版本有硬性依赖。ADT 23.x 之后的版本基本要求 Eclipse 4.4（Luna）及以上，更早的 ADT 22.x 可以跑在 Eclipse 3.7/4.2 上。离线包里通常会带一个site.xml或者content.jar里记录的org.eclipse.equinox.p2元数据，安装时 Eclipse 会校验依赖的org.eclipse.wst、org.eclipse.jdt等基础插件版本。版本不匹配的典型表现是安装向导里勾选 ADT 后点下一步，报「Cannot complete the install because one or more required items could not be found」，下面列一堆缺失的org.eclipse.*包。

我一般会先确认两件事：当前 Eclipse 的版本号（Help → About Eclipse 里能看到，形如 4.4.2），以及离线包目录里features/下 ADT feature 的版本号（目录名类似com.android.ide.eclipse.adt_23.0.4.xxx）。两者对不上就别硬装，换一个匹配的离线包比改依赖省事得多。

2.3 离线包目录的完整性检查

一个可用的 ADT p2 离线包，解压后至少要有这些内容：

拿到包先解压，用文件管理器确认这几个路径都在。如果只有plugins和features而没有content.jar，那它可能是 dropins 包，走 2.1 里说的投放方式，不要拿去当更新站点用。

3. 本地站点安装全流程：从解压到验证 ADT 生效

3.1 解压离线包并确定站点路径

先把离线包解压到一个不含中文和空格的路径，比如D:\adt-offline\adt-bundle-site。路径里带空格或中文，Eclipse 的 p2 安装器在解析本地 URI 时容易出问题，这是血泪经验。解压后确认根目录下有content.jar和artifacts.jar，这个目录就是后面要指向的「本地站点」。

如果团队里多台机器要装，可以把整个目录放到一个内网共享路径或者用本地 HTTP 服务托管，Eclipse 对http://和file:两种协议都支持。单机安装直接用file:路径最省事。

3.2 在 Eclipse 里添加本地更新站点

打开 Eclipse，走菜单 Help → Install New Software，点右上角的 Add 按钮，弹窗里 Name 随便填（比如ADT Local），Location 点 Archive 或者直接填本地路径。这里有个细节：如果填的是目录路径，要用file:/D:/adt-offline/adt-bundle-site/这种带斜杠的 URI 形式，Windows 下反斜杠要转成正斜杠。填完点 OK，下面的列表会加载出可安装项。

如果列表为空或者报错，先检查路径末尾有没有多余的斜杠、路径里有没有中文。另一个常见原因是 Eclipse 的 p2 缓存坏了，可以删掉 Eclipse 安装目录下p2/org.eclipse.equinox.p2.core/cache再重试。

3.3 勾选 ADT 并处理依赖

列表里会出现类似Developer Tools的条目，展开后勾选Android Development Tools。如果同时出现Android DDMS、Android Hierarchy Viewer等子项，一并勾选。点 Next 后，安装向导会做依赖解析，这一步最容易卡住。

依赖解析失败时，向导底部会给出缺失项列表。常见缺失是org.eclipse.wst.xml.core或org.eclipse.jdt.core版本不够。处理办法有两个：一是换一个和当前 Eclipse 版本匹配的 ADT 离线包；二是如果缺失的是 Eclipse 基础组件，从对应 Eclipse 版本的官方更新站点补装。不要试图手动改content.jar里的版本约束，改坏了整个站点都识别不了。

3.4 安装后重启并验证

安装完成后 Eclipse 会提示重启。重启后验证 ADT 是否生效，看三个地方：Window → Preferences 里是否出现Android节点；工具栏是否出现 Android SDK Manager 和 AVD Manager 图标；新建项目向导里是否有Android Application Project。三处都出现才算装好。

如果 Preferences 里有 Android 节点但 SDK 路径为空，说明插件装上了但 SDK 没配，需要在 Android 节点里把 SDK Location 指向本地的 Android SDK 目录。这一步和插件安装是两回事，别混在一起排查。

# 检查离线包目录结构是否完整（Linux/macOS 下） cd /path/to/adt-offline-site ls -1 content.jar artifacts.jar features plugins 2>/dev/null # 输出应包含 content.jar、artifacts.jar、features、plugins 四项 # 缺任何一项都说明包不完整或解压方式不对

上面这段命令用来在安装前做一次结构自检，2>/dev/null把不存在的文件报错吞掉，只输出实际存在的项。四项齐全再往下走，缺项就回到 2.3 的表格对照，确认是包的问题还是解压的问题。

4. 避坑与排查：ADT 离线安装最常见的五个翻车点

4.1 现象：安装向导里根本看不到 ADT 条目

原因通常是 Location 指向的目录不是 p2 站点根目录，而是它的上一级或者plugins子目录。p2 安装器只认包含content.jar的那一层。解决：把 Location 精确指到content.jar所在目录，用file:/前缀加正斜杠路径重试。

4.2 现象：勾选后 Next 报依赖缺失，列出一串 org.eclipse 包

原因是 ADT 版本和 Eclipse 主版本不匹配，或者当前 Eclipse 是精简版（比如某些打包版删掉了 WST 组件）。解决：先确认 Eclipse 版本，换匹配的 ADT 离线包；如果确认版本匹配仍缺 WST，从同版本 Eclipse 的更新站点补装org.eclipse.wst相关组件后再装 ADT。

4.3 现象：安装进度条走完，重启后 Preferences 里没有 Android 节点

原因是安装过程中 p2 把插件写进了p2/仓库但没激活，或者安装时勾选的条目不全（只勾了 DDMS 没勾 ADT 主插件）。解决：重新走 Install New Software，在「Already installed」里检查 ADT 是否真的在列；不在就重装并确认勾选的是Android Development Tools主项。

4.4 现象：Eclipse 启动变慢或启动时报插件冲突

原因是之前用 dropins 方式投放过旧版 ADT，和 p2 安装的新版共存了。解决：清空 Eclipse 安装目录下dropins里的 ADT 相关目录，只保留 p2 安装的这一份，重启后让 p2 重新解析。

4.5 现象：ADT 装好了，但新建 Android 项目报 SDK 相关错误

原因不是插件问题，是 SDK 路径没配或者 SDK 版本太新。ADT 对高版本 SDK 的 build-tools 支持有限，常见做法是把 SDK Location 指到一个包含较老 platform 的 SDK 目录，并在项目的project.properties里把target设成已安装的 platform 版本。解决：先在 Android SDK Manager 里确认目标 platform 已下载，再在项目属性里对齐。

提示：每次装完 ADT 先别急着建项目，先在 Preferences 里把 SDK 路径配好、在 SDK Manager 里确认至少一个 platform 和对应 build-tools 存在，能省掉后面一半的报错。

5. 进阶技巧：把离线安装做成可复用的本地站点服务

单机装一次不算本事，团队里多台机器反复装才是常态。我一般会把 ADT 离线包目录放到一台内网机器的静态文件服务下，Eclipse 的 Location 直接填http://内网地址/adt-site/，这样所有机器指向同一个站点，版本统一，也不用每台机器拷贝几个 G 的包。静态服务用任意能托管目录的工具都行，关键是保证content.jar、artifacts.jar、features/、plugins/在 URL 根路径下可直接访问。

# 用 Python 自带的 http.server 在内网机器上托管离线站点（仅内网使用） cd /path/to/adt-offline-site python3 -m http.server 8080 --bind 0.0.0.0 # 浏览器访问 http://<内网IP>:8080/content.jar 能下载即说明站点可用 # Eclipse 里 Location 填 http://<内网IP>:8080/

这段命令起一个最简静态服务，--bind 0.0.0.0让内网其他机器能访问，端口按需改。验证方法是先在浏览器里直接访问content.jar，能下载说明路径对；再在 Eclipse 里填站点地址。注意这个服务只适合内网临时用，不要暴露到公网。

另一个值得养成的习惯是：装完后把 Eclipse 的p2/目录和configuration/目录一起备份一份。老项目环境最怕的就是某次误操作把插件仓库搞坏，有备份就能直接还原，不用重新走一遍依赖解析。我吃过一次亏，装完 ADT 后又装了个不兼容的插件，p2 仓库直接解析失败，最后是靠备份的p2/目录恢复的。从那以后我每次给老环境装完插件，都强制把p2/和configuration/打包留一份，再动别的。希望这套流程能帮到你，少在版本和路径上耗时间。

本文还有配套的精品资源，点击获取