简介这份Eclipse ADT离线安装包专为无法顺畅联网或需要在本地离线搭建Android开发环境的开发者准备解决Eclipse中无法通过在线软件源安装ADT插件的痛点。包体共18个文件以jar插件为主占15个另含site.xml、site.xsl与site.css等元数据与样式文件总体积约12.94MB涵盖ADT主插件、DDMS调试监控、NDK支持、Traceview性能分析、HierarchyViewer界面层级查看等核心组件安装后可拥有完整的Android开发工具链。目前已有1035人学习下载适合正在配置EclipseADT开发环境、希望快速离线装好插件并规避在线下载失败或版本冲突问题的开发者。通过本地site.xml可让Eclipse识别插件及依赖关系无需网络即可完成安装并顺带获得Android SDK Manager集成、可视化布局编辑等常用能力显著提升开发效率。 很多人一开始搜“Eclipse ADT 离线包”“Eclipse安装ADT”的时候一定都是抱着同一个疑问Android开发不是早就不流行用Eclipse了吗为什么还要装这个老掉牙的插件说实话就在上一周我还在一台工控机上帮人调试一套2015年部署的Android设备测试环境打开Eclipse、加载老项目、启动模拟器整套流程跑下来我才意识到一个事实ADT这套工具链远没有“过气”它仍然活在大量老项目、实验室、内网开发环境和特定行业的自动化测试系统里。ADTAndroid Developer Tools是Google当年为Eclipse打造的官方Android插件后来Android Studio成了正统ADT停更多年官方在线更新地址也基本等于废了。所以现在想装ADT走传统的Help - Install New Software在线安装大多数人是装不动的——要么卡在获取软件源列表要么装到一半网络断了这也是网上“Eclipse安装插件特别慢”“Eclipse打不开无反应”这类热词常年出现的原因。离线包安装反而是这个时代最靠谱、最可复现的路径。这篇文章我会把完整的离线安装思路、版本搭配、离线包验证、实操步骤和排查经验都写出来适合四类人看被分配去维护老项目的开发者、照着旧教材学Android的初学者、离线机房里的实验环境搭建者以及单纯想把一台老机器恢复成可用开发机的技术爱好者。1. 为什么现在的在线安装教程基本都失效了1.1 在线安装ADT卡死根因不在网络很多教程还在教你在Eclipse里填https://dl-ssl.google.com/android/eclipse/这个软件源地址然后点安装。这个方法放在2013年没问题但现在你照着操作大概率会卡在获取依赖的那一步鼠标转圈半天最后弹一个超时或者空指针异常。根因有两层。第一层ADT已经停止更新Google的更新站点虽然还在但年代久远的p2仓库数据在现代Eclipse版本上解析特别容易出问题第二层安装过程默认勾选了“Contact all update sites during install to find required software”它会在安装时去触达一堆外部站点任何一个源响应慢整个安装就会卡死。所以不是你的网不行是这套老工具和新的安装机制已经脱节了。1.2 离线包的意义把安装变成一件确定的事离线安装的原理很简单把ADT插件的p2仓库整个下载到本地安装时Eclipse直接从本地加载不需要访问任何外部网络。相当于把“去多个地方采购零件”变成了“仓库里点对点调货”只要你的包是完整的安装过程就是确定的、可重复的。我自己的体会是离线包方式特别适合内网机器和重要项目环境你不需要担心哪天某个镜像站失效了也不用担心公司防火墙把更新站点拦了。机器A装好了把离线包留着机器B、机器C再用同一个包装版本完全一致环境永远可控。1.3 现在还守在ADT老环境里的都是什么人有人可能觉得都2024年了还在谈Eclipse ADT是不是太古董了。但你如果接触过传统制造业、校企共建实验室或者老APP的存量维护项目就会发现ADT老环境依然在跑。原因无非这三个存量项目用的是Ant构建脚本和旧版Android SDK迁移到Android Studio要动整个构建链成本远大于收益一些实验指导书、竞赛文档配图全是Eclipse ADT截图学生照着做才不容易卡壳自动化测试环境大多与外界隔离ADT装一次能稳定跑很多年没人愿意去动它。所以这个离线安装技能不是考古是实打实的生产力工具。2. 版本三角关系JDK、Eclipse、ADT怎么搭配才不翻车2.1 别拿最新版Eclipse去硬配老ADT很多人上来就装最新版Eclipse然后发现ADT要么装不上要么装上后Preferences里压根找不到Android选项。原因在于ADT是个2014年前后停更的插件它依赖的SWT/JFace接口在新版Eclipse里已经变了老代码调不到新接口自然会出现各种幺蛾子。我踩过不少坑之后建议直接照抄下面这套稳定组合别在版本上花式冒险组件推荐版本说明JDK1.864位ADT构建工具链依赖Java 8的编译行为Eclipse4.4.2 LunaEclipse IDE for Java DevelopersMars/Neon也能装但部分面板兼容性差ADT插件23.0.6历史上最稳、用的人最多的版本Android SDKPlatform API 19~21老模拟器和真机调试最均衡的选择2.2 确认你手上的Eclipse能不能用已经在电脑上装了Eclipse的人先打开 Help - About Eclipse IDE 看版本号。如果版本号高于4.6Neon我建议还是换回4.4.2再折腾省得后面冒出莫名其妙的面板问题。另外注意位数64位机器必须配64位Eclipse和64位JDK32位混着用会在启动模拟器或者加载原生调试工具时踩到意想不到的坑。查看Eclipse位数的方法是Help - About Eclipse IDE - Installation Details - Configuration搜索eclipse.arch显示x86_64就是64位版。或者更简单去Eclipse安装目录看一眼启动图标的文件名通常x86_64后缀会体现在安装目录名里。2.3 为什么我推荐Eclipse IDE for Java Developers而不是ClassicADT大量依赖Eclipse的JDTJava开发工具组件如果用的是精简版Eclipse安装时可能提示缺少某些前置依赖。Eclipse IDE for Java Developers这个发行版自带完整的JDT跟ADT的契合度最好基本能避免一半的依赖报错。同理不要用那些定制过的国产IDE改版标准官方包最省事。3. 离线包从哪里来怎么检查它没坏3.1 先看清你拿到的“离线包”到底是哪一种网上流传的ADT离线包其实分两种形态很多人混为一谈第一种是adt-bundle整包形如adt-bundle-windows-x86_64-20140702.zip解压后里面直接是一个带了ADT插件的Eclipse和一个基础SDK相当于官方当年帮你打包好的完整开发环境。这种包不用安装解压就能跑最省心。第二种是单纯的ADT插件p2仓库压缩包解压后会看到features和plugins两个目录features下应该有com.android.ide.eclipse.adt.feature_23.0.6.*.jar这样的文件。这种包用于在已有Eclipse上走Help - Install New Software离线安装。判断标准很简单解压后如果看到的是Eclipse的启动程序那就是整包如果看到的是features/plugins结构那就是插件包。本篇文章第4节的安装步骤针对第二种但如果你拿到了第一种直接跳到第6节配SDK就行。3.2 离线包的完整性和真实性检查老环境的搭建最怕半路发现包是坏的。拿到插件包后先不要急着一个Add就往上装花两分钟做个检查。打开命令行对zip包做一次完整测试比如Windows上用tar -tf adt.zip | more快速瞄一眼目录结构或者用7-Zip的“测试”功能。Linux/Mac下可以直接unzip -t adt.zip | tail -5看到No errors detected in compressed data of adt.zip就可以放心用。同时留意文件体积ADT 23.0.6的插件包解压前大概在80~120MB之间明显几十MB还号称ADT完整包的多半是阉割版装到一半大概率报找不到模块的错。3.3 还有一条更省事的路径直接拷贝整个Eclipse目录如果你手头刚好有一台已经装好ADT、环境正常的老开发机最靠谱的“离线包”其实是那台机器上的整个Eclipse安装目录。直接压缩拷走拿到新机器上解压再把JDK配好环境就迁移成功了。这招在团队里比下载插件zip还实用我通常会在项目组里维护一个“标准基线环境”压缩包新同事入职直接解压省掉所有安装环节。4. 离线安装的完整操作链路4.1 安装前的三个准备工作第一确认JAVA_HOME指向JDK 1.8并且java -version能正常输出第二Eclipse解压路径和后面要建的Workspace路径都别用中文老插件在这类路径下有时会出现编码错乱第三关闭杀毒软件的文件实时防护这一步容易被忽略ADT写插件文件到Eclipse目录时杀软一拦安装进度会卡在百分之十几动不了。4.2 Add Local这一步的具体操作一切就绪后打开Eclipse按下面步骤走菜单栏 Help - Install New Software点击右上角 Add 按钮在弹出的窗口里Name随便填一个比如ADT Offline点击 Local... 按钮定位到你准备好的ADT插件zip包选中后确定此时中央列表区会出现 Developer Tools 和 Android Development Tools两个条目把Android Development Tools勾上除非你需要嵌套在开发者工具里的其他组件否则不用全选。然后也是最关键的一步把窗口下方的 “Contact all update sites during install to find required software” 前面的勾去掉。这行字的意思是安装时额外访问在线源查找依赖离线安装场景下必须关掉否则又会重蹈在线安装卡死的覆辙。4.3 安装过程和重启后的验证确认后点 NextEclipse会开始解析本地仓库可能需要一分钟左右。接下来会进入Install Details界面继续Next同意许可协议然后就是安装进度条。进度条走完Eclipse会提示重启重启时可能会弹一个关于未签名内容的安全警告放心点OK。重启回来之后验证装没装成看两个地方Window - Preferences左侧应该出现“Android”节点点开能看到Android Preferences面板Help - About Eclipse IDE主面板下方应该有一个Android小机器人图标和“Android Development Tools”的版本信息。这两个都看到了插件本体就安装成功了。4.4 我发现很多人都会漏掉配置SDK这一环插件装好了还不代表能建项目因为你还没告诉Eclipse你的Android SDK在哪。Window - Preferences - Android - SDK Location把Android SDK目录填进去Apply后再回来点时面板里才能正常显示API Level列表。如果SDK路径留空你会发现就算新建Android项目一编译就报“SDK location not found”之类的错。这个问题在搜索热词里常年有人问其实不是ADT没装好就是SDK路径没配对。SDK目录最好选不带空格的纯英文路径方便后边模拟器启动。5. 安装失败的五个典型症状和排查路径5.1 症状一Add Local后报“No repository found at ...”这个提示看起来像找不到文件其实多数是包结构不对。把zip解压出来确认最外层是不是直接包含features/plugins两个目录。有些下载到的包解压后里面套了一层文件夹那么Add Local的时候要选择那层文件夹而不是顶层的zip文件。如果解压后连features/plugins都没有那你就别拿它当插件包装了当普通文件拷到一个固定的SDK目录反而还能用。5.2 症状二安装到一半报错或者进度条卡住不动卡住先别乱点等五分钟有时候是老机器解压p2仓库确实慢。超过五分钟没动静排查方向有两个一是杀毒软件拦截了文件写入临时关掉实时防护再重试二是Eclipse自身堆内存不够打开eclipse.ini把-Xmx改成1024m以上再重启安装。如果是安装中途弹“An error occurred while collecting items to be installed”通常意味着你的Eclipse发行版缺了部分依赖换回Eclipse IDE for Java Developers标准包问题基本能绕开。5.3 症状三重启后Preferences里没有Android先别急着重装打开 Help - About Eclipse IDE - Installation Details - Installed Software看列表里有没有Android Development Tools。有的话说明插件装上了面板不显示大概率是SDK Location没配对没有的话八成是Eclipse版本太新ADT的老接口不兼容。还有一种情况是机器上装了多个Eclipse你Add Local时用的A重启时却打开了B。别笑我见过好几次尤其是桌面放了多个快捷方式的场景。5.4 症状四新建Android项目时直接报空指针或卡在构建插件和SDK都在但项目创建还是失败。这时候要查SDK目录下的platforms和build-tools版本。ADT 23.0.6对Android 6.0API 23及以上的平台支持很差如果SDK Manager里不知道什么时候装了API 23以上的包建议把高版本的platforms和build-tools卸掉留下API 19~21就够用。老环境的原则是“不求新只求稳”你不需要用老IDE去编译新系统跑通存量工程才是第一优先。5.5 症状五模拟器起不来或者启动后黑屏模拟器问题有一半是HAXM没装或没启用。ADT时代的模拟器启动依赖Intel硬件加速BIOS里没开VT-x或者HAXM版本跟CPU不匹配模拟器要么直接报错要么慢到没法用。确认BIOS虚拟化开启后去SDK的extras/intel目录下跑一遍HAXM安装程序。黑屏问题可以在模拟器启动配置里把GPU模式改成swiftshader_indirect老显卡驱动对老版模拟器兼容差纯软件渲染反而更稳。6. 装完不是结束SDK关联、AVD创建和环境收尾6.1 把SDK路径和项目环境一次配到位ADT装完Window - Android SDK Manager里能看到当前SDK已安装的组件。强烈建议把项目实际用到的platform版本勾选好比如老项目是API 19就确认platforms/android-19存在同时补一个build-tools 23.0.1这样不挑版本的构建工具。SDK Manager在新版本里已经被命令行工具取代但ADT自带的图形化SDK Manager还能用不用另外搞定新版sdkmanager。6.2 创建AVD的几个关键设置AVDAndroid Virtual Device创建时Device选Nexus 5或者自定义屏幕尺寸都行关键是Target要选你本机SDK里已经安装的API Level别选没装的否则模拟器会要求先下载系统镜像而老镜像源现在几乎连不上。CPU/ABI选Intel Atom (x86)前提是HAXM正常工作如果这台机器CPU不支持VT-x那就选ARM armeabi-v7a镜像慢是慢点但能跑。6.3 把环境固化成团队资产环境装好后我个人强烈建议做一件事把整个Eclipse目录、Android SDK目录、Workspace目录分别打成压缩包存到内网共享或移动硬盘里标注好JDK版本和ADT版本。这样以后任何一台新机器要恢复环境先解压再装JDK最后改eclipse.ini里的路径十分钟搞定不用再从零走一遍安装流程。还有个更细的小技巧Eclipse的workspace里保存了项目级的.classpath和.project文件备份时别漏掉那些是Eclipse识别Android工程的关键标识。很多人迁移环境后双击项目发现只是个普通目录就是因为只拷了源码忘了拷这两个隐藏配置。老环境的搭建是一锤子买卖但搭完之后它可能会陪你好几年所以前期的版本选择和验证步骤千万别省。等你在某台老机器上把整套环境跑通了再回头看这个过程会发现离线安装ADT并没有多难难的只是第一步敢不敢去碰这些“过时”的配置。本文还有配套的精品资源点击获取