01 环境搭建与第一个项目

安卓开发目前官方推荐的 IDE 是 Android Studio（简称 AS）。我们使用 Java 语言开发，配合 AS 内置的构建系统 Gradle。

1.1 安装 JDK

Java 是编译安卓代码的基础。AS 新版通常自带 JBR（JetBrains Runtime），如果你只是用 AS 开发，一般不用单独装 JDK；但如果命令行需要 java/javac，可以装一套：

• 推荐 JDK 17（兼容 AGP 8.x / 新版 AS）
• 下载：Oracle JDK 或开源的 Eclipse Temurin（https://adoptium.net）
• 装完在终端验证：

java -version

能看到版本号即成功。

1.2 安装 Android Studio

1. 到官网 https://developer.android.com/studio 下载对应系统的安装包（Windows/macOS/Linux）。
2. 安装完成后首次启动会进入 Setup Wizard，按提示安装：
3. Android SDK
4. SDK Platform（勾选最新稳定版，如 Android 14/15）
5. 平台工具 platform-tools（含 adb）
6. 模拟器系统镜像（可选，建议装一个，比如 Pixel 机型镜像）

国内网络下载 SDK 可能慢，可在 AS 设置里配置镜像源，或使用代理。SDK 管理器路径：Settings → Languages & Frameworks → Android SDK。

1.3 创建第一个项目

1. 启动 AS，点击 New Project。
2. 左侧模板选 Phone and Tablet → Empty Views Activity（注意选 Views，不是 Compose——本教程用传统 XML + Java）。
3. 配置项目：
4. Name：应用名，如 MyFirstApp
5. Package name：包名，如 com.example.myfirstapp（唯一标识，后文打包签名要用）
6. Language：选 Java
7. Minimum SDK：建议选 API 24（Android 7.0）左右，覆盖面广
8. 点 Finish，等待 Gradle 首次同步（会下载依赖，耐心等）。

1.4 认识三个关键文件

创建完成后，左侧 Project 面板（Android 视图）重点看三个文件：

文件	作用
MainActivity.java	代码入口：显示哪个界面、按钮点了干什么
activity_main.xml	界面长什么样：放什么控件、什么布局
AndroidManifest.xml	应用清单：声明有哪些 Activity、应用图标名字等

1.5 跑起来

AS 顶部工具栏有设备下拉框，两种方式运行：

1. 真机：手机开启「开发者选项 → USB 调试」，插上数据线，设备列表选中你的手机；
2. 模拟器：点设备下拉框 → Device Manager → 创建一个虚拟设备并启动。

然后点绿色 ▶ Run，等待构建，App 就会装到设备上启动。

看到屏幕出现 Hello World! 或类似文字，恭喜，你的第一个安卓 App 跑起来了！🎉

1.6 真机调试小提示

• 首次连接真机，手机会弹「允许 USB 调试吗」，勾选始终允许；
• Windows 可能需要装手机厂商的 USB 驱动；
• 无线调试（Android 11+）：adb pair + adb connect，可以摆脱数据线。

---

本章练习：创建项目并在真机/模拟器跑起来，改一下 activity_main.xml 里的文字，重新运行看变化。