新手必看：Android SDK安装与配置教程 – wiki基地

作者： /

新手必看：Android SDK安装与配置教程

对于任何想要进入Android应用开发领域的新手来说，第一步也是最关键的一步，就是正确安装和配置Android SDK（Software Development Kit）。Android SDK包含了开发Android应用所需的所有工具、库文件和模拟器，是Android开发环境的核心。本教程将带你一步步完成SDK的安装与配置。

1. 准备工作

在开始安装之前，请确保你的系统满足以下基本要求：

  • 操作系统： Windows (64-bit), macOS (64-bit), 或 Linux (64-bit)。
  • 内存： 推荐 8 GB RAM 或更高，最低 4 GB。
  • 存储空间： 至少 8 GB 可用磁盘空间（用于IDE和Android SDK组件），推荐 16 GB 或更多。
  • Java Development Kit (JDK)： Android Studio（下文将介绍）内置了JDK，但如果你需要独立安装或使用特定版本，请确保已安装最新版本的JDK 8或更高版本。你可以在Oracle官网或OpenJDK项目下载。

2. 下载并安装 Android Studio

Android Studio是Google官方推荐的Android应用开发集成开发环境（IDE）。它集成了Android SDK，是安装和管理SDK最简单、最推荐的方式。

  1. 访问官方网站： 打开浏览器，访问 Android Studio官方下载页面。
  2. 下载安装包： 点击页面上的“Download Android Studio”按钮。在下载之前，你需要阅读并同意相关的条款和条件。

  3. 运行安装程序：

    • Windows： 双击下载的 .exe 文件。按照安装向导的指示进行操作。在选择安装组件时，通常保持默认选项（包括“Android SDK”和“Android Virtual Device”）即可。
    • macOS： 双击下载的 .dmg 文件。将 Android Studio 图标拖拽到 Applications 文件夹中。
    • Linux： 解压下载的 .zip 文件到你选择的安装位置（例如 ~/android-studio），然后导航到 android-studio/bin 目录，运行 studio.sh 脚本启动。

  4. 首次启动配置：

    • 首次启动 Android Studio 时，它会引导你完成一系列的设置向导。
    • 导入设置： 如果你之前安装过，可以选择导入旧设置；如果是全新安装，选择“Do not import settings”。
    • 安装类型： 选择“Standard”（标准安装）通常是最佳选择，它会自动安装推荐的SDK组件和配置。
    • UI 主题： 选择你喜欢的主题（Darkcula 或 Light）。
    • SDK 组件下载： Android Studio 会检查并下载所需的 Android SDK Platform 和其他必要的组件。这可能需要一些时间，取决于你的网络速度。确保你的计算机连接到互联网。

3. 配置 Android SDK 路径 (如果需要)

通常情况下，通过 Android Studio 安装 SDK 后，IDE 会自动检测并配置好 SDK 路径，无需手动设置。但如果你遇到问题，或者需要为其他IDE（如VS Code）配置环境变量，你可以按照以下步骤找到并设置SDK路径。

查找 Android SDK 路径：

  1. 打开 Android Studio。
  2. 在欢迎界面，点击右下角的“Configure” -> “SDK Manager”。
    或者，如果已打开项目，可以在菜单栏选择“File” -> “Settings” (Windows/Linux) 或 “Android Studio” -> “Preferences” (macOS)。在弹出的窗口中，搜索“Android SDK”。
  3. 在“Android SDK Location”一栏，你将看到 Android SDK 的安装路径。
    • Windows 默认路径： C:\Users\YourUserName\AppData\Local\Android\Sdk
    • macOS 默认路径： ~/Library/Android/sdk
    • Linux 默认路径： ~/Android/Sdk

设置环境变量 (Windows 示例):

  1. 复制你的 Android SDK 路径。
  2. 右键点击“此电脑”或“我的电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
  3. 在“系统变量”下，点击“新建”：
    • 变量名：ANDROID_HOME
    • 变量值：[你的Android SDK路径] (例如 C:\Users\YourUserName\AppData\Local\Android\Sdk)
  4. 在“系统变量”中找到 Path 变量，选中后点击“编辑”。
  5. 点击“新建”，添加以下三条路径：
    • %ANDROID_HOME%\platform-tools
    • %ANDROID_HOME%\cmdline-tools\latest\bin (如果 latest 不存在，可能需要根据你安装的命令行工具版本调整，或者直接使用 tools 或 build-tools 目录下的相应工具)
    • %ANDROID_HOME%\emulator
  6. 点击“确定”保存所有更改。

设置环境变量 (macOS/Linux 示例):

  1. 打开终端。
  2. 编辑你的 shell 配置文件，例如 ~/.bash_profile, ~/.zshrc, 或 ~/.profile。
    例如，使用 nano ~/.zshrc。

  3. 在文件末尾添加以下行，将 YOUR_ANDROID_SDK_PATH 替换为你的实际路径：

    bash
    export ANDROID_HOME=$HOME/Library/Android/sdk # macOS 示例，Linux 可能为 ~/Android/Sdk
    export PATH=$PATH:$ANDROID_HOME/platform-tools
    export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin # 根据实际情况调整
    export PATH=$PATH:$ANDROID_HOME/emulator

  4. 保存文件并退出编辑器。

  5. 在终端中执行 source ~/.zshrc (或你编辑的文件名) 使环境变量生效。

4. 使用 SDK Manager 管理 SDK 组件

Android SDK Manager 是管理不同 Android 平台版本和开发工具的中心。

  1. 打开 SDK Manager： 在 Android Studio 中，如前所述，通过“File” -> “Settings” (或“Preferences”) -> “Android SDK” 打开。
  2. SDK Platforms (SDK 平台):
    • 这里列出了所有可用的 Android 平台版本（例如 Android 14.0 “Upside Down Cake”, Android 13.0 “Tiramisu”）。
    • 通常，你应该至少安装你目标设备的最新稳定版本，以及一些你想要支持的旧版本。
    • 勾选你想要安装或更新的平台版本，然后点击“Apply”。
  3. SDK Tools (SDK 工具):
    • 这个标签页包含了各种开发工具，如：
      • Android SDK Build-Tools： 构建Android应用所必需的工具。
      • Android SDK Platform-Tools： 包含 adb (Android Debug Bridge)、fastboot 等关键工具。
      • Android Emulator： 运行 Android 虚拟设备（AVD）的模拟器。
      • Android SDK Command-line Tools： 用于命令行操作 SDK 的工具。
      • Google Play Licensing Library / Google USB Driver (Windows)： 如果你需要。
    • 务必勾选并安装最新版本的“Android SDK Build-Tools”、“Android SDK Platform-Tools”、“Android Emulator”和“Android SDK Command-line Tools”。
    • 点击“Apply”安装或更新选定的工具。

5. 验证安装

完成上述步骤后，你可以通过以下方式验证 Android SDK 是否正确安装和配置：

  1. 重启终端/命令行工具： 确保新的环境变量生效。
  2. 检查 adb 命令： 在终端或命令提示符中输入 adb --version。
    如果看到 Android Debug Bridge version ... 的输出，说明 platform-tools 配置成功。
  3. 创建并运行一个简单的 Android 项目：
    • 在 Android Studio 中，点击“Start a new Android Studio project”。
    • 选择一个“Empty Activity”模板，然后点击“Next”。
    • 填写应用名称、包名，选择保存位置和最低 SDK 版本，然后点击“Finish”。
    • 项目创建完成后，点击工具栏上的“Run ‘app’”按钮（绿色的播放图标）。
    • 如果你还没有创建 AVD (Android Virtual Device)，Android Studio 会提示你创建一个。按照向导创建一个模拟器。
    • 选择你创建的 AVD 并运行。如果应用成功在模拟器上启动并显示“Hello World!”，那么你的 Android SDK 环境就配置成功了！

常见问题与故障排除

  • 下载缓慢或失败： 检查你的网络连接。在中国大陆地区，有时可能需要配置代理或使用镜像源来加速下载。
  • 模拟器无法启动： 确保你的计算机支持并启用了硬件虚拟化（Intel VT-x 或 AMD-V）。这通常需要在电脑的 BIOS/UEFI 设置中开启。
  • JDK 错误： 确保你的 Java 环境是正确的。Android Studio 默认使用内置 JDK，通常不需要手动干预。
  • 环境变量不生效： 确保你正确保存了环境变量文件，并在终端中执行了 source 命令 (Linux/macOS) 或重启了命令行窗口 (Windows)。

通过以上详细步骤，你应该已经成功安装并配置了 Android SDK，为你的 Android 应用开发之旅打下了坚实的基础。祝你开发愉快！

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部