在actions/runner-images项目中解决Ubuntu 24.04下Android模拟器设备路径问题

在持续集成环境中使用Android模拟器进行自动化测试时，开发者可能会遇到一个棘手的问题：在Ubuntu 24.04系统上，通过avdmanager创建的Android虚拟设备(AVD)无法被emulator识别。这个问题在GitHub Actions的标准运行器上尤为明显，特别是在从Ubuntu 22.04升级到24.04版本后出现。

问题现象

当开发者在Ubuntu 24.04的CI环境中执行以下典型操作流程时：

1. 使用sdkmanager安装Android系统镜像和工具
2. 通过avdmanager创建AVD设备
3. 尝试用emulator列出可用设备

会发现emulator无法找到刚刚创建的AVD设备。而在Ubuntu 22.04环境中，相同的操作流程却能正常工作。

根本原因分析

经过深入调查，发现问题源于Ubuntu 24.04系统中Android工具链的默认配置变更。具体表现为：

• avdmanager将创建的设备信息存储在~/.config/.android目录下
• emulator却默认在~/.android目录中查找设备信息

这种路径不一致导致emulator无法发现已创建的AVD设备。值得注意的是，这个问题并非由Android SDK版本差异引起，而是与操作系统级别的配置变更有关。

解决方案

目前有两种可行的解决方案：

临时解决方案（符号链接）

创建一个符号链接，将emulator查找的目录指向avdmanager实际使用的目录：

ln -s /home/runner/.config/.android /home/runner/.android

这种方法简单直接，能立即解决问题，但属于临时性解决方案。

永久解决方案（环境变量配置）

更规范的解决方法是设置ANDROID_AVD_HOME环境变量，明确指定AVD设备的存储位置：

export ANDROID_AVD_HOME=/home/runner/.config/.android/avd

这种方法更为可靠，因为它直接告诉工具链在哪里查找设备信息，避免了依赖默认路径。

最佳实践建议

对于在CI/CD管道中使用Android模拟器的开发者，建议采取以下措施：

1. 在创建工作流程时，始终明确设置ANDROID_AVD_HOME环境变量
2. 在Ubuntu 24.04环境中，优先检查工具链的路径配置
3. 考虑将路径配置作为工作流程的初始化步骤之一
4. 在切换Ubuntu版本时，特别注意这类与系统配置相关的变更

总结

这个案例展示了系统升级可能带来的微妙但重要的配置变更。对于依赖特定工具链的开发者来说，理解这些底层变化至关重要。通过正确配置环境变量或调整路径结构，可以确保Android模拟器在Ubuntu 24.04环境中正常工作，保持CI/CD管道的稳定性。

随着Ubuntu 24.04逐渐成为主流，这类问题可能会影响更多开发者。提前了解并采取预防措施，可以避免在关键时刻遇到构建失败的情况。