Dev AccessCLI 工具

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

将 Dev Access 用于设备时，只能通过 Digital Lab 中的远程视图访问设备，而不能通过 OpenText 集成测试工具访问。

在本主题中:

AndroidDev AccessCLI 工具的先决条件

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

• 计算机上必须存在 AndroidADB 组件。如果在计算机 , 上安装了 Digital Lab 连接器，则默认 ADB 位置为 C:\Program Files\UFT Digital Lab 连接器 \connector\android-sdk-windows\platform-tools.
• 需要具备 ADB 的基本知识。有关详细信息，请参阅 Android 开发人员文档中的 Android 调试桥。
• 端口 5037 必须可用。此端口可能由 Digital 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. 控制台将打开，并提示您输入用于 Dev 访问 Digital Lab 的凭据。如果您还没有执行密钥，请生成一个。有关更多详细信息，请参阅生成和管理访问密钥。
6. 粘贴执行密钥并按输入，或键入login-c " your execution key" 再次登录。
7. 控制台欢迎您。

与您的设备交互

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

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

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

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

   

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

3. 与设备交互:

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

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

   • 对于 Android 设备通过 AndroidStudio:

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

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

后退到顶部

Dev AccessCLI 命令

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

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

命令	详细信息
登录	日志到 Digital Lab 服务器。您需要执行密钥才能执行此操作。 例如:login-c" my execution key"。
注销	日志来自 Digital Lab 服务器。此命令没有参数。
列表	根据指定的参数列出信息: 设备。列出所有设备及其平台、名称、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|ndash; v true - n adb.version-v 38 - n adb.port-v 5038 |ndash; n adb.exec|ndash; v c: /folder/adb.exe 例如，如果控制台警告您的 ADB 版本与 Digital Lab 服务器的版本不匹配，则使用 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。有关详细信息，请参阅 AndroidDeveloper 网站。

• 将 Dev Access CLI 用于设备时，只能通过 Digital Lab 中的远程视图访问它，而不能通过 UFT 和 UFT 开发人员等测试工具访问它

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

后退到顶部

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

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

后退到顶部

另请参阅:

• 管理设备
• 设备访问窗口