Android SDK 安装与配置（android sdk installed）

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

# 清理