2025AndroidSDK下载安装指南

简介：

本文面向关心硬件质量与系统使用技巧的电脑、手机及数码产品用户，提供一份面向2025年的Android SDK下载安装与配置实操指南。内容覆盖从下载、离线/在线安装到常见故障排查与使用场景（Flutter/Unity/VS Code/CI）、以及与模拟器/真机联调的注意事项，帮助你在Windows、macOS、Linux三大平台快速搭建稳定的Android开发或调试环境。

工具原料：

系统版本：

- Windows 11 22H2/23H2（常见企业与个人用户）

- macOS Sonoma (14.x) / macOS Ventura (13.x)（含Intel与Apple Silicon）

- Ubuntu 24.04 LTS / Fedora 39（开发与CI常用）

品牌型号：

- 笔记本：Dell XPS 15 9520（2023）、Lenovo ThinkPad X1 Carbon Gen 11（2024）、MacBook Pro 14/16 (M2, 2023)

- 手机：Google Pixel 8 / 8 Pro（2023）、Samsung Galaxy S24（2024）、OnePlus 12（2024）

软件版本：

- Android Studio（以2024-2025 年发布的稳定版为准，如 Giraffe/2023.3.x 系列及后续版本）

- OpenJDK 17 或 11（建议采用项目兼容的LTS版本）

- Android SDK Command-line Tools（最新版）、platform-tools（ADB）、build-tools、NDK（按需）

- Flutter 3.10+（如用于Flutter开发）、Unity 2023.4 LTS（用于Unity项目）、VS Code 最新稳定版

一、下载与准备（在线与离线两种路径）

1、在线下载（推荐新手或网络通畅时）：

- 访问 developer.android.com/studio 下载 Android Studio 安装包，安装程序会引导你一并安装 SDK components（platform-tools、SDK Platforms、Android Emulator、Build Tools）。

- 若仅需命令行工具，页面同样提供 Command-line tools（zip/tar.gz），适用于服务器或仅需要 sdkmanager 的场景。

2、离线下载（企业/内网/带宽受限）：

- 在可访问外网的机器上通过 sdkmanager 预先把需要的组件下载到 sdk_root：例如

sdkmanager --sdk_root=/path/to/sdk "platform-tools" "platforms;android-34" "build-tools;34.0.0" "emulator"

- 把整个 SDK 目录打包，复制到目标机器并解压，设置 ANDROID_SDK_ROOT 指向该目录，执行 sdkmanager --licenses 接受授权。

二、安装与系统配置（Windows / macOS / Linux）

1、Android Studio 一键安装：

- 按照安装向导选择 JDK（可使用内置或系统 OpenJDK），勾选 Android SDK、AVD、Android Virtual Device 等组件。

- 完成后打开 SDK Manager 检查需要的 SDK Platforms（如 API 34/35）与 SDK Tools（Platform-tools、NDK、CMake、LLDB、Android Emulator）。

2、命令行手动安装（适用于服务器或自定义目录）：

- 解压 command-line tools 到 ${ANDROID_SDK_ROOT}/cmdline-tools/latest。

- 在 PATH 中加入：${ANDROID_SDK_ROOT}/platform-tools 与 ${ANDROID_SDK_ROOT}/cmdline-tools/latest/bin。

- 运行示例：

sdkmanager --sdk_root=$ANDROID_SDK_ROOT "platform-tools" "platforms;android-34" "build-tools;34.0.0"

sdkmanager --licenses

3、环境变量（建议）：

- Windows（系统环境变量）：设置 ANDROID_SDK_ROOT=C:\Users\<你>\AppData\Local\Android\Sdk，并将 %ANDROID_SDK_ROOT%\platform-tools 加入 PATH。

- macOS / Linux（bash/zsh）：在 ~/.bashrc 或 ~/.zshrc 添加

export ANDROID_SDK_ROOT=~/Library/Android/sdk

export PATH=$PATH:$ANDROID_SDK_ROOT/platform-tools:$ANDROID_SDK_ROOT/cmdline-tools/latest/bin

4、模拟器与加速器：

- Windows：启用 Hyper-V 或安装 Android Emulator Hypervisor Driver（Intel）/WHPX；如使用 WSL2，请按文档启用 WSL2 图形转发与 Hyper-V。

- macOS：Apple Silicon 需使用 ARM (aarch64) 系统镜像并确保 Android Emulator 使用 Apple Hypervisor 框架；Intel mac 使用 Intel HAXM（已较少）。

- 若模拟器慢，建议优先在真机（USB/ADB over TCP）调试或启用硬件加速。

三、使用场景与常见故障（含案例）

1、Flutter/React Native 调试（案例）：

- 场景：在 MacBook Pro M2 上使用 Flutter 开发，需同时支持 iOS 与 Android。

- 步骤要点：安装 Android SDK 并配置 ANDROID_SDK_ROOT，安装 Android SDK Platform 34 与 platform-tools；确保 adb 在 PATH，可用 flutter doctor 检查并修复缺失项。

2、Unity 打包 Android（案例）：

- 场景：Unity 2023.4 项目需要打包 APK/AAB。

- 要点：在 Unity Preferences -> External Tools 指定 SDK、NDK 与 JDK 路径；若使用 gradle 打包失败，检查 Android Gradle Plugin 与 Unity 支持的版本兼容性并更新 build-tools。

3、常见故障与解决：

- “sdkmanager: command not found”：确认 cmdline-tools 已放置于 cmdline-tools/latest 并将 bin 加入 PATH。

- “adb device unauthorized”：在设备上允许 USB 调试并确认授权对话已点击允许；可尝试 adb kill-server / adb start-server。

- 模拟器性能差：启用虚拟化（BIOS/UEFI），检查 Hyper-V/HAXM/Apple Hypervisor 配置，或使用物理设备代替。

- Gradle 下载慢或失败：配置 Gradle 代理或使用国内镜像（注意合法合规），在企业网内配置 HTTP/HTTPS 代理并在 gradle.properties 添加代理。

四、相关背景知识（帮助加深理解）

1、ANDROID_HOME vs ANDROID_SDK_ROOT：ANDROID_HOME 已被逐步弃用，推荐使用 ANDROID_SDK_ROOT 指向 SDK 根目录；部分旧工具仍可能读取 ANDROID_HOME，可两者同时设置以兼容旧项目。

2、SDK