Eclipse安卓开发环境怎么配置？

虽然目前 Android Studio 已成为 Google 官方推荐的主流 IDE，但 Eclipse + ADT (Android Developer Tools) 曾是安卓开发的黄金组合，至今仍有部分项目或开发者在使用，了解这个经典环境对于理解 Android 开发的历史和一些遗留项目的维护非常有帮助。

环境概述

Eclipse 安卓开发环境主要由以下三个核心部分组成：

1. Java Development Kit (JDK): Android 应用是用 Java (或 Kotlin) 语言编写的，因此需要 JDK 来编译和运行代码。注意： 早期使用 JRE (Java Runtime Environment) 即可，但现在推荐安装完整的 JDK。
2. Eclipse IDE for Java Developers: 这是 Eclipse 的基础版本，我们将在其上安装安卓开发插件。
3. Android Developer Tools (ADT) Plugin: 这是 Eclipse 的核心安卓开发插件，它为 Eclipse 提供了创建、调试、打包 Android 项目所需的所有功能，包括：
   • Android 项目向导
   • 可视化的布局编辑器
   • APK 打包工具
   • 模拟器管理器
   • 设备调试器 (DDM)

详细安装与配置步骤

第一步：安装 JDK

1. 下载: 访问 Oracle 官网或 OpenJDK 官网下载 JDK，对于较旧的 ADT 版本，建议使用 JDK 8 (JDK 1.8) 或 JDK 11，兼容性最好，你可以下载 JDK 8。
   • Oracle JDK 官网: https://www.oracle.com/java/technologies/downloads/
   • OpenJDK 官网: https://jdk.java.net/
2. 安装: 运行下载的安装程序，按照提示进行安装。记住安装路径，C:\Program Files\Java\jdk1.8.0_321。
3. 配置环境变量:
   • 右键“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
   • 在“系统变量”中，新建 JAVA_HOME，变量值为你的 JDK 安装路径。
   • 找到 Path 变量，点击“编辑”，然后新建一个变量，填入 %JAVA_HOME%\bin。
   • 确认所有对话框。
4. 验证: 打开一个新的命令提示符 (CMD)，输入 java -version 和 javac -version，如果都显示出版本号，则安装成功。

第二步：安装 Eclipse IDE

1. 下载: 访问 Eclipse 官网下载 "Eclipse IDE for Java Developers" 版本。
   • 官网: https://www.eclipse.org/downloads/
2. 安装: Eclipse 是一个绿色软件，解压下载的压缩包即可，建议将解压后的文件夹放在一个固定的位置，如 D:\Develop\Eclipse。
3. 启动: 双击 eclipse.exe 运行，首次启动会要求你选择一个工作空间，选择一个合适的文件夹即可。

第三步：安装 ADT 插件

这是最关键的一步,由于 ADT 已被 Google 官方弃用，无法直接通过 Eclipse 的内置更新中心安装，我们需要使用 旧版 Eclipse Marketplace 或手动安装。

使用 Eclipse Marketplace (推荐)

1. 在 Eclipse 菜单栏中，选择 Help -> Eclipse Marketplace...。
2. 在搜索框中输入 "ADT" 或 "Android Developer Tools"。
3. 在搜索结果中找到 "ADT Plugin for Eclipse" 或类似的插件，点击 "Go" -> "Install"。
4. 阅读并接受许可协议,然后点击 "Finish"。
5. Eclipse 会开始下载并安装插件，安装完成后，会提示你重启 Eclipse，选择重启。

手动下载安装 (Marketplace 不可用)

1. 下载 ADT 压缩包: 访问 Google Code 的归档页面（可能需要找第三方镜像，因为官方已下架），下载 ADT 插件的 ZIP 压缩包，下载 adt-23.0.6.zip。
2. 安装插件:
   • 在 Eclipse 菜单栏中，选择 Help -> Install New Software...。
   • 点击 "Add..." 按钮。
   • 在 "Name" 中填入 "ADT"，在 "Location" 中点击 "Archive..."，然后选择你刚刚下载的 ADT ZIP 文件。
   • 点击 "OK"，然后等待 Eclipse 扫描到可用的软件。
   • 勾选 "Developer Tools" 下的所有选项，点击 "Next"，然后按照提示完成安装和重启。

第四步：配置 Android SDK

安装完 ADT 后，Eclipse 会自动引导你配置 Android SDK。

1. 启动 SDK Manager: Eclipse 会自动弹出 "Welcome to Android Development" 窗口，如果没弹出，可以去菜单栏 Window -> Android SDK and AVD Manager。
2. 配置 SDK Location:
   • 在弹出的窗口中,切换到 "SDK Location" 选项卡。
   • 你需要指定一个目录来存放 Android SDK。建议在此目录下创建一个名为 sdk 的文件夹。
   • 点击 "Browse..."，选择你的 SDK 路径（D:\Develop\Android\sdk），然后点击 "Apply"。
   • Eclipse 会自动下载一些必要的工具包。
3. 安装 SDK 包:
   • 切换到 "Packages" 选项卡。
   • 你需要安装至少一个 "SDK Platform" 和 "Android SDK Build-tools"。
   • 推荐安装:
     • SDK Platform: 选择一个你想要开发的 Android 版本，Android 10.0 (API 29) 或 Android 8.0 (API 26)，API 29 是一个比较稳定且兼容性不错的版本。
     • Android SDK Build-tools: 选择最新的版本即可。
     • Intel x86 Emulator Accelerator (HAXM installer): 如果你打算使用模拟器，强烈建议安装这个，可以极大提升模拟器性能。
   • 选中你需要的包,点击右下角的 "Apply" 或 "Install" 按钮，然后同意许可协议开始下载和安装。

第五步：创建和运行第一个 Android 项目

1. 新建项目: File -> New -> Other... -> Android -> Android Application Project。
2. 填写项目信息:
   • Application Name: 你的应用名称，"HelloEclipse"。
   • Project Name: 项目在工程中的名称，可以和 Application Name 一样。
   • Package Name: 应用的唯一标识符，com.example.helloeclipse。
   • Minimum Required SDK: 选择你安装的 SDK Platform 中最低支持的版本。
   • Target SDK: 选择你希望应用的最高目标版本，通常是你安装的最新 SDK Platform。
   • Compile With: 选择你安装的 SDK Platform。
3. 配置活动: 点击 "Next"，直到 "Create Activity" 界面，选择 "BlankActivity"，然后点击 "Finish"。
4. 运行项目:
   • 使用 Android 模拟器
     • 在 Eclipse 菜单栏 Window -> Android Virtual Device (AVD) Manager。
     • 点击 "Create..."，创建一个新的虚拟设备，选择一个你已安装的系统镜像 (System Image)，然后完成创建。
     • 在 Eclipse 工具栏，选择你刚创建的 AVD，然后点击绿色的 "Run" 按钮 (▶)。
   • 连接真机
     • 在手机上开启 "开发者选项" 和 "USB 调试"。
     • 用 USB 线连接手机和电脑，并在手机上允许 USB 调试。
     • 在 Eclipse 工具栏的设备下拉菜单中，选择你的手机。
     • 点击 "Run" 按钮。

常见问题与注意事项

1. SDK Manager 无法下载或速度慢:

   • 原因: Google 服务器在国内访问困难。
   • 解决: 配置国内镜像，在 SDK Manager 的 "Tools" -> "Options..." 中，将 "HTTP/HTTPS Proxy Server" 设置为国内镜像地址，
     • 阿里云镜像: mirrors.aliyun.com
     • 中科大镜像: mirrors.ustc.edu.cn
     • 设置后,回到 "Packages" 刷新即可。

2. 项目报错 "Project '...' is missing required source folder...":

   • 原因: Eclipse 项目结构与新版本 Gradle 或 Android SDK 不兼容。
   • 解决: 右键项目 -> Properties -> Builders，取消勾选 Id Android Pre Compiler，或者，尝试右键项目 -> Clean...。

3. 模拟器启动缓慢或卡顿:

   • 解决: 确保安装了 HAXM (Intel 硬件加速执行管理器)，在 SDK Manager 的 "SDK Tools" 选项卡中可以找到并安装，如果你的 CPU 是 AMD，HAXM 无法使用，可以考虑使用 Genymotion 等第三方模拟器。

4. 为什么现在不推荐使用 Eclipse + ADT?

   • 已停止更新: Google 自 2025 年起已停止对 ADT 的更新和维护，不再支持新的 Android API。
   • 性能和稳定性: Android Studio 基于 IntelliJ IDEA，在代码提示、重构、性能等方面远超 Eclipse。
   • 集成度: Android Studio 深度集成了 Gradle 构建系统、Layout Editor、APK Analyzer 等现代开发工具，体验更佳。
   • 官方支持: 所有新的官方文档、教程和工具都优先为 Android Studio 设计。

虽然 Eclipse + ADT 已经是“过去式”，但通过以上步骤，你依然可以成功搭建一个功能完备的安卓开发环境，对于初学者来说，了解这个过程有助于理解 Android 项目的构成和打包原理，但对于新项目，强烈建议直接学习和使用 Android Studio，它能让你更高效、更愉快地进行安卓开发。