Android SDK 安装与配置
Android SDK 安装与配置全流程指南
一、前期准备与环境要求
1. 系统兼容性验证
o 操作系统：支持Windows 10/11（64位）、macOS 10.14+、Ubuntu 16.04+等主流系统
o 硬件配置：建议16GB内存+SSD硬盘，模拟器运行需额外预留4GB以上内存
o Java环境：必须安装JDK 8/11/17（推荐Oracle JDK或OpenJDK），需配置JAVA_HOME环境变量
2. 下载路径选择
o 官方推荐方案：通过Android Studio官网（
https://developer.android.com/studio）下载集成版（含SDK）
o 轻量级方案：从AndroidDevTools（
https://www.androiddevtools.cn/）下载独立SDK Tools压缩包（约150MB）
o 镜像站加速：使用中科院/清华等国内镜像源，下载速度提升5-10倍
二、安装流程详解
方案一：通过Android Studio安装（推荐）
1. 安装向导：
o 运行安装包，勾选"Android Virtual Device"组件
o 自定义安装路径（避免C盘空间不足）
o 首次启动时选择"Standard"安装类型
2. SDK组件管理：
o 打开SDK Manager（菜单栏Tools > SDK Manager）
o 必选组件：
o SDK Platforms：安装最新稳定版（如Android 15）
o SDK Tools：勾选Android SDK Build-Tools、NDK、CMake
o Extras：安装Google USB Driver、Intel x86 Emulator Accelerator
方案二：独立SDK Tools安装
1. 解压配置：
【bash】
# Windows示例
tar -xvf android-sdk_r24.4.1-windows.zip -C D:\AndroidSDK
# macOS/Linux示例
unzip android-sdk_r24.4.1-macosx.zip -d ~/AndroidSDK
2. 通过SDK Manager安装组件：
o 运行SDK Manager.exe或tools/android命令
o 取消勾选"Android 1.1"等过时版本
o 勾选"Show Package Details"查看子组件
三、环境变量配置
Windows系统配置
1. 新建系统变量：
o 变量名：ANDROID_HOME
o 变量值：D:\AndroidSDK（根据实际路径修改）
2. 编辑Path变量：
%ANDROID_HOME%\platform-tools
%ANDROID_HOME%\tools
%ANDROID_HOME%\build-tools\34.0.0 # 替换为实际版本号
macOS/Linux配置
1. 编辑shell配置文件：
【bash】
# ~/.bash_profile (macOS) 或 ~/.bashrc (Linux)
export ANDROID_HOME=$HOME/AndroidSDK
export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools:$ANDROID_HOME/build-tools/34.0.0
2. 生效配置：
【bash】
source ~/.bash_profile # 或 source ~/.bashrc
验证配置
【bash】
adb version # 应显示版本信息
android -h # 应显示帮助信息
四、常见问题解决方案
1. 环境变量无效
o 问题表现：adb命令提示"not recognized"
o 解决方案：
o 检查路径是否包含platform-tools而非主目录
o 使用echo %PATH%（Windows）或echo $PATH（macOS/Linux）确认路径生效
o 重启终端或IDE
2. SDK Manager下载失败
o 问题表现：进度条卡在0%或报错"Download interrupted"
o 解决方案：
o 修改SDK Manager代理设置：
Tools > Options > HTTP Proxy Server: mirrors.neusoft.edu.cn
HTTP Proxy Port: 80
o 手动下载组件：从国内镜像站（
https://mirrors.tuna.tsinghua.edu.cn/android/）获取ZIP包，通过SDK Manager的"Install from file"安装
3. AVD启动失败
o 问题表现：模拟器黑屏或报错"emulator: ERROR: x86 emulation currently requires hardware acceleration"
o 解决方案：
o 安装HAXM加速：
SDK Manager > SDK Tools > Intel x86 Emulator Accelerator
o BIOS中启用Intel VT-x/AMD-V虚拟化技术
o 降级使用ARM镜像（启动慢但兼容性好）
4. 构建错误"Command aapt failed with exit code 1"
o 问题表现：Gradle构建时报资源编译错误
o 解决方案：
o 升级Build Tools版本：
android {
buildToolsVersion "34.0.0" # 需与SDK安装版本一致
}
o 清理缓存：
./gradlew cleanBuildCache
五、进阶配置技巧
1. 多版本SDK管理
o 配置多个SDK路径：
【gradle】
// build.gradle示例
android {
compileSdkVersion 34
buildToolsVersion "34.0.0"
// 指定NDK路径（可选）
ndkVersion "25.2.9519653"
}
o 切换SDK版本：
o 通过SDK Manager安装多个API Level
o 在Android Studio的"Project Structure"中修改Project SDK
2. 持续集成环境配置
o Docker镜像示例：
【dockerfile】
FROM ubuntu:22.04
# 安装必要依赖
RUN apt-get update && apt-get install -y \
openjdk-11-jdk \
wget \
unzip \
&& rm -rf /var/lib/apt/lists/*
# 下载SDK Tools
WORKDIR /opt
RUN wget https://dl.google.com/android/repository/commandlinetools-linux-10406996_latest.zip \
&& unzip commandlinetools-linux-*.zip \
&& rm commandlinetools-linux-*.zip \
&& mv cmdline-tools latest
# 配置环境变量
ENV ANDROID_HOME=/opt/android-sdk
ENV PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools
# 接受许可协议（需交互）
RUN mkdir -p $ANDROID_HOME/licenses \
&& echo "d56f5187479451eabf01fb78af6dfcb131a6481e" > $ANDROID_HOME/licenses/android-sdk-license
# 安装必要组件
RUN sdkmanager --update \
&& sdkmanager "platforms;android-34" "build-tools;34.0.0" "platform-tools"
3. 性能优化建议
o 减少模拟器启动时间：
o 使用"Quick Boot"功能（Android Studio 3.0+）
o 分配2-4GB内存给模拟器
o Gradle守护进程：
【gradle】
# gradle.properties配置
org.gradle.daemon=true
org.gradle.parallel=true
org.gradle.jvmargs=-Xmx4096m -XX:MaxPermSize=1024m -XX:+HeapDumpOnOutOfMemoryError -Dfile.encoding=UTF-8
六、维护与更新策略
1. 定期更新机制
o Android Studio更新：
o 通过"Help > Check for Update"获取稳定版
o 测试版可通过Canary Channel（
https://developer.android.com/studio/preview）获取
o SDK组件更新：
o 每月检查"SDK Manager > Updates"
o 保留2-3个历史版本以兼容旧项目
2. 磁盘空间管理
o 清理旧版本：
【bash】
# 删除旧版Build Tools（保留最新2个版本）
rm -rf $ANDROID_HOME/build-tools/29.0.2
# 清理