Android SDK 安装与配置

大家好，欢迎来到IT知识分享网。

Android SDK 安装与配置全流程指南

一、前期准备与环境要求

1. 系统兼容性验证

• 操作系统：支持Windows 10/11（64位）、macOS 10.14+、Ubuntu 16.04+等主流系统

• 硬件配置：建议16GB内存+SSD硬盘，模拟器运行需额外预留4GB以上内存

• Java环境：必须安装JDK 8/11/17（推荐Oracle JDK或OpenJDK），需配置JAVA_HOME环境变量

2. 下载路径选择

• 官方推荐方案：通过Android Studio官网（
https://developer.android.com/studio）下载集成版（含SDK）

• 轻量级方案：从AndroidDevTools（
https://www.androiddevtools.cn/）下载独立SDK Tools压缩包（约150MB）

• 镜像站加速：使用中科院/清华等国内镜像源，下载速度提升5-10倍

二、安装流程详解

方案一：通过Android Studio安装（推荐）

1. 安装向导：

• 运行安装包，勾选”Android Virtual Device”组件

• 自定义安装路径（避免C盘空间不足）

• 首次启动时选择”Standard”安装类型

2. SDK组件管理：

• 打开SDK Manager（菜单栏Tools > SDK Manager）

• 必选组件：

• SDK Platforms：安装最新稳定版（如Android 15）

• SDK Tools：勾选Android SDK Build-Tools、NDK、CMake

• 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安装组件：

• 运行SDK Manager.exe或tools/android命令

• 取消勾选”Android 1.1″等过时版本

• 勾选”Show Package Details”查看子组件

三、环境变量配置

Windows系统配置

1. 新建系统变量：

• 变量名：ANDROID_HOME

• 变量值：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. 环境变量无效

• 问题表现：adb命令提示”not recognized”

• 解决方案：

• 检查路径是否包含platform-tools而非主目录

• 使用echo %PATH%（Windows）或echo $PATH（macOS/Linux）确认路径生效

• 重启终端或IDE

2. SDK Manager下载失败

• 问题表现：进度条卡在0%或报错”Download interrupted”

• 解决方案：

• 修改SDK Manager代理设置：

Tools > Options > HTTP Proxy Server: mirrors.neusoft.edu.cn

HTTP Proxy Port: 80

• 手动下载组件：从国内镜像站（
https://mirrors.tuna.tsinghua.edu.cn/android/）获取ZIP包，通过SDK Manager的”Install from file”安装

3. AVD启动失败

• 问题表现：模拟器黑屏或报错”emulator: ERROR: x86 emulation currently requires hardware acceleration”

• 解决方案：

• 安装HAXM加速：

SDK Manager > SDK Tools > Intel x86 Emulator Accelerator

• BIOS中启用Intel VT-x/AMD-V虚拟化技术

• 降级使用ARM镜像（启动慢但兼容性好）

4. 构建错误”Command aapt failed with exit code 1″

• 问题表现：Gradle构建时报资源编译错误

• 解决方案：

• 升级Build Tools版本：

android {

buildToolsVersion “34.0.0” # 需与SDK安装版本一致

}

• 清理缓存：

./gradlew cleanBuildCache

五、进阶配置技巧

1. 多版本SDK管理

• 配置多个SDK路径：

【gradle】

// build.gradle示例

android {

compileSdkVersion 34

buildToolsVersion “34.0.0”

// 指定NDK路径（可选）

ndkVersion “25.2.”

}

• 切换SDK版本：

• 通过SDK Manager安装多个API Level

• 在Android Studio的”Project Structure”中修改Project SDK

2. 持续集成环境配置

• 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-_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 “d56feabf01fb78af6dfcb131a6481e” > $ANDROID_HOME/licenses/android-sdk-license

# 安装必要组件

RUN sdkmanager –update \

&& sdkmanager “platforms;android-34” “build-tools;34.0.0” “platform-tools”

3. 性能优化建议

• 减少模拟器启动时间：

• 使用”Quick Boot”功能（Android Studio 3.0+）

• 分配2-4GB内存给模拟器

• 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. 定期更新机制

• Android Studio更新：

• 通过”Help > Check for Update”获取稳定版

• 测试版可通过Canary Channel（
https://developer.android.com/studio/preview）获取

• SDK组件更新：

• 每月检查”SDK Manager > Updates”

• 保留2-3个历史版本以兼容旧项目

2. 磁盘空间管理

• 清理旧版本：

【bash】

# 删除旧版Build Tools（保留最新2个版本）

rm -rf $ANDROID_HOME/build-tools/29.0.2

# 清理