树莓派4 Docker容器中Appium环境ChromeDriver安装问题求助

问题描述 #

在树莓派4的Docker容器中运行Appium时，遇到ChromeDriver适配问题：官方未发布armv7l架构的预编译ChromeDriver包，执行apt-get install chromium-chromedriver时提示Unable to locate package chromium-chromedriver错误。当前使用的Dockerfile如下：

FROM node:20.5.0-bullseye

WORKDIR /usr/src/app

RUN --mount=type=cache,target=/var/cache/apt apt-get update || : && apt-get install -y python3 python3-pip

RUN apt-get -y install android-sdk-build-tools android-tools-adb android-tools-fastboot

ENV ANDROID_HOME /usr/lib/android-sdk

RUN npm i --location=global appium

RUN appium driver install uiautomator2

RUN --mount=type=cache,target=/root/.cache/pip pip install --upgrade pip --extra-index-url https://www.piwheels.org/simple

COPY ./requirements.txt .

RUN --mount=type=cache,target=/root/.cache/pip pip install -r requirements.txt --extra-index-url https://www.piwheels.org/simple

已为Appium服务添加--allow-insecure chromedriver_autodownload启动参数，询问是否可在此容器中安装ChromeDriver及可行实现方案。

可行实现方案 #

1. 调整APT源安装backports版本的chromium-chromedriver #

Debian bullseye的默认源中armv7l架构的chromium-chromedriver可能未收录，可尝试添加backports源安装：
在Dockerfile中插入以下命令：

# 添加bullseye-backports源
RUN echo "deb http://deb.debian.org/debian bullseye-backports main contrib non-free" >> /etc/apt/sources.list
# 更新源并安装chromium-chromedriver
RUN apt-get update && apt-get install -y -t bullseye-backports chromium-chromedriver

安装完成后，可通过chromedriver --version验证版本是否匹配设备上的Chrome浏览器。

2. 手动编译armv7l版本的ChromeDriver #

如果backports源仍无法获取，可手动从Chrome源码编译适配版本：

• 在容器中安装编译依赖：

  apt-get install -y build-essential git cmake ninja-build pkg-config libssl-dev libx11-dev libxext-dev libxi-dev libxrender-dev libxrandr-dev libxcursor-dev libxinerama-dev libgl1-mesa-dev
  

• 克隆Chrome源码仓库，切换到与设备Chrome版本一致的分支
• 配置armv7l架构编译环境，执行编译命令生成ChromeDriver二进制文件
• 将编译产物复制到系统PATH目录（如/usr/local/bin）并赋予可执行权限：chmod +x /usr/local/bin/chromedriver

3. 配置Appium指定自定义ChromeDriver路径 #

无论通过哪种方式获取到ChromeDriver，都需要告知Appium其位置：

• 启动Appium时添加参数：

  appium --allow-insecure chromedriver_autodownload --chromedriver-executable /path/to/chromedriver
  

• 或在测试代码的Desired Capabilities中配置：

  desired_caps = {
      "platformName": "Android",
      "deviceName": "你的设备名称",
      "chromedriverExecutable": "/path/to/chromedriver",
      "chromeOptions": {
          "args": ["--no-sandbox"]  # 解决容器中Chrome运行的沙箱限制
      }
  }
  

关键注意事项 #

• ChromeDriver版本必须与设备上安装的Chrome浏览器主版本号完全一致，否则会出现兼容性报错，可通过chrome --version查看设备Chrome版本。
• 容器中运行Chrome需添加--no-sandbox参数，避免权限限制导致启动失败。

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