Docker镜像中Android emulator安装失败及ADB路径异常问题排查

GitLab CI流水线中adb wait-for-device提示文件不存在 #

• 先确认Dockerfile里是否正确配置了环境变量，必须明确设置ANDROID_HOME并将platform-tools路径加入PATH，示例：

  ENV ANDROID_HOME=/usr/local/android-sdk
  ENV PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools:$ANDROID_HOME/tools/bin
  

  要是没配置，哪怕构建阶段装了ADB，CI运行时也会因为路径问题找不到文件。
• 在镜像构建阶段加验证步骤，确认platform-tools目录里有ADB：

  RUN ls -la /usr/local/android-sdk/platform-tools/
  

  如果构建日志里看不到adb文件，说明安装步骤有问题，得检查ADB的安装命令有没有正确执行。
• 排查GitLab免费运行器的镜像挂载情况，确保没有运行时目录覆盖/usr/local/android-sdk路径的情况。

本地构建时sdkmanager异常（找不到emulator包、--help失败） #

• 检查基础镜像的Java版本：旧版sdkmanager只兼容Java 8，用Java 11+会导致运行异常，切换到openjdk:8-jdk或adoptopenjdk:8-hotspot作为基础镜像再重试。
• 补充系统依赖：sdkmanager运行需要libstdc++、ncurses等库，安装sdkmanager前执行：

  RUN apt-get update && apt-get install -y --no-install-recommends libstdc++6 libncurses5 unzip
  

• 确认sdkmanager的下载来源与架构匹配：如果本地是ARM架构机器，要下载对应ARM版本的Android命令行工具，别用x86版本。
• 要是还是找不到emulator包，试试指定完整的包名并加上通道参数：

  RUN sdkmanager --channel=3 "emulator" "system-images;android-33;google_apis;x86_64"
  

  部分旧版sdkmanager需要明确指定系统镜像的完整标识，才能找到关联的emulator包。

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