📚 课程目录第3章系统镜像管理

3、系统镜像管理：不同API Level的镜像选择、Google APIs与Google Play镜像区别、下载与删除镜像、离线镜像配置

系统镜像这东西，说白了就是模拟器的"操作系统安装盘"。你选对了，项目跑得顺；选错了，各种兼容性问题能把你逼疯。我刚开始带团队那会儿，就因为在镜像选择上偷了个懒，结果排查了一整天的ANR问题，最后发现是API Level不匹配——嗯，从那以后我再也不敢随便选镜像了。

Android每发布一个大版本，就会对应一个新的API Level。比如Android 14对应API 34，Android 15对应API 35。你可能会问：是不是永远选最新的就行？

我个人习惯是：目标用户群决定API Level。如果你的App最低支持API 26，那测试时至少得覆盖API 26、30、34这三个关键节点。

我的经验：别只测最新版。很多线上Bug都出在低版本上。我建议每个Sprint至少跑一次minSdkVersion对应的镜像。

这个坑我踩过。你在SDK Manager里会看到两种镜像：Google APIs 和 Google Play。它们到底差在哪？

Google APIs镜像：包含Google服务框架，但不包含Play商店。适合测试地图、登录等基础Google服务。启动快，资源占用少。

Google Play镜像：包含完整的Play商店和Google服务。适合测试应用内购买、推送通知、Play Integrity等依赖商店的功能。但——它更重，启动慢，而且有些系统应用是只读的。

核心区别一句话：

我记得有一次，测试团队反馈说"应用内购买在模拟器上点不了"。我过去一看，他们用的Google APIs镜像，根本没有Play商店。换到Google Play镜像后，问题立刻解决。

注意：Google Play镜像的system分区是只读的，你不能用adb remount去修改系统文件。如果需要root权限测试，请使用Google APIs镜像。

操作其实很简单，但有几个细节我想强调一下。

下载时注意看镜像大小。一个完整的Google Play镜像大概1.5GB到3GB不等。我建议只下载你真正需要的，别一股脑全勾上——硬盘空间就是这么被吃光的。

两种方式：

省空间技巧：我每个月会清理一次，把超过3个月没用的旧镜像删掉。保留最近两个大版本就够了。

团队里总有网络不好的时候，或者公司内网不能直连Google。这时候离线镜像就派上用场了。

配置方法其实不复杂：

我曾经给一个军工项目配过离线环境。那地方别说Google，连外网都严格受限。我提前下载了5个API Level的镜像，打包成压缩包带进去。解压后直接能用，省去了很多麻烦。

踩坑提醒：离线镜像的目录结构必须和SDK Manager下载的一致。少一层目录或者名字写错，模拟器就认不出来。我见过有人把文件夹名写成"android_34"而不是"android-34"，排查了半天。

下面这张图是我自己总结的镜像选择流程，帮你快速做决定：

一句话总结：镜像选对了，调试就成功了一半。别在这个环节偷懒，否则后面有你受的。