目录

1. 第一步：准备工作 - 安装 Java Development Kit (JDK)
2. 第二步：下载 Android Studio
3. 第三步：安装 Android Studio 和 SDK
4. 第四步：配置 Android SDK
5. 第五步：创建并运行你的第一个 Android 项目
6. 第六步：配置环境变量 (可选，但推荐)
7. 常见问题与解决方案

核心概念

在开始之前，先简单了解几个关键组件,这有助于你理解安装过程：

• Android Studio: Google 官方推荐的 Android 应用开发集成开发环境，它集成了代码编辑器、调试器、模拟器以及我们需要的 SDK Manager。
• Android SDK (Software Development Kit): Android 软件开发工具包，它包含了开发 Android 应用所需的一切核心工具，比如编译器、调试工具和库文件。
• SDK Platform: 特定 Android 版本（如 Android 13, Android 12）的软件开发平台，它包含了该版本的 API、系统镜像和库，你需要在 SDK Manager 中下载你想要支持的平台的 SDK。
• SDK Tools: 开发 Android 应用所需的工具集，Android SDK Build-Tools（用于构建应用的工具）、Android Emulator（模拟器）、SDK Platform-Tools（包含 adb 等命令行工具）等。

第一步：准备工作 - 安装 Java Development Kit (JDK)

Android 应用是用 Java 或 Kotlin 语言编写的，因此需要 JDK 来编译代码。

对于较新版本的 Android Studio (2025.1 及以后)，它已经内置了 JDK，你不需要单独安装，它会自动使用内置的 JDK，这是最简单、最推荐的方式。

对于旧版本的 Android Studio 或如果你需要特定版本的 JDK,你需要手动安装。

1. 下载 JDK:

   
   （图片来源网络，侵删）
   • 推荐: 访问 Oracle JDK 官网 或 OpenJDK 官网 下载最新的 LTS (长期支持) 版本，JDK 17 或 JDK 21。
   • 对于初学者,下载最新的稳定版本即可。

2. 安装 JDK:

   • 运行下载的安装程序,按照提示完成安装。
   • 记下你的 JDK 安装路径，C:\Program Files\Java\jdk-17,在后续配置环境变量时会用到。

3. 验证安装:

   • 打开命令行工具 (在 Windows 上是 cmd 或 PowerShell，在 macOS/Linux 上是 Terminal)。
   • 输入命令：java -version
   • 如果看到类似下面的输出，说明安装成功：

     openjdk version "17.0.2" 2025-01-18
     OpenJDK Runtime Environment Temurin-17.0.2+8 (build 17.0.2+8)
     OpenJDK 64-Bit Server VM Temurin-17.0.2+8 (build 17.0.2+8, mixed mode, sharing)

第二步：下载 Android Studio

1. 访问 Android Studio 官方下载页面：https://developer.android.com/studio
2. 点击 "Download Android Studio" 按钮。
3. 根据你的操作系统选择对应的安装包（Windows, macOS, Linux）。
4. 下载完成后，你会得到一个安装文件（Windows 上是 .exe，macOS 上是 .dmg，Linux 上是 .zip 或 .tar.gz）。

第三步：安装 Android Studio 和 SDK

Windows

1. 以管理员身份运行下载的 studio.exe 文件。
2. Welcome to Android Studio 界面: 点击 "Next"。
3. Setup Wizard 界面:
   • Android Studio: 勾选所有选项,保持默认即可。
   • Android Virtual Device: 勾选 "Intel HAXM" 或 "Windows Hypervisor Platform"，这能极大地提升模拟器的运行速度，如果你的 CPU 不支持 VT-x/AMD-V,可以暂时不勾选。
   • 点击 "Next"。
4. Configuration 界面:
   • Select Installation Options: 选择 "Standard"（标准）安装，它会自动安装最常用的模拟器、SDK 和性能工具。
   • Choose Start Menu Folder: 保持默认。
   • Installation Locations: 你可以修改安装路径和 SDK 路径，但强烈建议保持默认,除非你明确知道自己在做什么。
   • 点击 "Next"。
5. Installation 界面: 等待安装完成。
6. Installation Complete 界面:
   • 取消勾选 "Start Android Studio automatically"（如果需要），然后点击 "Finish"。
   • 如果提示重启电脑,请重启。

macOS

1. 将下载的 .dmg 文件拖拽到 Applications 文件夹中。
2. 在 Applications 文件夹中找到 Android Studio 并双击打开。
3. 将 Android Studio 图标拖拽到 Applications 文件夹（如果提示输入密码，请输入）。
4. 打开 Launchpad，找到并启动 Android Studio。

Linux

1. 解压下载的 .zip 或 .tar.gz 文件到一个你希望安装的目录，~/Android/Sdk。
2. 进入解压后的 bin 目录。
3. 运行 ./studio.sh 脚本来启动 Android Studio。

第四步：配置 Android SDK

首次启动 Android Studio 时,它会引导你进行初始配置。

1. Welcome 界面: 点击 "More Actions" -> "SDK Manager"。
2. SDK Platforms 标签页:
   • 在左侧面板，展开 "Android [版本号]" ("Android 13 (Tiramisu)")。
   • 勾选你想要开发的 Android 版本对应的 SDK Platform。至少选择一个最新的版本和一个最低兼容版本（Android 8.0 "Oreo" API 26，以覆盖大部分设备）。
   • 右下角会显示你选择的 SDK 将要占用的磁盘空间。
3. SDK Tools 标签页:
   • 勾选 "Show Package Details"（显示详细信息）。
   • Android SDK Build-Tools: 选择一个最新的版本（0.1）,这是构建应用所必需的。
   • Android SDK Command-line Tools (latest): 勾选此项,它提供了命令行工具。
   • Android Emulator: 勾选此项,以便使用模拟器。
   • Android SDK Platform-Tools: 勾选此项，它包含了 adb、fastboot 等重要的命令行工具。
   • 在底部，你可以看到 "SDK Location"。确保这个路径是你期望的路径，默认通常是 C:\Users\<你的用户名>\AppData\Local\Android\Sdk (Windows) 或 ~/Library/Android/sdk (macOS)。
4. 点击 "Apply" 或 "OK"。
5. Android Studio 会开始下载你选择的 SDK 组件，这个过程可能需要一些时间，请耐心等待，下载完成后，点击 "Finish"。

第五步：创建并运行你的第一个 Android 项目

SDK 已经准备就绪,让我们来验证一下。

1. 首次配置完成后，Android Studio 会提示你导入设置或创建一个新项目，选择 "New Project"。
2. 在模板选择界面，选择 "Empty Views Activity"，然后点击 "Next"。
3. Configure your project:
   • Name: 给你的应用起个名字，"MyFirstApp"。
   • Package name: 通常使用反向域名格式，com.example.myfirstapp。
   • Save location: 选择项目保存的位置。
   • Language: 选择 Java 或 Kotlin。
   • Minimum SDK: 选择你在 SDK Manager 中下载的最低 API 级别。
   • 点击 "Finish"。
4. Android Studio 会开始构建项目并同步 Gradle，这个过程可能需要几分钟,请耐心等待。
5. 构建完成后,你会看到一个默认的界面。
6. 运行项目:
   • 在工具栏的设备选择器中，你应该能看到一个名为 "Pixel 6 API 33" (或其他模拟器) 的选项。
   • 点击旁边的绿色 "Run" 按钮（一个三角图标）。
   • Android Studio 会启动模拟器并安装并运行你的应用，如果一切顺利，你会在模拟器中看到一个 "Hello World!" 的文字。

第六步：配置环境变量 (可选，但推荐)

虽然大部分操作都可以在 Android Studio 内部完成，但有时你需要在命令行中使用 adb、sdkmanager 等工具,配置环境变量可以让你在任何目录下直接调用这些命令。

Windows

1. 右键点击 "此电脑" -> "属性" -> "高级系统设置" -> "环境变量"。
2. 在 "系统变量" 部分，找到并选中 Path 变量，点击 "编辑"。
3. 点击 "新建"，然后添加以下路径（请替换为你的实际 SDK 路径）：
   • C:\Users\<你的用户名>\AppData\Local\Android\Sdk\platform-tools
   • C:\Users\<你的用户名>\AppData\Local\Android\Sdk\tools
   • C:\Users\<你的用户名>\AppData\Local\Android\Sdk\tools\bin
4. 点击 "确定" 保存所有更改。
5. 重新打开一个新的命令行窗口，输入 adb version 验证是否成功。

macOS / Linux

1. 打开终端。
2. 编辑你的 shell 配置文件（通常是 ~/.zshrc 或 ~/.bash_profile），如果你使用的是 Zsh (macOS Catalina 及以后默认)，编辑 ~/.zshrc。

   open -e ~/.zshrc

3. 在文件末尾添加以下内容（请替换为你的实际 SDK 路径）：

   export ANDROID_HOME=$HOME/Library/Android/sdk
   export PATH=$PATH:$ANDROID_HOME/tools
   export PATH=$PATH:$ANDROID_HOME/tools/bin
   export PATH=$PATH:$ANDROID_HOME/platform-tools

4. 保存文件并关闭编辑器。
5. 在终端中运行 source ~/.zshrc 使配置生效。
6. 输入 adb version 验证是否成功。

第七步：常见问题与解决方案

1. 问题: Failed to notify listener 或 Gradle sync failed。

   • 原因: 通常是网络问题，导致无法下载 Gradle 依赖。
   • 解决方案:
     • 确保你的网络连接正常。
     • 在 Android Studio 的 "Settings/Preferences" -> "Appearance & Behavior" -> "System Settings" -> "HTTP Proxy" 中，尝试配置一个代理（如果你在中国大陆，可以配置国内镜像源，如阿里云的 Maven 仓库）。
     • 在 gradle-wrapper.properties 文件中，将 distributionUrl 指向一个国内的 Gradle 下载镜像。

2. 问题: 模拟器启动非常慢或报错。

   • 原因: 通常是硬件加速未开启或 CPU 虚拟化技术未在 BIOS 中启用。
   • 解决方案:
     • 确保在安装 Android Studio 时勾选了 "Intel HAXM" 或 "Windows Hypervisor Platform"。
     • 重启电脑，进入 BIOS 设置，开启 "Intel VT-x" 或 "AMD-V" 虚拟化技术。
     • 在 Android Studio 的 "AVD Manager" 中，创建模拟器时，确保 "Hardware - GLES version" 设置为 "OpenGL ES 3.0" 或更高。

3. 问题: 找不到 adb 命令。

   • 原因: 环境变量未配置或配置错误。
   • 解决方案: 仔细检查 第六步 的环境变量配置，确保路径正确,并且已经重新打开了命令行窗口。

4. 问题: "SDK location not found"。

   • 原因: Android Studio 无法找到 SDK 的位置。
   • 解决方案:
     • 在 Android Studio 中，进入 "File" -> "Settings" -> "Appearance & Behavior" -> "System Settings" -> "Android SDK"。
     • 检查 "SDK Location" 是否正确，如果不正确，点击 "Edit" 并选择正确的 SDK 目录。

恭喜！至此，你已经成功安装并配置好了 Android SDK，可以开始你的 Android 开发之旅了！