如何在GitHub Workflow中运行ARMv7 Android C++原生二进制文件？

问题分析 #

你使用ReactiveCircus/android-emulator-runner Action在ubuntu-latest托管运行器上执行ARMv7原生测试时，遇到adb无法连接模拟器的问题。该Action的arm64-v8a镜像在GitHub托管环境中存在兼容性隐患，尤其是低API级别（如API 24）的ARM镜像启动稳定性较差，再加上仓库本身无aarch64模拟器测试用例，导致问题难以排查。

替代解决方案 #

方案1：用QEMU直接运行ARMv7二进制 #

GitHub的ubuntu-latest运行器已预装QEMU，可直接模拟ARMv7环境运行测试，无需启动Android模拟器：

1. 交叉编译时确保工具链配置正确（例如使用arm-linux-gnueabihf-gcc），生成符合ARMv7架构的可执行文件。
2. 在Workflow中安装ARMv7运行依赖：

   sudo apt-get update && sudo apt-get install -y qemu-user libc6-armhf-cross
   

3. 运行测试二进制：

   qemu-arm-static ./path/to/your/test-binary
   

   若存在依赖库，需指定库路径：

   LD_LIBRARY_PATH=/usr/arm-linux-gnueabihf/lib qemu-arm-static ./path/to/your/test-binary
   

方案2：改用GitHub原生ARM托管运行器 #

GitHub提供原生ARM64运行器（可指定ubuntu-22.04-arm64，或新版ubuntu-latest的ARM版本），ARM64架构兼容ARMv3+指令集，可直接运行ARMv7二进制：

1. 在Workflow中指定ARM运行器：

   runs-on: ubuntu-22.04-arm64
   

2. 安装ARMv7运行依赖：

   sudo apt-get update && sudo apt-get install -y libc6-armhf
   

3. 直接执行你的ARMv7测试二进制，无需额外模拟器。

方案3：修复Android模拟器连接问题（若需保留Android环境） #

如果必须在Android模拟器中测试，可尝试以下调整：

• 升级API级别到28及以上，高版本ARM64模拟器在GitHub运行器上稳定性更好。
• 增加模拟器启动等待时间，添加显式adb等待命令：

  uses: ReactiveCircus/android-emulator-runner@v2.30.1
  with:
    arch: arm64-v8a
    api-level: 28
    emulator-options: -no-window -noaudio -no-boot-anim -accel auto
    script: |
      adb wait-for-device
      adb root
      adb wait-for-device
      ./scripts/android-run-tests.sh ${{ steps.strings.outputs.cmake-preset }}
  

• 检查测试脚本是否正确推送二进制到模拟器，例如先执行adb push ./test-binary /data/local/tmp/再运行测试。

推荐方案 #

优先选择方案1或2，QEMU直接运行或原生ARM运行器更轻量、稳定，适合纯C++原生测试场景，无需承担Android环境的额外开销。

内容的提问来源于stack exchange，提问作者Angel