README_CN.rst

pyjab

本软件是使用 Java Access Bridge 进行 Java UI 程序的自动化实现的 Python 工具.

本软件 pyjab 可以让 Java UI 程序以自动化的方式执行（类似于 Selenium）。 该软件将会调用 Java Access Bridge API 从 Java UI 程序中获取信息。 该软件仅支持 Windows 操作系统。 该软件的源代码参考 NVDA。

• 安装
  • 可选依赖包
• 使用方式
• 联络
• 许可证

安装

您可以从 PyPI 找到 pyjab 的软件包，这意味着您可以使用如下简单的方式进行安装:

$ pip install pyjab

实际上有多种安装 Python 包的方法 （例如，per user site-packages directory 、virtual environments ）， 这里不进行展开讨论，如果这让您感到疑惑，请先于此说明前阅读这些内容。

可选依赖包

Access Bridge Explorer 是一个可进行 Java UI 程序浏览的 Windows 应用程序， 该程序提供易于访问的方式甄别 Java UI 程序的内容， 并使用 Java Access Bridge 公开其可访问性功能， 例如： Android Studio 和 IntelliJ。

使用方式

该软件需要 JRE、JDK 或 JAB 独立包。 推荐在使用前设置名为 JAVA_HOME 或 JAB_HOME 的环境变量。

下面是一个入门的简单示例：

from pyjab.jabdriver import JABDriver

# 创建一个 JABDriver 的对象
jabdriver = JABDriver("java app window title")

# 使用 element name 找到一个 JABElement 对象
login_btn = jabdriver.find_element_by_name("Login")

# 点击一个 JABElement 对象
login_btn.click()

# 其他的一些例子
jabdriver.find_element_by_xpath("//push button[@name=contains('OK')]")
jabdriver.wait_until_element_exist(by=By.NAME, value="Dashboard")
login_btn.get_screenshot_as_file("./screenshot.png")

联络

pyjab 的最新版本可在 PyPI 和 GitHub 上获得。 如果发现该软件的问题，请不吝在 GitHub 上创建一个问题。 如有疑问、建议等，也请随时给我发送电子邮件至 [email protected]。

许可证

该软件使用的许可证为 GPLv2 license.

© 2021 Gary Gao.