帮助中心
Python模式下使用Cube库

Cube库为本平台封装并默认提供的SDK,该库可提供软件自动化、界面自动化、AI等能力,本文将以Resource类、UIAutomation相关类WebPage为例为您介绍如何导入Cube库并使用库中的类和函数。

# 说明

Cube库包含所有组件库的类和函数,在新建的Python可视化工作流中,Cube库作为平台封装库已被默认安装。在Python可视化工作流中进行代码开发时,只需通过import导入即可,导入代码如下:

import Cube # 导入Cube SDK
1

与此同时还需要导入Resource类、print函数及其他类(例如WebPage类),导入代码及作用如下:

from . import Resource, print # 导入Resource类、平台封装的print函数
from Cube.UIAutomation import WebPage # 导入WebPage类
1
2

说明:Resource类与其他Cube库中类的导入方式不同,使用时请注意导入语法。

  • Resoure类:提供访问当前设计器内数据的函数,例如获取元素(本地元素库、扩展元素库)、获取资源文件。您可以直接在相应工作流内指定的数据上右击选择复制元素标识和复制使用代码方式进行使用,该功能仅适用于元素与文件。相关获取代码如下:
    Resource.getLocator(elementID) #获取元素,elementID为元素标识,格式为:元素库名称&元素名称。
    Resource.getResourceFile(name) #获取资源文件,name为资源文件名称。
    
    1
    2
  • print函数:区别于Python中的print函数,引入该自定义print函数后,可以在日志信息中显示打印信息,如果不引入该函数,打印信息仅在日志信息详情中显示。

  • WebPage类:提供操作浏览器上网页的函数,调用代码如下(以attachWebPage函数为例):
    	WebPage.attachWebPage(locator,timeout) # 根据定位器获取界面窗口
    
    1

# 输入方式

您可以通过以下两种方式进行Cube函数的输入:

复制元素、文件标识
Python模式编辑器提供了直接复制元素唯一标识和复制文件使用代码的功能,您可以直接复制粘贴无需手动输入,提高代码开发效率。

  1. 在元素库或资源文件中,右键单击待操作元素或文件,选择复制元素唯一标识(元素)或复制到代码中使用(资源文件)。
  2. 在编辑器的目标位置右键单击并选择粘贴,复制内容将被粘贴至目标处。

说明:本地元素库的元素定位参数为元素库名称&元素名称,例如Resource.getLocator("本地元素库&INPUT - su");扩展元素库的元素定位参数为库名称&元素名称,例如Resource.getLocator("扩展元素库测试&INPUT - su")

直接输入
在代码编辑器中直接手动输入类及函数,如下图所示:

Python模式编辑器提供代码智能提示、Tab补全、悬停显示函数语法功能,您可以轻松输入相关函数。

# 常见问题

如何处理在Python代码模式中元素无法直接使用变量问题? (opens new window)

最近更新时间: { "value": "2023-11-24", "effect": true }