Dev Access CLI 工具

通过 Dev Access 命令行界面工具，您可以将设备从OpenText Functional Testing Lab device 实验室路由到 IDE 以及基于 ADB 构建的用于 Android, 或 iDevice for iOS. 的其他开发和调试工具

对设备使用 Dev Access 时，只能通过实验室中的远程视图访问设备，而不能通过 OpenText 集成测试工具访问。

注: 在使用 Dev Access 之前，请停止计算机上的连接器。有关详细信息，请参阅启动、停止和重新启动连接器。

支持的设备

iOS 17 设备、OpenText 托管公共设备、ADF 设备、WeTest 设备、虚拟设备、仿真器和模拟器不支持 Dev Access

后退到顶部

AndroidDev AccessCLI 工具的先决条件

遵循 Dev Access CLI 工具的 Android 先决条件:

  • 计算机上必须存在 AndroidADB 组件。如果在计算机上安装了 OpenText Functional Testing Lab 连接器，则默认的 ADB 位置为 C: \Program Files\Functional Testing Lab for Mobile and Web LCD|nbsp; -|nbsp;\connector\android-sdk-windows\platform-tools。
  • 需要具备 ADB 的基本知识。有关详细信息，请参阅 Android Developer 文档中的 Android 调试桥。
  • 端口 5037 必须可用。此端口可能由OpenText Functional Testing Lab 服务器或连接器使用，因此请确保在要运行 Dev Access 的计算机上停止这些服务。

后退到顶部

设置 Dev AccessCLI 工具

对于要路由到 IDE 的每个设备，必须执行以下步骤。

要设置设备以使用 IDE，请执行以下操作:

  1. 导航到设备实验室 > 设备页。

    • 在卡模式下，转到设备的卡片上，然后单击 Dev Access 按钮 。
    • 在列表模式下，选择设备，然后单击 Dev Access。
  2. Dev Access 下载对话框提示您选择通过其访问设备的计算机操作系统。选择操作系统，然后单击下载以检索设备隧道文件。

  3. 使用写权限将归档文件的内容提取到计算机上的某个位置。

  4. 运行批处理文件。

    • 开启 Windows 中，双击 dev-access.bat 文件。
    • 开启 Linux 和 Mac，使用 sudo 命令从终端窗口运行 dev-access.sh 脚本。此脚本必须具有执行权限。
  5. 此时控制台会打开，并提示您提供开发者访问实验室的凭据。如果您还没有执行密钥，请生成一个。有关更多详细信息，请参阅生成和管理访问密钥。
  6. 粘贴执行密钥并按输入，或键入 login-c " your execution key" 再次登录。
  7. 控制台欢迎您。

与您的设备交互

控制台打开且已连接到OpenText Functional Testing Lab 服务器后，可以使用Dev AccessCLI 命令与设备和服务器进行交互。类型-- help 或- h 以查看命令列表。

对于 Android 设备，一旦连接，就可以通过虚拟 ADB 提交命令和调试设备，就像直接连接到计算机的设备一样。

要与设备交互，请执行以下操作:

  1. 找到为其生成隧道文件的设备。类型列出设备，并复制为其创建隧道文件的设备的 ID。

  2. 在控制台中，键入 start < id >。如果收到任何警告，请使用 config 命令设置正确的值。有关详细信息，请参阅Dev AccessCLI 命令。实验室控制台中的设备卡 (或列表视图中的行条目) 表明该设备已锁定，并且已使用 Dev Access 路由到您的 IDE。

  3. 与设备交互:

    • 对于使用 ADB 工具的 Android 设备: 打开一个附加的命令行窗口 (除了 Dev Access 控制台)，并发出标准的 ADB 命令。有关受支持的 ADB 命令的部分列表，请参阅Android 上的 Dev AccessCLI 工具的已知问题。

      注: 如果 ADB 可执行文件的路径包含空格，则在 dev-access.properties 文件中定义路径，该文件位于提取的文件夹中。使用反斜杠作为反斜杠的转义符。例如，android.adb.exec=C\:\\adb 3\\adb.exe。

    • Android :

      1. 如果为单个 Android 设备启动 Dev Access，请打开命令提示符并运行 adb logcat。
      2. 如果为多个 Android 设备启动 Dev Access，则运行 adb devices。复制要使用的设备的串行数量。运行 adb -s <序列号> logcat。
      3. 内部版本，从 AndroidStudio 运行和调试应用程序。
    • 对于 iOS 设备，请找到该设备并以常规方式与其交互。

要切换回本地设备，请关闭 CLI 工具。

后退到顶部

Dev AccessCLI 命令

下表列出了 Dev Access 控制台中最常用的命令。输入 --help 或 -h 列出可用命令。

有关需要参数的命令的详细信息，请键入不带任何参数的命令。

命令 详细信息
登录

登录到实验室服务器。您需要执行密钥才能执行此操作。

例如: login -c "my execution key"。
注销

从实验室服务器注销。此命令没有参数。
列表

根据指定的参数列出信息:

  • 设备。列出所有设备及其平台、名称、OS 版本、设备 ID 和状态。使用此命令可获取与 start 或 stop 命令一起使用的设备 ID。
  • 平台。列出可用的设备平台，例如 android 和 iOS。
  • 配置。列出服务器和设备配置信息，例如 URL 主机和端口。
开始 开始于指定的设备。使用从 list devices 或 list configs 命令检索到的设备 ID。例如， start 56980739ab78。
停止 停止指定的设备并将其释放给其他用户。例如 stop 56980739ab78。
清除 清除 Dev Access 控制台。此命令没有参数。
config

允许您使用以下语法配置信息:

config [-s] -n=<name> [-p=<platform>] -v=<value>

  • - s 使用指定的名称 (- n) 保存配置，以供将来使用。
  • - p 要执行配置的平台:Android 或 ios。

  • - n。要应用的配置的名称，如果在 " - s" 选项之后，则为要应用的配置的名称。可能的配置包括:

    • adb.version- ADB 客户端版本
    • adb.port- 要侦听的模拟 ADP 端口
    • adb.autokill- 中止现有正在运行的 ADB 线程 (true /false)
    • adb.exec- ADB 安装路径

  • - v -n 参数的配置值。例如:

    • –n adb.autokill –v true
    • –n adb.version –v 38
    • –n adb.port –v 5038
    • –n adb.exec –v c:/folder/adb.exe

例如，如果控制台警告您，您的 ADB 版本与服务器的版本不匹配，请使用 config 命令对其进行更改: config -n adb -v 39

exit 结束于 Dev Access 会话。此命令没有参数。

要了解有关 Android 的 config 命令和默认值的详细信息，请键入 config -p android -n。

后退到顶部

Android 上的 Dev AccessCLI 工具的已知问题

  • Dev AccessCLI 工具不支持某些 adb 命令。不受支持的 adb 服务器命令的部分列表为: ppp、反向端口转发、disable/enable-verity、remount、reboot、margin oad、root、unroot、usb 和 tcpip。有关详细信息，请参阅 Android Developer 网站。

  • 将 Dev Access CLI 用于设备时，只能通过 OpenText Functional Testing Lab 远程视图进行访问，但不能通过 OpenText Functional Testing 和 OpenText Functional Testing for Developers 等测试工具进行访问。

  • 对设备使用 Dev Access CLI 时，无法通过服务器的内置 Appium 访问设备，但可以基于 Dev Access CLI 服务使用外部 Appium 服务器访问该设备。

后退到顶部

iOS 上的 Dev AccessCLI 工具的已知问题

  • 目前， Dev Access 功能仅针对本地 Mac 计算机上的 Xcode IDE 进行了认证。其他第三方 IDE 可能会正常工作，但许多行为并不是最佳的。
  • 如果远程访问是通过弱连接或慢速连接进行的，则可能难以在 Xcode 中检索所需的符号和设备支持文件。建议您在 Dev Access 模式下使用设备之前，手动检索所需的设备支持文件夹。
  • 使用 Dev Access CLI 时，将无法访问连接到您的计算机的任何本地 iOS 设备，因为它们已被OpenText Functional Testing Lab 远程设备所替换。
  • 如果未成功停止 Dev AccessCLI 会话，请从设备实验室选项卡的设备页面手动解除设备锁定。

后退到顶部

另请参阅: