在 Mac 上安装和配置 UFT 连接代理

UFT 连接代理是安装在 Apple Mac 计算机上的服务，支持 UFT One 测试和侦测在 Safari 浏览器中运行的 Web 应用程序。UFT 连接代理使用 WebSockets 协议和 UFT One 提供的 Safari 扩展与 Safari 通信。

此任务描述了 UFT 连接代理和 Safari 扩展的安装和配置。

安装 UFT 连接代理

要安装 UFT 连接代理和 Safari 扩展，请按照与您使用的 Safari 版本相关的说明进行操作。

先决条件:

  • 必须拥有管理员权限才能安装 UFT 连接代理。
  • 所有使用 UFT 连接代理的 Mac 用户必须已在其 Mac 用户帐户下安装代理。

运行安装

对于 Safari 13 和 14

对于 Safari 13 和 14，UFT One 使用名为 Micro Focus UFT 代理的 Safari 应用程序扩展。

安装 UFT 连接代理:

  1. 将安装程序图像文件 (UFTConnectionAgentWithSafariAppExtension.dmg) 从“<UFT One 安装文件夹>/Installations/Safari”文件夹复制到 Mac。

  2. 打开 UFTConnectionAgentWithSafariAppExtension.dmg 图像文件。

  3. 双击 UFT Connection Agent.pkg 以启动安装向导。

    在不再支持旧扩展的警告消息上单击“确定”。

安装 Safari 应用程序扩展:

  1. 从 Mac App Store 安装 Micro Focus UFT 代理 扩展 (需要 Apple ID 登录信息)。

  2. 配置并启用 Micro Focus UFT 代理:

    1. 配置 UFT 连接代理 首选项。

    2. 在 Safari 的“首选项”>“扩展”选项卡中，选中扩展列表中 Micro Focus UFT 代理扩展对应的复选框。

对于 Safari 12

安装 UFT 连接代理:

  1. 将安装程序图像文件 (UFTConnectionAgent.dmg) 从“<UFT One 安装文件夹>/Installations/Safari”文件夹复制到 Mac。

  2. 打开 UFTConnectionAgent.dmg 图像文件。

  3. 双击 UFT Connection Agent.pkg 启动安装向导以安装 UFT 连接代理。

    如果系统提示您从 Safari App Store 安装扩展，请单击“取消”。

安装 Safari 扩展:

  1. 从 UFTConnectionAgent.dmg 图像文件中，将 SafariUFT.safariextension 文件复制到 Mac:

    要获取此文件，请解压缩并打开以下各层: UFTConnectionAgent.dmg > Micro Focus UFT Connection Agent Installation > UFT Connection Agent.pkg > Payload > SafariUFT.safariextz > SafariUFT > SafariUFT.safariextension。

  2. 在 Safari 中，添加 SafariUFT.safariextension 文件 (“开发”->“显示扩展生成器”->“添加扩展”)。

  3. 在 Safari 扩展列表中找到并运行“运行 Functional Testing 代理”(“Safari”->“首选项”->“扩展”) 。

    注: 您每次关闭并重新打开 Safari 且想再次使用测试代理时，都需要再次运行代理。

对于 Safari 11 或更早版本

  1. 将安装程序图像文件 (UFTConnectionAgent.dmg) 从“<UFT One 安装文件夹>/Installations/Safari”文件夹复制到 Mac。

  2. 打开 UFTConnectionAgent.dmg 图像文件。

  3. 双击 UFT Connection Agent.pkg 以启动安装向导。如果系统提示您从 Safari App Store 安装扩展，请单击“取消”。

    此操作将同时安装 UFT 连接代理和 Unified Functional Testing 代理 Safari 扩展。

返回页首

配置 UFT 连接代理 首选项

要检查或修改 UFT 连接代理的状态，或要更新其首选项，请执行以下步骤: 

  1. 打开配置对话框:

    Safari 13 和 14

    在 Applications 文件夹中，双击 Micro Focus UFT 代理。

    在修改任何设置之前，必须选择“配置文件”的路径。

    单击“选择”，浏览到以下文件路径: Users > $HOME > Library > UFTDaemon > RemoteAgentConfig.xml，然后单击“打开”。(如果将 UFT Connection Agent.pkg 安装在非默认位置，请浏览所使用的安装文件夹中的文件。)

    注: 在某些情况下，在选择此文件之前，在 Micro Focus UFT 代理 配置对话框看不到任何值。
    Safari 12 及更早版本

     打开“系统首选项”，然后双击 UFT 连接代理。

  2. 可以修改以下任一首选项 (分别针对每位 Mac 用户):

    Connection Port Numbers

    • Safari port。UFT 连接代理 与 Unified Functional Testing 代理 Safari 扩展进行通信的端口。 (默认值: 8823)

      Safari 12 及更早版本: 此端口号必须与 Safari Unified Functional Testing 代理扩展中定义的 Remote Agent Port 号匹配。

    • UFT port。UFT One 与 UFT 连接代理进行通信的端口。 (默认值: 8822)

      此端口号必须与 UFT One 中定义的端口号匹配，以启动与 Mac 的远程连接。
    Security Configuration

    • 密码短语。启动与 Mac 计算机的远程连接时，UFT One 进行身份验证所必须使用的密码短语。

      此字符串必须与在“选项”对话框中 UFT One 的远程连接窗格 (工具 > 选项> GUI 测试 > 远程连接) 中定义的密码短语匹配。

      密码短语可以为空，但难以猜中的较长复杂密码短语更安全。

    • 使用 SSL。指示启动连接到 Mac 计算机时，UFT One 必须使用 SSL。

      如果选择该选项，则:

      • 还必须选择使用 SSL 选项 (启动远程连接时在 UFT One 中可用) 。

      • 必须指定要用于通信的 SSL 证书文件及其SSL 私钥的路径。

        当 UFT 连接代理设置连接时，必须能够访问这些文件。 (链证书文件亦受支持)

      • 在 UFT One 中 (工具 > 选项 > GUI 测试 > 远程连接) ，指定从 UFT 连接代理 中接收时，UFT One 可用于验证 SSL 证书文件的 CA 证书。
    日志消息配置

    Safari 13 和 14:

    Agent log level。代理日志中保存的信息级别 (例如: Fatal、Error、Warning、Debug)。

    日志保存在 Users > $HOME > Library > Containers > com.microfocus.uft.agent > Data 文件夹的 SafariAppExtension.log 文件中。确保您拥有此文件夹的写入权限。

    Safari 12 及更早版本:

    • Log 文件夹。保存活动日志消息的文件夹。

      确保您拥有此文件夹的写入权限。

    • Agent log level。代理日志中保存的信息级别 (例如: Fatal、Error、Warning、Debug)。

      日志保存在指定文件夹的 UFTAgent.log 文件中。

    • UFT One Safari 扩展日志。指定除了 UFT 连接代理日志以外，是否还维护 Unified Functional Testing 代理 Safari 扩展活动日志。 (默认值: OFF) 。
      除非支持人员要求，否则无需打开这些日志。

      此日志保存在同一文件夹的 SafariLog.log 文件中。

      要激活 Unified Functional Testing 代理 Safari 扩展日志，还必须在 Safari 扩展的首选项中选择 Enable Remote Logging。

  3. 确保关闭 Safari 浏览器，然后单击 Apply Save，以保存更改并使用新的首选项重新启动代理。

    • Safari 13 和 14: 运行以下命令以重新启动 UFT 连接代理，使您的更改生效:

      $ launchctl unload $HOME/Library/LaunchAgents/com.hp.osx.uft.daemon.plist
      $ launchctl load $HOME/Library/LaunchAgents/com.hp.osx.uft.daemon.plist

    • 代理的状态显示在 UFT 连接代理 首选项窗格中。

      检查状态以确保代理使用新首选项运行成功。如果不成功，请查看 UFTAgent.log 文件获取问题详细信息。

    • Safari 12 及更早版本: 如果将 UFT One Safari extension logs 选项设置为 ON，但记录 Safari 扩展活动的远程记录器服务无法运行，则此选项会自动设置回 OFF。查看 SafariLog.log 文件获取问题详细信息。

返回页首

在 Safari 中配置 Unified Functional Testing 代理扩展 (Safari 12 或更早版本)

  1. 在 Safari 中打开 Unified Functional Testing 代理扩展。

    1. 选择 Safari > 偏好设置
    2. 在“首选项”对话框中，选择扩展选项卡。
    3. 在对话框左窗格的“扩展”列表中，选择 Unified Functional Testing 代理扩展。

  2. 可以在右窗格中修改以下任一首选项:

    远程代理端口

    UFT 连接代理与 Safari 浏览器进行通信的端口号。 (默认值: 8823)

    警告: 此端口号必须与在 UFT 连接代理首选项中定义的 Safari 端口号匹配。
    Show Object Spy popover when Spy starts: 如果您已关闭 UFT One 启动侦测器会话时 Safari 上的通知显示功能，则可使用此选项将其重新打开。
    与维护 Unified Functional Testing 代理 Safari 扩展活动的日志有关的选项

    与维护 Unified Functional Testing 代理 Safari 扩展活动的日志有关的选项。除非支持人员要求，否则无需修改这些选项。

    • Default Logging Level。保存在 Unified Functional Testing 代理 Safari 扩展日志文件中的信息级别。 (All、Trace、Debug、Info、Warn、Error、Fatal、Off)

    • Enable Remote Logging。指定除了 UFT 连接代理日志以外，是否还维护 Unified Functional Testing 代理 Safari 扩展活动日志。 (默认情况下，此选项未选中。)

      此日志与 UFT 连接代理日志保存在同一文件夹的 SafariLog.log 文件中。

      要激活 Unified Functional Testing 代理 Safari 扩展日志，还必须在 UFT 连接代理首选项中选择 UFT One Safari Extension logs 选项。

    • 将 Logging Exceptions 框留空。此框仅供支持人员使用。

返回页首

对 UFT 连接代理进行疑难解答

  • 如果更新首选项后代理仍为未运行状态，请查看 UFTAgent.log 文件获取问题详细信息。

    例如，您指定的端口可能正忙。这些端口可能由另一应用程序使用，或由在另一用户帐户下安装在 Mac 计算机上的 UFT 连接代理使用。

    或者，Apple 可能限制了您输入的端口号。请查询 Apple 支持站点上有关受限制或被阻止端口的内容。

  • 如果 UFT One 无法连接到 Mac，请确保 UFT One 中定义的安全设置与 UFT 连接代理 中定义的安全设置匹配。有关更多详细信息，请参见保护与远程 Mac 计算机之间的通信。

  • 如果 UFT One 无法在 Safari 运行测试或无法识别该产品已安装在 Mac 上:

    • 确保 UFT 连接代理首选项中定义的 Safari 端口号与 Unified Functional Testing 代理扩展中定义的远程代理端口号匹配。

      确保 UFT 连接代理 首选项中定义的 UFT 端口号与 UFT One 中定义的端口号匹配，以启动与 Mac 的远程连接。

    • 确保未使用 Safari 阻止的端口号。请查询 Apple 支持站点上有关受限制或被阻止端口的内容。

  • 如果手动从 Safari 或“系统首选项”的 UFT 连接代理首选项窗格删除 Unified Functional Testing 代理扩展，则可通过在 Mac 上重新安装 UFT 连接代理来重新安装扩展。

    重新安装 UFT 连接代理会将其首选项重置为默认值。根据需要确保更新首选项，以便代理首选项和 Safari 扩展中定义了正确的端口号。

  • 如果已打开 UFT One Safari 扩展日志，但保存首选项时，日志选项设置为 OFF，请查看 SafariLog.log 文件获取问题详细信息。

    例如，这些日志使用的端口为 Safari port + 1。如果此端口正忙，则远程记录器服务将失败。

    返回页首

卸载 UFT 连接代理

要同时删除 UFT 连接代理和 UFT One 的 Safari 扩展，请执行以下步骤:

对于 Safari 11

  1. 打开 UFTConnectionAgent.dmg 图像文件。

  2. 双击“卸载”以从 Mac 中删除代理。

对于 Safari 12

  1. 卸载 UFT 连接代理: 

    1. 打开 UFTConnectionAgent.dmg 图像文件。

    2. 双击“卸载”以从 Mac 中删除代理。

  2. 在 Safari 中，从扩展生成器 (“开发”->“显示扩展生成器”) 中删除 Functional Testing 代理。

对于 Safari 13 和 14

  1. 卸载 UFT 连接代理: 

    1. 打开 UFTConnectionAgentWithSafariAppExtension.dmg 图像文件。

    2. 双击“卸载”以从 Mac 中删除代理。

  2. 删除 Safari App 扩展: 

    1. 退出 Micro Focus UFT 代理应用程序。

    2. 在 Applications 文件夹中，删除 Micro Focus UFT 代理。

注释: 如果卸载代理时 Safari 或“系统偏好设置”窗格处于打开状态，则重新打开后卸载操作才会生效。

返回页首

另请参见: