手动下载Android SDK全攻略：从入门到实践的完整指南

一、为何需要手动下载Android SDK？

在Android开发中，通过Android Studio等IDE自动下载SDK是常见方式，但在以下场景中，手动下载成为必要选择：

1. 网络环境受限：企业内网或防火墙严格的开发环境无法直接访问Google服务器。
2. 版本定制需求：需要特定版本的SDK（如旧版兼容性测试或新版本预览版）。
3. 离线开发场景：无网络连接的物理机或虚拟机环境需提前配置SDK。
4. 资源控制：团队统一管理SDK版本，避免因自动更新导致的兼容性问题。

手动下载的核心价值在于可控性——开发者可精确选择SDK组件、版本及存储路径，同时避免依赖IDE的自动更新机制。

二、手动下载前的环境准备

1. 系统要求

• 操作系统：Windows（7+）、macOS（10.12+）或Linux（Ubuntu 18.04+）。
• 存储空间：至少20GB可用空间（SDK及模拟器占用）。
• Java环境：需安装JDK 8或更高版本（推荐OpenJDK或Oracle JDK）。

2. 工具准备

• 解压工具：7-Zip（Windows）、The Unarchiver（macOS）或unzip命令（Linux）。
• 命令行工具：熟悉cd、ls、tar等基础命令（Linux/macOS）或PowerShell（Windows）。

三、手动下载Android SDK的详细步骤

步骤1：获取SDK下载链接

Google官方提供SDK工具及平台组件的独立下载包，需通过以下渠道获取：

• 官方文档页面：访问Android SDK下载页面，选择“Command line tools only”下载基础工具包。
• 镜像站点：国内开发者可通过清华TUNA镜像或阿里云镜像下载（需确认镜像同步时间）。
• 历史版本库：Google Archive提供旧版SDK下载（需科学上网或企业内网镜像）。

步骤2：下载SDK工具包

以命令行工具包为例：

1. 访问下载页面，选择对应操作系统的压缩包（如commandlinetools-win-9477386_latest.zip）。
2. 使用wget或浏览器下载至本地：

   wget https://dl.google.com/android/repository/commandlinetools-linux-9477386_latest.zip

步骤3：解压并配置SDK目录

1. 创建SDK根目录（如/opt/android/sdk或C:\Android\sdk）。
2. 解压工具包至指定目录：

   unzip commandlinetools-linux-9477386_latest.zip -d /opt/android/sdk/cmdline-tools

3. 确保目录结构为sdk/cmdline-tools/latest/bin（latest为版本别名）。

步骤4：配置环境变量

在~/.bashrc（Linux）或系统环境变量（Windows）中添加：

export ANDROID_SDK_ROOT=/opt/android/sdk
export PATH=$PATH:$ANDROID_SDK_ROOT/cmdline-tools/latest/bin

验证配置：

sdkmanager --list

四、安装平台组件与模拟器

1. 通过sdkmanager安装组件

使用sdkmanager命令安装平台工具、构建工具及系统镜像：

sdkmanager "platform-tools" "platforms;android-34" "emulator" "system-images;android-34;default;x86_64"

• platform-tools：包含ADB、Fastboot等工具。
• platforms：指定Android版本的API库。
• system-images：模拟器所需的系统镜像。

2. 创建AVD模拟器

1. 使用avdmanager创建模拟器：

   avdmanager create avd -n Pixel_6_API_34 -k "system-images;android-34;default;x86_64" --device "pixel_6"

2. 启动模拟器：

   emulator -avd Pixel_6_API_34

五、验证SDK安装

1. 检查ADB：

   adb devices

   应显示List of devices attached及模拟器或真机信息。
2. 编译测试项目：
   使用gradlew构建简单项目，确认无依赖错误。
3. 运行模拟器：
   启动模拟器后访问设置，确认Android版本与安装的platforms一致。

六、常见问题与解决方案

问题1：sdkmanager报错“Unable to resolve dependency”

• 原因：未配置代理或镜像源。
• 解决方案：
  1. 在~/.android/repositories.cfg中添加镜像：

     ### User Sources for Android Repository
     cnt=1
     url1=https://mirrors.tuna.tsinghua.edu.cn/android/repository/

  2. 或通过命令行指定：

     sdkmanager --repository_url=https://mirrors.tuna.tsinghua.edu.cn/android/repository/ "platforms;android-34"

问题2：模拟器启动黑屏

• 原因：HAXM/KVM未安装或版本不兼容。
• 解决方案：
  • Windows：安装Intel HAXM驱动（需支持VT-x的CPU）。
  • Linux：启用KVM加速：

    sudo apt install qemu-kvm libvirt-daemon-system libvirt-clients bridge-utils
    sudo usermod -aG kvm $USER

七、最佳实践建议

1. 版本管理：使用sdkmanager --uninstall清理旧版本，避免目录混乱。
2. 自动化脚本：编写Shell脚本批量下载组件（示例）：

   #!/bin/bash
   SDK_ROOT=/opt/android/sdk
   COMPONENTS=("platform-tools" "platforms;android-34" "emulator")
   for comp in "${COMPONENTS[@]}"; do
     $SDK_ROOT/cmdline-tools/latest/bin/sdkmanager "$comp"
   done

3. 离线备份：定期备份sdk目录至NAS或版本控制系统。

八、总结

手动下载Android SDK虽比IDE自动安装复杂，但提供了更高的灵活性与控制力。通过本文的步骤，开发者可完成从环境准备到模拟器运行的完整流程，尤其适合企业级开发或特殊网络环境。掌握手动下载技能后，可进一步探索NDK、CMake等高级工具的集成，为复杂Android项目奠定基础。