新笔记本部署RCC失败：无法构建Appium-Python-Client wheel及生成元数据

问题场景 #

• 环境：全新笔记本（无本地Python或其他预装软件）
• 工具：Robocorp Container (RCC)
• 配置：已在conda.yaml中指定Python、pip版本及所有带具体版本号的pip依赖项
• 执行命令：rcc task run --task "Setup and Run Runner.py"
• 报错信息：
  1. 构建wheel失败：

     Building wheel for Appium-Python-Client (setup.py): finished with status 'error'
     ERROR: Failed building wheel for Appium-Python-Client
     

  2. 包元数据生成错误：

     ERROR: Encountered error while generating package metadata
     

  核心矛盾：RCC宣称无需额外配置，但错误提示缺少setuptools、wheel等构建必需工具

解决步骤 #

1. 显式添加构建依赖到conda.yaml #

RCC基于conda管理环境，但部分pip包的编译需要setuptools、wheel这类基础构建工具，显式指定版本可避免版本兼容问题。修改conda.yaml，在pip依赖列表最上方添加这两个工具：

channels:
  - conda-forge
dependencies:
  - python=3.9.18  # 你的Python固定版本
  - pip=23.3.1     # 你的pip固定版本
  - pip:
      - setuptools==68.2.2
      - wheel==0.41.2
      - Appium-Python-Client==2.11.1  # 你的目标依赖
      # 其他带版本号的依赖项...

注：版本号可根据你指定的Python版本调整，Python3.8+推荐使用setuptools60+版本

2. 清理RCC缓存后重新构建环境 #

RCC会缓存已下载的依赖包，旧缓存可能引发版本冲突，执行以下命令清理后重新运行任务：

rcc cache clean
rcc task run --task "Setup and Run Runner.py"

3. 检查Appium-Python-Client版本兼容性 #

确保你指定的Appium-Python-Client版本与Python版本匹配：

• Python3.7及以下版本请勿使用Appium-Python-Client2.0+版本
• 若仍失败，尝试降级到更稳定的旧版本，比如Appium-Python-Client==2.9.0

4. 固化conda.yaml中的Python和pip版本 #

避免使用模糊的版本范围（如python>=3.8），固定具体版本可减少环境不一致问题，示例配置参考步骤1中的yaml代码。

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