Digital Lab Appium 功能

Digital Lab 集成扩展了标准 Appium 功能。本主题提供了有关几种常见功能的信息。

备注 : * * 使用 Appium Inspector v1.22 时,需要将前缀"uftm"添加到多个 Appium 功能。

示例: 对于 userName,请使用 uftm : userName。

Appium /Digital Lab 功能 必需 需要 uftm 前缀* * 注释
oauthClientId /
用户名
*  

Digital Lab 中运行测试所需的执行类型访问密钥/用户名。

有关访问密钥的详细信息,请参阅生成和管理访问密钥

*如果管理员允许 Appium 脚本进行匿名登录,则可以省略 oauthClientId/userNameoauthClientSecret /password 功能。管理员可以在常规屏幕的管理设置部分启用匿名访问。

oauthClientSecret/password * *请参阅评论 oauthClientId/userName
tenantId

启用共享空间时,包括九位共享空间 ID。您可以在实验室控制台的工具栏中找到它。有关详细信息,请参阅连接到 Digital Lab 共享空间。默认共享空间 ID 为 999999999。

应用程序 --  

Digital Lab 集成中不支持。要在设备上安装应用程序,请将 appPackageappActivity 用于 Android,将 bundleId 用于 iOS。

appiumVersion 定义用于测试的 Appium 主要版本。默认值为 Appium 版本 1。要使用 Appium 版本 2,请将此功能设置为 v2.x
有关在 Appium 版本之间切换的代码示例,请参阅 Digital Lab github 存储库中的 multi - Appium 支持
appPackage (Android)  

标识应用程序的包名称,在应用程序详细信息卡中显示为包 ID。例如,"com.Advantage.aShopping "。

如果设备上尚未安装应用程序,则 Digital Lab 将检查数据库中是否存在应用程序。如果存在,它将在运行测试步骤之前自动安装它。

appActivity (Android)  

要启动的 Android 活动的名称,在应用程序详细信息卡中显示为启动活动
如果设备上尚未安装应用程序,则 Digital Lab 将检查数据库中是否存在应用程序。如果存在,它将在运行测试步骤之前自动安装它。

bundle ID (iOS)  

应用程序的唯一标识符 BundleID,在应用程序详细信息卡中显示为包 ID。例如,"com.ot.iShop"

如果设备上尚未安装应用程序,则 Digital Lab 将检查数据库中是否存在应用程序。如果存在,它将在运行测试步骤之前自动安装它。

installPackagedApp 安装用于测试的应用程序的注入代码版本。在使用身份验证、照片、条形码和 QR 码模拟等模拟时包含此功能。有关模拟的详细信息,请参阅 Appium 模拟

设备主机类型

“ PrivateOnPremise"、"公共"或"PrivateHosting"

deviceType

  "实数"或"仿真器"
平台名称   "Android"或"iOS"
平台版本  

OS 的版本。可以指定一个枚举符号,如<、>、< =。> =、和=。

例如,"platformVersion" ," > 5.0.1"

deviceName  

物理设备名或仿真设备名。您可以指定 Digital Lab 控制台中显示的制造商、型号或逻辑名称。

如果未指定设备名称,脚本将使用默认设备来实现指定的功能。将此功能与 udid 结合使用或替代使用。

当按设备制造商、型号名称或逻辑名称指定设备时,请使用这些指导原则。

  • 预留者默认情况下,搜索引擎执行模糊搜索,返回与字符串部分匹配的第一个设备,即使该设备不是最佳匹配。
  • 如果设备名称是另一个设备名称的子字符串,则使用 udid 等其他功能以避免歧义。
  • 若要精确匹配字符串,请使用带双引号的细化搜索。例如," \" Apple iPhone 5c (GSM + CDMA)\"" 查找具有该确切制造商和型号名称的设备。(备注将反斜杠用作转义符。)
udid  

Digital Lab 分配的设备的 UDID 标识符。

如果未指定 UDID,脚本将对指定的功能使用默认设备。将此功能与 deviceName 结合使用或将其代替。

浏览器名称 *  

测试 Web 应用程序时,要测试的浏览器,例如 iOS 的"Safari"和适用于 Android 的"Chrome"、"Chrome"或"Browser"。

在测试应用程序时,请忽略此功能或将其设置为空字符串。但是,如果要使用 Node.JSwd 测试应用程序,则必须添加此功能并将其设置为空字符串。

设备的源实验室:

  • 使用 OpenText 托管设备时,使用值 HOSTED,或使用 Digital Lab |HOSTED (适用于内部部署设备和 OpenText 托管设备)。

  • 对于 ADF 设备,使用 AWS

automatic-name  

iOS

Digital Lab 使您可以在 iOS 设备上运行测试,而无需使用 Mac 计算机。用于 iOS 的默认自动化方法是 XCUITest。

如果明确要使用 UIA 自动化,则将 automationName 设置为 uiAutomation。此功能仅适用于 iOS 版本 9.3 到 11.1。在 iOS 版本 11.1 以上的版本中,不支持此功能,并且全部测试都使用 XCUITest。

AndroidOS 5.0 及更高版本

UiAutomator2 是默认的自动化引擎。 uiautomator2 驱动程序使用 Google 的 UiAutomator2 技术在设备或仿真器上实现自动化。要覆盖默认值并使用 UiAutomator1,请将该值设置为"Android"。

 

AndroidOS< 5.0

UiAutomator1("Android") 是 AndroidOS< 5.0 的默认值。只能将 UiAutomator1 用作自动化引擎。

mcWorkspaceName

使您可以指定上载到特定工作区的应用程序。

fullReset  

卸载应用程序在测试之前和之后。使用此功能时,Digital Lab 会在测试之前卸载应用程序,安装应用程序进行测试,然后在测试结束时卸载应用程序。对于 iOS 设备,当 fullReset 设置为 true 时,resetOnSessionStartOnly 必须设置为 false。

仅当使用 bundle ID (iOS) 或具有 appActivity (Android) 功能的 appPackage 时才受支持。

noReset   使用此功能时,仅当尚未安装 Digital Lab 时,才会安装应用程序以在设备上进行测试。
仅当使用 bundle ID (iOS) 或具有 appActivity (Android) 功能的 appPackage 时才受支持。

后退到顶部

另请参阅: