Airtest 安装避坑指南

Airtest 安装避坑指南

本文档记录了在 Python 3.13 环境下安装 Airtest 的成功经验和避坑指南，适用于遇到安装问题的用户参考。

环境信息

  • 操作系统：Windows
  • Python 版本：3.13（最新版本，可能与部分包存在兼容性问题）
  • Airtest 版本：1.3.6

常见问题与解决方案

问题1：安装过程中缺少编译器

错误信息：

ERROR: Unknown compiler(s): [['icl'], ['cl'], ['cc'], ['gcc'], ['clang'], ['clang-cl'], ['pgcc']]

解决方案：使用预编译的 wheel 包，避免源码编译。

问题2：meson-python 版本不匹配

错误信息：

ERROR: Could not find a version that satisfies the requirement meson-python<0.16.0,>=0.15.0

解决方案：安装预编译的 numpy wheel 包，或使用 --prefer-binary 参数。

问题3：numpy 版本兼容性问题

错误信息：

airtest 1.3.6 requires numpy<2.0, but you have numpy 2.3.4 which is incompatible.

解决方案：虽然有警告，但在大多数基本功能使用中可能不会有问题。如需完全兼容，可以降级 numpy 版本。

成功安装步骤

步骤1：升级 pip

首先确保 pip 是最新版本：

pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn

步骤2：安装 numpy

使用国内镜像源安装预编译的 numpy：

pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn --prefer-binary

步骤3：安装 Airtest（跳过依赖检查）

由于 Airtest 与最新版本的 numpy 存在版本限制，我们需要跳过依赖检查：

pip install airtest -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn --no-deps

步骤4：安装必要的依赖项

手动安装 Airtest 所需的依赖：

pip install six==1.16.0 mss==6.1.0 ffmpeg-python filelock opencv-contrib-python==4.6.0.66 pywinauto==0.6.3 tidevice -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn

验证安装

创建一个简单的测试脚本验证 Airtest 是否正常工作：

# test_airtest.py
import airtest
print(f"Airtest版本: {airtest.__version__}")
print("Airtest导入成功!")

运行脚本：

python test_airtest.py

如果输出 Airtest 版本并显示导入成功，则安装成功。

避坑指南

  1. 避免直接从 ZIP 文件安装：虽然可以通过 pip install "路径/Airtest-1.3.6.zip" 安装，但在高版本 Python 中可能会遇到更多依赖问题。

  2. 优先使用国内镜像源：使用清华大学、阿里云等国内镜像源可以显著提高下载速度并避免网络问题。

  3. 注意版本兼容性：

    • Airtest 1.3.6 要求 numpy < 2.0
    • 在 Python 3.13 环境中，许多包可能尚未完全兼容

  4. 使用 --prefer-binary 避免源码编译：这可以避免因缺少编译器导致的安装失败。

  5. 手动安装依赖：使用 --no-deps 安装 Airtest 后，需要手动安装所有必要的依赖项。

高级选项：使用虚拟环境

为避免依赖冲突，推荐使用虚拟环境安装 Airtest：

# 创建虚拟环境
python -m venv airtest_env

# 激活虚拟环境
airtest_env\Scripts\activate

# 然后在虚拟环境中按照上述步骤安装 Airtest

故障排除

如果在使用过程中遇到 numpy 相关的错误，可以尝试降级 numpy 版本：

pip install numpy==1.26.4 -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn --prefer-binary

如果问题仍然存在，可能需要考虑使用较低版本的 Python（如 Python 3.8-3.10），这些版本与 Airtest 的兼容性更好。

总结

在高版本 Python（如 3.13）中安装 Airtest 需要注意依赖兼容性问题。通过使用国内镜像源、预编译 wheel 包和手动管理依赖，可以成功安装并使用 Airtest 的基本功能。对于复杂项目，建议使用较低版本的 Python 以获得更好的兼容性。

posted @ 2025-11-08 13:06  zhangdingqu  阅读(69)  评论(0)    收藏  举报