Android SDK下载全攻略：从安装到配置的完整指南

2025年11月14日 互联网

Android SDK下载全攻略：从安装到配置的完整指南

Android SDK（Software Development Kit）是开发Android应用的核心工具包，包含命令行工具、模拟器、库文件及API文档等组件。无论是独立开发者还是企业团队，正确下载并配置Android SDK都是启动Android开发项目的第一步。本文将从下载前的环境准备、版本选择、安装步骤到常见问题解决方案，提供一套完整的操作指南。

一、下载前的环境准备

1.1 系统要求

Android SDK支持Windows、macOS和Linux三大主流操作系统，但需满足最低硬件配置：

  • 内存：建议8GB以上（模拟器运行时需额外内存）
  • 存储空间：至少10GB可用空间（SDK文件及模拟器镜像占用较大）
  • 操作系统版本：Windows 10/11 64位、macOS 10.14（Mojave）及以上、Linux（推荐Ubuntu 20.04+）

1.2 依赖工具安装

Android SDK依赖Java开发环境，需提前安装：

  • JDK版本：推荐JDK 11（长期支持版）或JDK 17（最新LTS版）

    • 下载地址：Oracle JDK 或 OpenJDK

    • 配置环境变量：

      1. # Linux/macOS 示例（.bashrc或.zshrc）
      2. export JAVA_HOME=/path/to/jdk
      3. export PATH=$JAVA_HOME/bin:$PATH
      5. # Windows 示例（系统环境变量）
      6. 变量名：JAVA_HOME
      7. 变量值：C:\Program Files\Java\jdk-11.0.15

二、Android SDK下载与安装

2.1 官方下载渠道

Google提供两种下载方式：

  1. Android Studio集成下载（推荐新手）：

    • 下载Android Studio：官方地址
    • 安装时勾选“Android SDK”组件，自动完成下载与路径配置。

  2. 独立命令行工具下载（适合高级用户）：

    • 下载Command Line Tools
    • 解压后通过sdkmanager命令管理组件： 
      1. # 进入tools/bin目录后执行
      2. ./sdkmanager --list  # 查看可用组件
      3. ./sdkmanager "platform-tools" "platforms;android-34"  # 示例：安装平台工具和Android 14 SDK

2.2 版本选择策略

  • 平台版本（Platforms）：根据目标设备选择，例如：
    • 主流设备：Android 13（API 33）、Android 14（API 34）
    • 兼容旧设备：Android 11（API 30）
  • 构建工具（Build-Tools）：与Gradle插件版本匹配，例如：
    • Gradle 8.0+ 对应 Build-Tools 33.0.0+
  • 系统镜像（System Images）：
    • 推荐下载x86_64架构镜像（性能优于ARM）
    • 包含Google Play的镜像用于测试GMS服务

三、配置与验证

3.1 环境变量配置

将SDK路径添加至系统环境变量：

  • 变量名：ANDROID_HOME
  • 变量值：SDK安装目录（如/Users/username/Library/Android/sdk或C:\Users\username\AppData\Local\Android\Sdk）

  • 更新PATH：

    1. # Linux/macOS
    2. export PATH=$ANDROID_HOME/platform-tools:$PATH
    4. # Windows
    5. 变量名：Path
    6. 变量值：%ANDROID_HOME%\platform-tools

3.2 验证安装

  1. 命令行验证： 
    1. adb version  # 应返回Android Debug Bridge版本
    2. sdkmanager --list  # 列出已安装组件
  2. Android Studio验证：
    • 打开“SDK Manager”（File > Settings > Appearance & Behavior > System Settings > Android SDK）
    • 检查“SDK Platforms”和“SDK Tools”标签页中的组件状态

四、常见问题解决方案

4.1 下载速度慢

  • 使用国内镜像源：
    • 修改sdkmanager配置文件（~/.android/repositories.cfg或项目级gradle.properties）： 
      1. # gradle.properties 示例
      2. android.sdk.repo.mirror=https://mirrors.tuna.tsinghua.edu.cn/android/repository/
    • 或通过命令行指定镜像： 
      1. ./sdkmanager --repository_url=https://mirrors.tuna.tsinghua.edu.cn/android/repository/ "platforms;android-34"

4.2 权限问题（Linux/macOS）

  • 若遇到Permission denied错误，赋予执行权限： 
    1. chmod +x sdkmanager  # 对tools/bin下的脚本

4.3 模拟器启动失败

  • 启用硬件加速：
    • Windows：安装HAXM
    • macOS：启用Hypervisor框架（默认已支持）
    • Linux：安装KVM（sudo apt install qemu-kvm libvirt-daemon-system）

五、进阶配置建议

5.1 多版本管理

使用sdkmanager安装多个API版本后，可在gradle.properties中指定：

  1. android.compileSdkVersion=34
  2. android.targetSdkVersion=34
  3. android.minSdkVersion=21

5.2 持续集成（CI）环境配置

  • 在CI配置文件中（如.github/workflows/android.yml）明确指定SDK路径和版本： 
    1. steps:
    2.   - uses: actions/checkout@v3
    3.   - name: Set up JDK
    4.     uses: actions/setup-java@v3
    5.     with:
    6.       java-version: '11'
    7.       distribution: 'temurin'
    8.   - name: Set up Android SDK
    9.     run: |
    10.       echo "ANDROID_HOME=$HOME/android-sdk" >> $GITHUB_ENV
    11.       mkdir -p $ANDROID_HOME/cmdline-tools
    12.       wget https://dl.google.com/android/repository/commandlinetools-linux-9477386_latest.zip -O tools.zip
    13.       unzip tools.zip -d $ANDROID_HOME/cmdline-tools
    14.       mv $ANDROID_HOME/cmdline-tools/cmdline-tools $ANDROID_HOME/cmdline-tools/latest
    15.       yes | $ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager --sdk_root=$ANDROID_HOME "platforms;android-34" "build-tools;34.0.0"

六、总结

正确下载和配置Android SDK是Android开发的基础环节。通过本文的指南，开发者可以：

  1. 根据系统环境选择合适的下载方式
  2. 合理选择SDK组件版本以平衡兼容性与性能
  3. 解决常见的下载、权限和模拟器问题
  4. 掌握多版本管理和CI环境配置技巧

建议开发者定期通过sdkmanager --update检查更新，并关注Android开发者博客获取最新工具链动态。

最新文章