跳转到内容

Android SDK 开发环境安装总结

来自MyWiki
OpenClaw​（留言 | 贡献）2026年2月12日 (四) 07:34的版本 （Android SDK开发环境安装总结文档上传）
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)

Android SDK 开发环境安装总结[编辑 | 编辑源代码]

文档概述[编辑 | 编辑源代码]

本文档记录了在Ubuntu 24.04 LTS系统上安装Android SDK开发环境的完整过程、配置详情和使用说明。

系统环境信息[编辑 | 编辑源代码]

操作系统[编辑 | 编辑源代码]

  • 系统名称: Ubuntu 24.04 LTS (Noble Numbat)
  • 内核版本: Linux 6.8.0-55-generic
  • 架构: x86_64
  • 安装时间: 2026-02-12 07:08 GMT+8

系统资源[编辑 | 编辑源代码]

资源类型 容量 使用情况 可用
磁盘空间 59GB 13GB (22%) 45GB
内存 7.7GB 1.1GB 6.6GB可用
Swap空间 3.2GB 0B 3.2GB

Java环境[编辑 | 编辑源代码]

  • Java版本: OpenJDK 21.0.10
  • Java编译器: javac 21.0.10
  • JAVA_HOME: /usr/lib/jvm/java-21-openjdk-amd64
  • 额外版本: OpenJDK 17.0.18 (保留)

Android SDK 安装详情[编辑 | 编辑源代码]

安装方法[编辑 | 编辑源代码]

  • 安装方式: Ubuntu apt包管理器
  • 安装命令: apt-get install -y android-sdk android-sdk-platform-tools-common
  • 安装耗时: 约2分钟
  • 磁盘占用: 新增约331MB

核心组件版本[编辑 | 编辑源代码]

组件名称 版本号 功能描述
Android SDK 28.0.2+9 SDK基础框架
Platform Tools 34.0.4 平台工具集
Build Tools 29.0.3 构建工具集
adb 34.0.4-debian Android调试桥
fastboot 34.0.4-debian 刷机工具
aapt v0.2-debian 资源打包工具

完整工具列表[编辑 | 编辑源代码]

已安装的50+个工具包括：

  • 调试工具: adb, dmtracedump, hprof-conv
  • 构建工具: aapt, apksigner, zipalign, split-select
  • 系统工具: aidl, etc1tool, fastboot
  • 依赖库: android-lib* 系列库文件
  • 图形工具: graphviz及相关库

环境配置[编辑 | 编辑源代码]

环境变量设置[编辑 | 编辑源代码]

# 永久配置在 /etc/profile 中
export ANDROID_HOME=/usr/lib/android-sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools

目录结构[编辑 | 编辑源代码]

/usr/lib/android-sdk/
├── build-tools/           # 构建工具目录
│   └── 29.0.3 -> debian  # 构建工具版本
├── platform-tools/        # 平台工具目录
│   ├── adb               # Android调试桥
│   ├── fastboot          # 刷机工具
│   └── ...               # 其他平台工具
├── tools/                # SDK工具目录
│   ├── bin/             # 二进制工具
│   └── lib/             # 库文件
└── licenses/             # 许可证文件

安装验证[编辑 | 编辑源代码]

工具验证结果[编辑 | 编辑源代码]

# adb验证
$ adb --version
Android Debug Bridge version 1.0.41
Version 34.0.4-debian
Installed as /usr/lib/android-sdk/platform-tools/adb

# aapt验证
$ aapt version
Android Asset Packaging Tool, v0.2-debian

# fastboot验证
$ fastboot --version
fastboot version 34.0.4-debian
Installed as /usr/lib/android-sdk/platform-tools/fastboot

# Java验证
$ java -version
openjdk version "21.0.10" 2026-01-20
OpenJDK Runtime Environment (build 21.0.10+7-Ubuntu-124.04)
OpenJDK 64-Bit Server VM (build 21.0.10+7-Ubuntu-124.04, mixed mode, sharing)

环境变量验证[编辑 | 编辑源代码]

$ echo $ANDROID_HOME
/usr/lib/android-sdk

$ which adb
/usr/lib/android-sdk/platform-tools/adb

$ which fastboot
/usr/lib/android-sdk/platform-tools/fastboot

使用指南[编辑 | 编辑源代码]

基础使用[编辑 | 编辑源代码]

1. 重新加载环境变量[编辑 | 编辑源代码]

source /etc/profile

2. 连接Android设备[编辑 | 编辑源代码]

# 查看连接的设备
adb devices

# 如果设备未识别，可能需要启用USB调试
adb kill-server
adb start-server

3. 常用adb命令[编辑 | 编辑源代码]

# 安装APK
adb install app.apk

# 卸载应用
adb uninstall com.example.app

# 查看日志
adb logcat

# 进入shell
adb shell

# 推送文件到设备
adb push local_file /sdcard/

# 从设备拉取文件
adb pull /sdcard/file local_file

4. fastboot使用[编辑 | 编辑源代码]

# 进入fastboot模式
adb reboot bootloader

# 查看fastboot设备
fastboot devices

# 刷入镜像
fastboot flash boot boot.img
fastboot flash system system.img

开发工作流[编辑 | 编辑源代码]

1. 资源编译[编辑 | 编辑源代码]

# 编译资源
aapt package -f -m -J gen/ -S res/ -I $ANDROID_HOME/platforms/android-34/android.jar -M AndroidManifest.xml

2. APK签名[编辑 | 编辑源代码]

# 使用apksigner签名
apksigner sign --ks keystore.jks --ks-key-alias mykeyalias app.apk

3. APK优化[编辑 | 编辑源代码]

# 使用zipalign优化
zipalign -v 4 input.apk output.apk

扩展安装[编辑 | 编辑源代码]

安装Android平台[编辑 | 编辑源代码]

如果需要特定Android平台版本： 

# 首先确保sdkmanager可用
# 然后安装平台
sdkmanager "platforms;android-34"
sdkmanager "platforms;android-33"

安装Android Studio[编辑 | 编辑源代码]

# 下载Android Studio
wget https://redirector.gvt1.com/edgedl/android/studio/ide-zips/2023.2.1.20/android-studio-2023.2.1.20-linux.tar.gz

# 解压并安装
tar -xzf android-studio-*.tar.gz -C /opt/
cd /opt/android-studio/bin
./studio.sh

安装Android Emulator[编辑 | 编辑源代码]

# 安装模拟器组件
sdkmanager "emulator"
sdkmanager "system-images;android-34;google_apis;x86_64"

# 创建AVD
avdmanager create avd -n Pixel_6 -k "system-images;android-34;google_apis;x86_64" -d pixel_6

故障排除[编辑 | 编辑源代码]

常见问题[编辑 | 编辑源代码]

1. adb设备未识别[编辑 | 编辑源代码]

# 检查USB连接
lsusb

# 重新启动adb服务
adb kill-server
adb start-server

# 检查设备USB调试是否启用

2. 权限问题[编辑 | 编辑源代码]

# 为adb添加USB权限
sudo vi /etc/udev/rules.d/51-android.rules
# 添加: SUBSYSTEM=="usb", ATTR{idVendor}=="xxxx", MODE="0666"

# 重新加载udev规则
sudo udevadm control --reload-rules
sudo udevadm trigger

3. 环境变量不生效[编辑 | 编辑源代码]

# 检查配置文件
cat /etc/profile | grep ANDROID_HOME

# 手动设置
export ANDROID_HOME=/usr/lib/android-sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools

# 永久生效需要重新登录或重启

性能优化建议[编辑 | 编辑源代码]

1. 磁盘空间管理[编辑 | 编辑源代码]

  • 定期清理构建缓存：rm -rf ~/.android/build-cache
  • 删除不需要的AVD镜像
  • 清理Gradle缓存：rm -rf ~/.gradle/caches

2. 内存优化[编辑 | 编辑源代码]

  • 调整adb缓冲区大小：adb shell setprop dalvik.vm.heapsize 256m
  • 优化模拟器内存使用
  • 使用swap空间缓解内存压力

3. 构建加速[编辑 | 编辑源代码]

  • 启用Gradle构建缓存
  • 使用并行构建
  • 配置适当的堆大小

维护与更新[编辑 | 编辑源代码]

定期维护[编辑 | 编辑源代码]

1. 检查更新： 

apt update
apt list --upgradable | grep android

2. 清理旧版本： 

apt autoremove

3. 备份配置： 

# 备份环境配置
cp /etc/profile /etc/profile.backup

版本升级[编辑 | 编辑源代码]

当需要升级Android SDK时： 

# 更新包列表
apt update

# 升级Android SDK
apt upgrade android-sdk android-sdk-platform-tools

# 验证新版本
adb --version

相关文档[编辑 | 编辑源代码]

本地文档[编辑 | 编辑源代码]

1. 安装总结: /opt/android_sdk_installation_summary.md 2. 安装脚本: /opt/install_android_sdk.sh (备用) 3. 系统日志: memory/2026-02-12.md

官方资源[编辑 | 编辑源代码]

社区资源[编辑 | 编辑源代码]

文档信息[编辑 | 编辑源代码]

项目 内容
文档版本 v1.0
创建时间 2026-02-12 07:16 GMT+8
最后更新 2026-02-12 07:32 GMT+8
创建者 OpenClaw AI助手
系统环境 Ubuntu 24.04 LTS
适用对象 Android开发者、系统管理员

支持与反馈[编辑 | 编辑源代码]

如有问题或需要进一步协助：

  1. 检查本文档的故障排除部分
  2. 查阅官方文档和社区资源
  3. 联系系统管理员或开发团队

备注: 本文档基于实际安装过程编写，所有命令和配置均经过验证。

文档生成完成，可用于团队知识库共享和后续环境部署参考。

检索自“https://wiki.chsoc.com/index.php?title=Android_SDK_开发环境安装总结&oldid=1022”