- 准备工作:下载所需的软件。
- 安装 JDK:Java 开发工具包,是所有 Java 相关开发的基础。
- 配置 JDK 环境变量:让系统识别 Java 命令。
- 安装 Eclipse IDE:主要的开发工具。
- 安装 ADT 插件:让 Eclipse 支持安卓开发。
- 配置 SDK:安卓软件开发工具包,包含安卓系统库和开发工具。
- 创建第一个安卓项目:验证环境是否搭建成功。
第 0 步:准备工作(重要提示)
在开始之前,请务必了解:

(图片来源网络,侵删)
- 系统要求:Windows 7/10/11, macOS, 或 Linux。
- JDK 版本:推荐使用 JDK 8,虽然新版 Eclipse 和安卓 SDK 也支持 JDK 11/17,但 JDK 8 是最稳定、兼容性最好的选择,也是许多教程和示例所使用的版本。
- 软件下载地址:
- JDK 8:Oracle JDK 8 下载页面 (需要登录 Oracle 账户)
- Eclipse IDE for Java Developers:Eclipse 官网下载 (选择 "Eclipse IDE for Java Developers")
- 安卓 SDK:不再提供独立下载,需要通过 Eclipse 的 ADT 插件在线安装。
第 1 步:安装 JDK
- 从 Oracle 官网下载与你操作系统匹配的 JDK 8 安装包(
jdk-8u301-windows-x64.exe)。 - 双击安装包,按照向导进行安装。建议不要安装在带有空格或中文的路径下,
C:\Program Files可以,但C:\Program Files (x86)或D:\Program Files\Java都可能引发问题,推荐安装在C:\Java\jdk1.8.0_301这样的简单路径。 - 记住你安装的路径,后面配置环境变量会用到。
C:\Java\jdk1.8.0_301。
第 2 步:配置 JDK 环境变量
这一步至关重要,它允许你在任何目录下使用 Java 命令。
-
右键点击“此电脑”或“我的电脑”,选择“属性” -> “高级系统设置” -> “环境变量”。
-
在“系统变量”区域(不是用户变量)进行以下操作:
- 新建
JAVA_HOME变量:- 变量名:
JAVA_HOME - 变量值:你刚才安装 JDK 的根路径(
C:\Java\jdk1.8.0_301)。
- 变量名:
- 编辑
Path变量:- 在系统变量列表中找到
Path,双击打开。 - 点击“新建”,然后添加
%JAVA_HOME%\bin。 - 确保这一行在最上面,以避免系统找到其他版本的 Java。
- (可选但推荐)再新建一行,添加
%JAVA_HOME%\jre\bin。
- 在系统变量列表中找到
- 新建
-
点击“确定”保存所有设置。
(图片来源网络,侵删) -
验证安装:
- 打开一个新的命令提示符(CMD)窗口(不要用旧的窗口)。
- 输入命令:
java -version - 如果看到类似下面的输出,说明配置成功:
java version "1.8.0_301" Java(TM) SE Runtime Environment (build 1.8.0_301-b09) Java HotSpot(TM) 64-Bit Server VM (build 25.301-b09, mixed mode) - 再输入
javac -version,验证编译器是否可用。
第 3 步:安装 Eclipse IDE
- 从 Eclipse 官网下载
eclipse-java-2025-xx-win32-x86_64.zip(Windows 版)。 - 将下载的压缩包解压到一个合适的、无空格的路径,
D:\dev\eclipse。 - 进入解压后的文件夹,双击
eclipse.exe即可启动 Eclipse。 - 首次启动时,Eclipse 会让你选择一个“工作空间”(Workspace),这是存放你项目代码的地方,可以选择默认路径,或指定一个你喜欢的位置。
第 4 步:安装 ADT 插件
ADT (Android Developer Tools) 是一个 Eclipse 插件,它集成了安卓项目开发、调试、模拟器管理所需的一切工具。
- 启动 Eclipse。
- 点击菜单栏的
Help->Install New Software...。 - 在弹出的窗口中:
- 在 "Work with" 或 "Name" 输入框中,输入 ADT 插件的更新地址:
https://dl-ssl.google.com/android/eclipse/ - 等待片刻,Eclipse 会自动搜索并列出可用的软件。
- 在 "Work with" 或 "Name" 输入框中,输入 ADT 插件的更新地址:
- 在列表中,勾选 "Developer Tools",它包含了所有必需的组件。
- 点击 "Next",然后阅读并接受许可协议,点击 "Finish"。
- Eclipse 会开始下载并安装插件,过程中可能会弹出安全警告,点击 "OK" 或 "Accept" 即可。
- 安装完成后,Eclipse 会提示你重启,点击 "Restart Now"。
第 5 步:配置安卓 SDK
SDK 是安卓开发的基石,包含了安卓系统库、API、模拟器等。
-
重启 Eclipse 后,会自动弹出 "SDK Manager"(如果没弹出,可以通过
Window->Android SDK and AVD Manager打开)。
(图片来源网络,侵删) -
在 "SDK Platforms" 标签页下:
- 勾选你希望支持的安卓版本。至少选择一个最新的版本(用于开发)和一个较旧的稳定版本(用于兼容性测试)。
- 强烈建议勾选 "Android 7.0 (Nougat) - API Level 24" 或更高版本,因为很多新特性需要较新的 API。
- 勾选后,右侧会显示需要安装的包大小,点击 "Apply" 或 "Install" 下载。
-
在 "SDK Tools" 标签页下:
- 勾选 "Android SDK Build-Tools",这是编译你代码所必需的。建议选择最新的版本。
- 勾选 "Android SDK Command-line Tools (latest)" 或 "Android SDK Tools" (旧版),这是核心工具包。
- 勾选 "Android Emulator",用于创建和管理安卓模拟器。
- 勾选 "Intel x86 Emulator Accelerator (HAXM installer)",这能极大地提升模拟器的运行速度(如果你的 CPU 支持 Intel VT-x 技术)。
- 点击 "Apply" 或 "Install" 开始下载和安装。
-
配置 SDK 路径:
- 在 "SDK Manager" 窗口左侧,点击 "SDK Location"。
- 确认 "Android SDK Location" 路径是否正确,Eclipse 通常会自动检测,你也可以手动指定一个路径(
D:\dev\android-sdk)。 - 重要:确保 "NDK location" 为空,因为我们现在不需要配置 NDK(用于 C/C++ 开发)。
第 6 步:创建第一个安卓项目(验证环境)
现在所有环境都已配置好,我们来创建一个 "Hello World" 项目来验证一切是否正常。
- 在 Eclipse 中,点击
File->New->Android Application Project。 - Application Name:给你的应用起个名字,"MyFirstApp"。
- Project Name:Eclipse 会自动填入,与 App Name 一致。
- Package Name:应用的唯一标识,格式通常是
com.example.yourname。com.example.myfirstapp。 - Minimum Required SDK:选择你在 SDK Manager 中安装的最低 API Level。
- Target SDK:选择你安装的最新 API Level。
- Compile With:选择你安装的最新 Build-Tools 版本。
- 点击 "Next",直到最后一步,直接点击 "Finish"。
Eclipse 会开始创建项目并构建,如果一切顺利,项目会成功创建在左侧的 "Package Explorer" 视图中。
第 7 步:运行项目
- 创建安卓模拟器(AVD):
