Dev AccessCLI 工具

使用 Dev Access 命令行界面工具,可以将设备从 UFT Mobile 实验室路由到 IDE 以及在 ADB (用于 Android)或 iDevice (用于 iOS)上构建的其他开发和调试工具。

将 Dev Access 用于设备时,只能通过 UFT Mobile 中的远程视图访问设备,而不能通过 Micro Focus 集成测试工具访问。

”注意:“在使用 Dev Access 之前,请停止计算机上的连接器。有关详细信息,请参阅 开始,停止并重新启动连接器

AndroidDev AccessCLI 工具的先决条件

请遵循以下准则:

  • 计算机上必须存在 Android”ADB“ 组件。如果在计算机上安装了 UFT Mobile 连接器,则默认的 ADB 位置为 ”C:\Program Files\UFT MobileConnector\connector\android-sdk-windows\platform-tools“。
  • 需要具备 ADB 的基本知识。有关详细信息,请参阅 Android 开发人员文档中的 Android 调试桥。
  • 端口 037 必须可用。此端口可能由 UFT Mobile 服务器或连接器使用,因此请确保在要运行 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 访问 UFT Mobile 的凭据。如果您还没有执行密钥,请生成一个。有关更多详细信息,请参见 生成和管理访问键(非共享空间管理用户)
  6. 粘贴执行密钥并按输入,或键入 login-c ” your execution key“ 再次登录。
  7. 控制台欢迎您。

与您的设备交互

控制台打开且已连接到 UFTM 服务器后,可以使用 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 列出可用命令。

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

登录

日志到UFT Mobile 服务器。您需要执行密钥才能执行此操作。

例如:login-c" my execution key"

注销

日志来自 UFT Mobile 服务器。此命令没有参数。

列表

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

  • ”设备。“列出所有设备及其平台、名称、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 版本与 UFTM 服务器的版本不匹配,则使用 ”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 AccessCLI 用于设备时,只能通过 UFT Mobile 中的远程视图访问它,而不能通过 UFT、UFT开发人员 等测试工具访问它。

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

后退到顶部

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

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

后退到顶部

另请参见: