Eclipse安卓开发教程如何快速上手？

重要声明：Eclipse ADT 已被官方弃用

在开始之前,请务必了解：Google 已于2025年停止了对 Eclipse Android Developer Tools (ADT) 的支持，官方推荐且唯一长期受支持的安卓集成开发环境是 Android Studio（基于 IntelliJ IDEA）。

为什么你还会找到 Eclipse 教程？

• 历史项目维护：一些老项目可能仍使用 Eclipse 开发。
• 个人偏好：少数开发者习惯 Eclipse 的界面和工作流。
• 学习目的：理解 ADT 的工作原理有助于理解安卓开发的基本概念。

本教程的目标读者：

• 需要维护旧 Eclipse 安卓项目的开发者。
• 出于学习或怀旧目的,希望体验早期安卓开发环境的初学者。

强烈建议：如果你是初学者，或者计划开始新的安卓项目，请直接跳转到 Android Studio 教程，本教程将不再更新，且会遇到各种兼容性问题。

第一部分：环境搭建

这是最关键的一步,请严格按照步骤操作。

所需软件准备

你需要下载以下四样东西：

1. Java Development Kit (JDK)

   • 官方下载地址：Oracle JDK 下载页面
   • 版本选择：建议使用 JDK 8 (JDK 1.8)，因为它与 Eclipse ADT 的兼容性最好、最稳定，新版本可能存在兼容性问题。
   • 下载并安装,记住安装路径（C:\Program Files\Java\jdk1.8.0_301）。

2. Eclipse IDE for Java Developers

   • 官方下载地址：Eclipse 官方下载
   • 版本选择：下载 "Eclipse IDE for Java Developers"。
   • 下载后解压到你想要的目录（D:\eclipse），无需安装。

3. Android SDK (Software Development Kit)

   
   （图片来源网络，侵删）
   • 官方下载地址：Android SDK 官方下载
   • 注意：现在不提供单独的 SDK 安装包了，你需要下载一个较小的 "Command line tools only" 包，然后用它来安装完整的 SDK。
   • 下载后解压到一个固定目录（D:\android-sdk）。

4. Eclipse ADT 插件

   • 这是一个 Eclipse 插件，用于在 Eclipse 中集成安卓开发功能。
   • 你将在 Eclipse 内部通过它的“软件更新”功能来安装。

环境变量配置

为了让系统命令行能找到 JDK 和 SDK 的工具，需要配置环境变量。

1. 打开“系统属性”：右键“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
2. 新建 JAVA_HOME：
   • 变量名：JAVA_HOME
   • 变量值：你的 JDK 安装路径（C:\Program Files\Java\jdk1.8.0_301）。
3. 编辑 Path 变量：
   • 在 Path 变量中，新建两条记录：
     • %JAVA_HOME%\bin
     • 你的 SDK 的 tools 和 platform-tools 目录路径（D:\android-sdk\tools 和 D:\android-sdk\platform-tools）。
4. 验证配置：
   • 重新打开一个新的命令提示符。
   • 输入 java -version，应显示 JDK 版本信息。
   • 输入 adb version，应显示 ADB 版本信息。
   • 如果都显示正常,说明配置成功。

在 Eclipse 中安装 ADT 插件

1. 启动 Eclipse：双击 eclipse.exe 启动，首次启动会让你选择一个工作空间（Workspace），选择一个你喜欢的文件夹即可。
2. 安装插件：
   • 点击菜单栏的 Help -> Install New Software...。
   • 在 "Work with" 或 "Name" 的输入框中，输入 ADT 插件的更新地址：https://dl-ssl.google.com/android/eclipse/。
   • 等待片刻,Eclipse 会扫描可用的软件，你会看到一个名为 "Developer Tools" 的条目，勾选它。
   • 点击 "Next"，然后同意许可协议，完成安装，安装过程中可能会提示你重启 Eclipse，重启即可。

配置 Android SDK

1. 打开 SDK 管理器：
   • 点击菜单栏的 Window -> Preferences (在 macOS 上是 Eclipse -> Preferences)。
   • 在弹出的窗口中,导航到 Android -> SDK Location。
2. 设置 SDK 路径：
   • 在 "SDK Location" 字段中，填入你之前解压的 Android SDK 的路径（D:\android-sdk）。
   • 点击 "Apply"，Eclipse 会自动扫描并发现 SDK。
3. 安装 SDK 组件：
   • 现在点击菜单栏的 Window -> Android SDK Manager。
   • 在 "SDK Platforms" 标签页中，至少勾选一个版本，对于初学者，建议选择最新的稳定版（如 Android 13.0 Tiramisu）和一个较旧的稳定版（如 Android 10.0 Q）以保证兼容性。
   • 在 "SDK Tools" 标签页中，确保以下选项被勾选：
     • Android SDK Build-Tools (选择一个最新的版本)
     • Android SDK Command-line Tools (latest)
     • Android SDK Platform-Tools
     • Android Emulator
   • 点击 "Apply" 或 "Install"，等待下载和安装完成。

至此，开发环境全部搭建完毕！

第二部分：创建第一个安卓应用

创建新项目

1. 点击菜单栏的 File -> New -> Other...。
2. 在弹出的窗口中,展开 Android 文件夹，选择 Android Application Project，然后点击 "Next"。
3. 配置项目：
   • Application Name: 你的应用名称，"My First App"。
   • Project Name: Eclipse 中的项目名称，可以和 Application Name 一样。
   • Package Name: 应用的唯一标识符，格式通常是 com.公司名.应用名。com.example.myfirstapp。
   • Minimum Required SDK: 选择你安装的 SDK 中的最低版本。
   • Target SDK: 选择你安装的 SDK 中的目标版本。
   • Compile With: 选择一个 Android 版本。
   • Theme: 选择应用的界面主题，选择默认的 "Theme.Holo.Light" 即可。
4. 点击 "Next"，直到最后一步，点击 "Finish"。

Eclipse 会自动为你生成项目结构，包括 src (源代码)、res (资源文件) 和 AndroidManifest.xml (应用清单)。

编写 "Hello, World!" 代码

我们将修改默认的 MainActivity，让它在屏幕上显示 "Hello, Eclipse ADT!"。

1. 展开项目结构：在左侧的 "Package Explorer" 视图中，展开你的项目。
2. 找到并打开 MainActivity.java：路径通常是 项目名/src/你的包名/MainActivity.java。
3. 修改代码：将 onCreate 方法中的代码替换如下：

package com.example.myfirstapp; // 确保包名正确
import android.os.Bundle;
import android.app.Activity;
import android.widget.TextView;
public class MainActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 创建一个TextView组件
        TextView textView = new TextView(this);
        textView.setText("Hello, Eclipse ADT!");
        // 将TextView设置为Activity的内容视图
        setContentView(textView);
    }
}

运行应用

有两种方式运行：在模拟器上或连接的真机上。

使用安卓模拟器

1. 创建 AVD (Android Virtual Device)：
   • 点击菜单栏的 Window -> AVD Manager。
   • 点击 "Create Virtual Device..."。
   • 选择一个手机设备型号（如 Pixel 4），然后点击 "Next"。
   • 选择一个系统镜像（System Image），如果没有，点击 "Download"，选择你之前在 SDK Manager 中安装的版本并下载。
   • 完成下载后,选择该镜像，点击 "Next"，"Finish"。
2. 启动模拟器：在 AVD 列表中，点击你创建的 AVD 右侧的绿色三角形 "Start" 按钮，等待模拟器启动（这需要几分钟）。
3. 运行项目：
   • 在 Eclipse 中，右键点击你的项目。
   • 选择 Run As -> Android Application。
   • Eclipse 会自动将应用部署到模拟器并启动，如果一切顺利，你会在模拟器上看到 "Hello, Eclipse ADT!" 的字样。

使用真机

1. 开启开发者选项和 USB 调试：
   • 在你的安卓手机上,进入 设置 -> 关于手机。
   • 连续点击 版本号 或 内部版本号 7次左右，直到提示“您已处于开发者模式”。
   • 返回 设置，找到 系统 -> 开发者选项。
   • 打开 USB 调试 开关。
2. 连接手机：用 USB 数据线将手机连接到电脑，首次连接时，手机上会弹出“允许 USB 调试”的对话框，请勾选“始终允许”并点击“确定”。
3. 运行项目：
   • 在 Eclipse 中，右键点击你的项目。
   • 选择 Run As -> Android Application。
   • 应用将被安装到你的手机上并自动启动。

第三部分：项目结构和常用操作

• src/: 存放 Java 源代码。
• res/: 存放所有资源文件。
  • layout/: 存放界面布局文件（.xml）。
  • drawable-.../: 存放图片资源。
  • values/: 存放字符串、颜色、样式等配置（strings.xml, colors.xml 等）。
• AndroidManifest.xml: 应用的“身份证”，声明了应用的组件、权限、所需 SDK 版本等信息。
• gen/: 由 Eclipse 自动生成，存放 R.java 文件，这个文件是资源的索引，不要手动修改它。

常用操作：使用布局编辑器

1. 打开布局文件：在 res/layout/ 目录下，打开 activity_main.xml。
2. 切换视图：编辑器下方有 "Graphical Layout"（图形化布局）和 "activity_main.xml"（代码视图）两个标签，你可以自由切换。
3. 拖拽组件：在 "Graphical Layout" 视图中，左侧的 "Palette" 窗口里有各种 UI 组件（如 Button, TextView, EditText），你可以直接拖拽到中间的预览区域。
4. 修改属性：选中一个组件后，右侧的 "Properties" 窗口会显示它的所有属性，你可以在这里修改 ID、文本大小、背景颜色等。

总结与后续学习

恭喜你！你已经成功使用 Eclipse 创建并运行了第一个安卓应用。

接下来可以学习什么？

1. UI 交互：在 activity_main.xml 中添加一个按钮，然后在 MainActivity.java 中为它添加点击事件监听器，实现点击按钮后改变文本内容的功能。
2. 使用 Intent：学习如何使用 Intent 在不同的 Activity 之间跳转。
3. 数据存储：学习如何使用 SharedPreferences 存储简单的键值对数据。

再次强调,虽然本教程让你成功入门，但请尽快转向 Android Studio，它提供了更快的构建速度、更强大的代码分析、一个现代化的界面以及所有最新的开发工具和库支持，是安卓开发的未来。