Google 已经官方宣布 Eclipse ADT 插件已于 2025 年停止支持，官方推荐且唯一支持的 Android 开发 IDE 是 Android Studio（基于 IntelliJ IDEA），学习 Eclipse ADT 主要是为了维护旧项目或理解 Android 开发的基础概念。

这份教程将带您完整地走一遍使用 Eclipse 创建、开发、运行和调试一个 "Hello World" 应用的全过程。

目录

1. 环境准备
   • 1 安装 Java Development Kit (JDK)
   • 2 下载并安装 Eclipse IDE for Java Developers
   • 3 下载 Android SDK
   • 4 在 Eclipse 中配置 ADT 插件和 SDK
2. 创建第一个 Android 项目
   • 1 新建 Android Application Project
   • 2 项目结构解析
3. 运行应用
   • 1 创建 Android Virtual Device (AVD - 模拟器)
   • 2 运行项目
4. 修改代码与界面
   • 1 修改字符串资源
   • 2 修改布局文件
   • 3 修改 Java 代码
5. 调试应用
   • 1 设置断点
   • 2 启动调试
6. 后续学习资源

环境准备

1 安装 Java Development Kit (JDK)

Android 应用是用 Java 语言编写的，所以必须先安装 JDK。

1. 下载 JDK: 访问 Oracle 官网 Java SE Development Kit 8 Downloads (推荐使用 JDK 8，因为它与 ADT 的兼容性最好),接受许可协议并下载适合你操作系统的版本。
2. 安装 JDK: 运行下载的安装程序，按照提示完成安装，记住安装路径，C:\Program Files\Java\jdk1.8.0_301。
3. 配置环境变量:
   • 右键点击 "此电脑" -> "属性" -> "高级系统设置" -> "环境变量"。
   • 在 "系统变量" 部分，新建一个变量：
     • 变量名: JAVA_HOME
     • 变量值: 你的 JDK 安装路径 (C:\Program Files\Java\jdk1.8.0_301)
   • 找到 Path 变量，点击 "编辑"，然后新建，添加 %JAVA_HOME%\bin。
   • 点击 "确定" 保存所有设置。
4. 验证安装: 打开命令提示符 (cmd)，输入 java -version，如果显示版本号,则安装成功。

2 下载并安装 Eclipse IDE for Java Developers

Eclipse 是一个开源的集成开发环境。

1. 下载 Eclipse: 访问 Eclipse 官网，下载 "Eclipse IDE for Java Developers" 版本。
2. 解压安装: Eclipse 是免安装的，直接将其解压到你想要的目录即可（D:\eclipse）。
3. 启动 Eclipse: 进入解压后的 eclipse 文件夹，双击 eclipse.exe 启动程序，首次启动会要求选择一个工作空间,选择一个合适的文件夹即可。

3 下载 Android SDK

Android SDK (Software Development Kit) 包含了开发 Android 应用所需的库和工具。

1. 下载 SDK: 访问 Android SDK Archive 页面，找到 "SDK Tools Only" 部分，下载适用于你操作系统的 "SDK Tools for Windows" (或 Mac/Linux) 的 ZIP 包。
2. 解压 SDK: 将下载的 ZIP 包解压到一个固定的、无空格和中文的路径下，D:\android-sdk。

4 在 Eclipse 中配置 ADT 插件和 SDK

这是最关键的一步，将 Eclipse 和 Android SDK 关联起来。

1. 启动 Eclipse。
2. 安装 ADT 插件:
   • 菜单栏选择 Help -> Install New Software...。
   • 在 "Work with" 输入框中，输入 ADT 插件的下载地址：https://dl-ssl.google.com/android/eclipse/。
   • 等待列表加载，勾选 "Developer Tools" (它包含了 ADT 和 Android DDMS)，然后点击 "Next"。
   • 阅读并接受许可协议，点击 "Finish"。
   • Eclipse 会开始下载并安装，安装过程中可能会弹出安全警告，选择 "OK" 或 "Accept" 继续即可，安装完成后，会提示重启 Eclipse，选择 "Restart Now"。
3. 配置 SDK 路径:
   • 重启后，菜单栏选择 Window -> Preferences (在 Mac 上是 Eclipse -> Preferences)。
   • 在左侧导航栏中，找到并展开 Android。
   • 在右侧的 "SDK Location" 字段中，填入你之前解压的 Android SDK 的路径 (D:\android-sdk)。
   • 点击 "Apply" 和 "OK"，Eclipse 会自动在 SDK 路径下寻找可用的 Android 版本，并提示你安装，点击 "Install" 按钮，它会引导你安装最新的 SDK Platform 和工具，这个过程可能需要一些时间，并且需要稳定的网络连接，至少安装一个 API Level (API 30 或 31)。

创建第一个 Android 项目

环境配置完成后,我们来创建一个新项目。

1. 在 Eclipse 菜单栏选择 File -> New -> Other...。
2. 在弹出的窗口中，展开 Android 文件夹，选择 Android Application Project，然后点击 "Next"。
3. 配置项目信息:
   • Application Name: "Hello World" (这是应用在手机上显示的名字)。
   • Project Name: HelloWorld (这是项目在 Eclipse 中的文件夹名)。
   • Package Name: com.example.helloworld (应用的唯一标识符，通常是反向域名格式)。
   • Minimum Required SDK: 选择 API 15 或以上。
   • Target SDK: 选择你刚刚安装的最高 API Level。
   • Compile With: 选择一个 Android 版本。
   • Theme: 选择一个主题，Holo Light with Dark Action Bar。
   • 点击 "Next"。
4. 配置活动 (Activity):
   • Create Activity: 勾选此项。
   • Activity Name: MainActivity (这是应用启动时加载的第一个界面)。
   • Layout Name: activity_main (这个 Activity 对应的布局文件)。
   • 点击 "Next"。
5. 配置图标 (Icon): 你可以自定义应用的图标，或者直接使用默认的，然后点击 "Next"。
6. 创建项目: 在最后一步，点击 "Finish"，Eclipse 会开始创建项目并构建。

2 项目结构解析

创建成功后，你可以在 Eclipse 的 "Package Explorer" 视图中看到项目结构,主要包含以下几个部分：

• src/: 存放 Java 源代码。com.example.helloworld 包下是你的 Java 类。
  • MainActivity.java: 应用的主逻辑。
• res/: 存放资源文件。
  • layout/: 存放 XML 布局文件。activity_main.xml 定义了 MainActivity 的界面。
  • values/: 存放各种配置值。
    • strings.xml: 定义了应用中使用的字符串，如 "Hello World"。
    • colors.xml: 定义颜色。
    • dimens.xml: 定义尺寸。
    • styles.xml: 定义样式。
  • *drawable-/**: 存放图片资源,不同分辨率对应不同文件夹。
  • AndroidManifest.xml: 应用的清单文件，声明了应用的组件、权限、所需 SDK 版本等核心信息。

运行应用

1 创建 Android Virtual Device (AVD - 模拟器)

AVD 是一个在电脑上运行的虚拟 Android 手机。

1. 在 Eclipse 菜单栏选择 Window -> Android Virtual Device Manager。
2. 在弹出的窗口中，点击 "New..." 创建一个新的虚拟设备。
3. 选择设备: 选择一个设备型号，"Pixel 4"。
4. 选择系统镜像:

   在 "Target" 列表下，选择一个你已安装的 Android 版本 (