当前位置：首页 > news >正文

从入门到精通：Android Emulator Runner多API级别与设备配置实践

news 2026/8/28 13:03:30

从入门到精通：Android Emulator Runner多API级别与设备配置实践

【免费下载链接】android-emulator-runnerA GitHub Action for installing, configuring and running hardware-accelerated Android Emulators on macOS virtual machines.项目地址: https://gitcode.com/gh_mirrors/an/android-emulator-runner

Android Emulator Runner是一款强大的GitHub Action工具，专为在macOS虚拟机上安装、配置和运行硬件加速的Android模拟器而设计。本文将带你全面掌握如何利用这款工具实现多API级别管理与灵活的设备配置，轻松应对不同Android版本的测试需求。

🚀 核心功能概览：为什么选择Android Emulator Runner？

Android Emulator Runner作为GitHub Action的一员，能够无缝集成到你的CI/CD流程中，提供以下关键优势：

硬件加速支持：充分利用macOS虚拟机的硬件加速能力，显著提升模拟器运行速度
多API级别覆盖：支持从低版本到最新的Android API级别，包括扩展版本如35-ext15
灵活设备配置：可定制CPU架构、内存大小、存储容量等硬件参数
自动化工作流：与GitHub Actions完美结合，实现测试流程全自动化

Android Emulator Runner使用的Android机器人图标，象征其与Android生态系统的深度集成

📋 快速上手：基础配置与安装

要开始使用Android Emulator Runner，你需要先将其集成到你的GitHub Actions工作流文件中。最基本的配置只需指定API级别和运行脚本：

- name: Run Android Emulator uses: android-emulator-runner@v2 with: api-level: 33 script: ./gradlew connectedCheck

上述配置将创建一个API级别33的模拟器，并执行指定的测试脚本。这是Android Emulator Runner的最小化配置，适合快速入门。

🔧 多API级别管理：覆盖不同Android版本

Android Emulator Runner支持广泛的API级别，从早期版本到最新的Android版本。通过api-level参数，你可以轻松指定所需的Android版本：

基础API级别配置

# 使用标准API级别 - uses: android-emulator-runner@v2 with: api-level: 33 # Android 13 script: ./gradlew connectedCheck

扩展API级别支持

对于需要扩展功能的场景，如Android 14的扩展版本：

# 使用扩展API级别 - uses: android-emulator-runner@v2 with: api-level: 34-ext10 # Android 14扩展版本 script: ./gradlew connectedCheck

预览版支持

Android Emulator Runner还支持最新的预览版Android系统：

# 使用预览版Android - uses: android-emulator-runner@v2 with: api-level: Baklava # Android预览版代号 script: ./gradlew connectedCheck

📱 设备配置深度定制：打造专属测试环境

Android Emulator Runner提供了丰富的设备配置选项，让你能够精确模拟各种硬件环境。

系统镜像选择

通过target参数选择不同类型的系统镜像：

- uses: android-emulator-runner@v2 with: api-level: 33 target: google_apis_playstore # 包含Google Play商店的系统镜像 script: ./gradlew connectedCheck

支持的系统镜像类型包括：

default: 默认系统镜像
google_apis: 包含Google API的镜像
google_apis_playstore: 包含Google Play商店的镜像
aosp_atd: Android测试设备镜像
android-tv: Android TV专用镜像
android-automotive: 车载系统镜像

硬件架构配置

通过arch参数选择CPU架构，满足不同测试需求：

- uses: android-emulator-runner@v2 with: api-level: 33 arch: x86_64 # 64位x86架构 script: ./gradlew connectedCheck

内存与存储配置

根据测试应用的需求调整内存和存储大小：

- uses: android-emulator-runner@v2 with: api-level: 33 ram-size: 4096M # 4GB内存 heap-size: 512M # 512MB堆大小 disk-size: 10G # 10GB存储空间 script: ./gradlew connectedCheck

硬件配置文件

使用profile参数选择预设的硬件配置文件：

- uses: android-emulator-runner@v2 with: api-level: 33 profile: "Pixel 6" # 模拟Pixel 6设备 script: ./gradlew connectedCheck

⚙️ 高级配置选项：优化你的测试环境

模拟器启动选项

通过emulator-options参数自定义模拟器启动参数：

- uses: android-emulator-runner@v2 with: api-level: 33 emulator-options: "-no-window -gpu swiftshader_indirect -no-snapshot" script: ./gradlew connectedCheck

启动前脚本

使用pre-emulator-launch-script在模拟器启动前执行自定义脚本：

- uses: android-emulator-runner@v2 with: api-level: 33 pre-emulator-launch-script: ./adjust-emulator-configs.sh script: ./gradlew connectedCheck

性能优化设置

调整CPU核心数和其他性能相关参数：

- uses: android-emulator-runner@v2 with: api-level: 33 cores: 4 # 使用4个CPU核心 disable-animations: true # 禁用动画以提高性能 enable-hw-keyboard: true # 启用硬件键盘 script: ./gradlew connectedCheck

📝 完整配置示例：企业级测试工作流

以下是一个完整的GitHub Actions工作流示例，展示了如何在实际项目中使用Android Emulator Runner：

name: Android CI on: push: branches: [ main ] pull_request: branches: [ main ] jobs: test: runs-on: macos-latest steps: - uses: actions/checkout@v4 - name: Set up JDK 17 uses: actions/setup-java@v4 with: java-version: '17' distribution: 'temurin' - name: Run tests on API 30 uses: android-emulator-runner@v2 with: api-level: 30 target: google_apis arch: x86_64 profile: "Pixel 4" ram-size: 2048M heap-size: 512M script: ./gradlew connectedCheck - name: Run tests on API 33 uses: android-emulator-runner@v2 with: api-level: 33 target: google_apis_playstore arch: x86_64 profile: "Pixel 6" ram-size: 4096M heap-size: 1024M script: ./gradlew connectedCheck

🔍 常见问题与解决方案

模拟器启动超时

如果遇到模拟器启动超时问题，可以增加超时时间：

- uses: android-emulator-runner@v2 with: api-level: 33 emulator-boot-timeout: 900 # 设置为15分钟 script: ./gradlew connectedCheck

硬件加速问题

在Linux系统上遇到硬件加速问题时，可以尝试禁用硬件加速：

- uses: android-emulator-runner@v2 with: api-level: 33 disable-linux-hw-accel: true script: ./gradlew connectedCheck

多模拟器并行运行

通过指定不同端口，可以在同一台机器上运行多个模拟器：

- name: Run emulator 1 uses: android-emulator-runner@v2 with: api-level: 30 emulator-port: 5554 script: ./gradlew test1 - name: Run emulator 2 uses: android-emulator-runner@v2 with: api-level: 33 emulator-port: 5556 script: ./gradlew test2