手动安装Python自动化库

CukeTest 不仅支持在其内置的 Python 环境中开发和执行自动化测试，也提供了将其自动化库安装到外部 Python 环境的能力。这样，您就可以在自己熟悉的开发环境中利用 CukeTest 的功能。以下教程将引导您通过几个简单的步骤，将 CukeTest 自动化库安装到自己的 Python 环境（以 Python 3.8 版本为例）。

安装前的准备

在开始安装前，请确保您的系统中已安装 Python 3.8 版本。您可以通过在命令行或终端中执行以下命令来检查 Python 的当前版本：

python --version
# 或
python3 --version

请根据您的系统配置选择合适的命令。

安装步骤

1. 打开命令行工具或终端：

   • Windows 用户：搜索并打开“命令提示符”或 “PowerShell”。

   • macOS / Linux 用户：打开系统自带的“终端”。

2. 切换至自动化库所在目录：

   使用 cd 命令，进入 CukeTest 自动化库的 whl 文件所在的目录。此目录中包含了适配不同 Python 版本的库文件。 不同系统下默认路径如下：

   • Windows：

     cd "C:\Program Files\LeanPro\CukeTest\pyapi\dist\"
     

   • Linux：

     cd /usr/lib/cuketest/pyapi/dist/
     

   • macOS：

     cd /Applications/CukeTest.app/Contents/pyapi/dist/
     

3. 执行安装或升级命令：

   在当前目录下，运行以下 pip 命令来安装或升级 leanproAuto 库：

    pip install --upgrade leanproAuto --no-index --find-links=./
   

   这个命令的含义是：

   • --upgrade (或 -U)：如果 leanproAuto 库已安装，则尝试将其更新到 dist 目录中找到的最新版本；如果未安装，则直接进行安装。
   • --no-index：不查询 PyPI (Python Package Index) 等在线索引，确保只使用本地提供的文件。

   • --find-links=./：仅在当前目录 (./) 中查找 leanproAuto 包的 .whl 文件。

   • 如果您之前安装过此库，但需要重新安装或降级到特定版本，可以使用 --force-reinstall 标志：

     pip install --force-reinstall leanproAuto --no-index --find-links=./
     

验证安装

安装完成后，您可以通过执行以下命令来验证 leanproAuto 库是否成功安装：

pip show leanproAuto

如果安装成功，将显示类似如下的信息（版本号和路径会根据您的实际情况有所不同）：

Name: leanproAuto
Version: 1.8.10.3
Summary: API to automate desktop
Home-page: https://www.cuketest.com/
Author: LeanPro Corporation
Location: /path/to/your/python/site-packages

开始使用

安装 CukeTest 自动化库之后，您就可以在 Python 脚本中导入并开始使用它了。下面是一个使用 CukeTest 库进行键盘操作的示例代码：

from leanproAuto import WinAuto, QtAuto, Keyboard, Mouse, Util, Screen, Image, RunSettings, CukeTest

# 模拟按下Ctrl+A（全选）
Keyboard.keyDown("control")
Keyboard.keyTap("a")
Keyboard.keyUp("control")

通过上述步骤，您已成功在本地 Python 环境中集成了 CukeTest 自动化库，可以在更多测试场景中自由发挥其强大功能。