本主题包括:

• 安装 Micro Focus UFT 代理 Safari 扩展
• 配置 Micro Focus UFT 代理 Safari 扩展首选项
• 卸载 Micro Focus UFT 代理 Safari 扩展

安装 Micro Focus UFT 代理 Safari 扩展

Micro Focus UFT 代理 Safari 扩展支持 UFT One 测试和侦测在 Safari 浏览器中运行的 Web 应用程序。

要安装 Micro Focus UFT 代理 Safari 扩展，请执行以下操作:

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

2. 配置并启用 Micro Focus UFT 代理 扩展。

   1. 配置 Micro Focus UFT 代理 扩展，请参阅配置 Micro Focus UFT 代理 Safari 扩展首选项。

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

返回页首

配置 Micro Focus UFT 代理 Safari 扩展首选项

此部分介绍如何配置 Micro Focus UFT 代理 扩展首选项。

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

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

   常规	端口: UFT One 与 Micro Focus UFT 代理进行通信的端口。(默认值:8822) 注: 此端口号必须与 UFT One 中定义的端口号匹配，以启动与 Mac 的远程连接。 模式: 选择“UFT”。 新选项卡导航到的 URL: 由 Browser.OpenNewTab 打开的新选项卡自动导航到的 URL。默认值: https://www.microfocus.com 注: URL 必须以 http:// 或 https:// 开头
   UFT 连接	密码短语。启动与 Mac 计算机的远程连接时，UFT One 进行身份验证所必须使用的密码短语。 此字符串必须与在“选项”对话框中 UFT One 的远程连接窗格（工具 > 选项> GUI 测试 > 远程连接）中定义的密码短语匹配。 密码短语可以为空，但难以猜中的较长复杂密码短语更安全。 使用 SSL。指示启动连接到 Mac 计算机时，UFT One 必须使用 SSL。 如果选择该选项，则: 还必须选择使用 SSL 选项（启动远程连接时在 UFT One 中可用）。 您必须指定“SSL 证书文件”和“SSL 私钥文件”的路径以用于通信。 在 UFT One 中 (“工具”>“选项”>“GUI 测试”>“远程连接”)，指定 UFT One 可用于验证“SSL 证书文件”的“CA 证书文件”。
   日志	代理日志级别。保存在 Micro Focus UFT 代理 日志中的信息级别 (例如: Fatal、Error、Warning、Debug)。

3. 单击“应用”以保存更改，然后重新启动 Safari 以使更改生效。

返回页首

卸载 Micro Focus UFT 代理 Safari 扩展

此部分介绍如何删除 Micro Focus UFT 代理 Safari 扩展。

要卸载 Micro Focus UFT 代理 Safari 扩展，请执行以下操作:

1. 退出 Micro Focus UFT 代理 Safari 扩展。

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

返回页首

本主题包括:

安装 Micro Focus UFT 代理 Safari 扩展

在安装 Micro Focus UFT 代理 Safari 扩展之前，必须先安装 UFT 连接代理。

UFT 连接代理 与 Micro Focus UFT 代理 Safari 扩展通信，使 UFT One 能够测试和侦测在 Safari 中运行的 Web 应用程序。

此部分介绍如何安装 UFT 连接代理 和 Micro Focus UFT 代理 Safari 扩展。

先决条件:

• 必须拥有管理员权限才能安装 UFT 连接代理。
• 必须安装 Python 3.8 或更高版本。确保可以通过 /usr/local/bin/python3 命令访问 Python 解释程序。
• 所有使用 UFT 连接代理的 Mac 用户必须已在其 Mac 用户帐户下安装代理。

要安装 UFT 连接代理，请执行以下操作:

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

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

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

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

UFT 连接代理 在安装后和每次重新启动 Mac 计算机后都会自动运行。它一方面与 UFT One 通信，另一方面与 Micro Focus UFT 代理 Safari 扩展通信。

要安装 Micro Focus UFT 代理 Safari 扩展，请执行以下操作:

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

2. 双击 MicroFocusUFTAgent.dmg 镜像文件以安装 Micro Focus UFT 代理 Safari 扩展。

   备注: 您从安装文件夹安装的 Micro Focus UFT 代理 Safari 扩展是未签名版本。每次启动 Safari 时，都必须将 Safari 配置为允许未签名的扩展。

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

   1. 配置代理和扩展首选项.

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

返回页首

配置代理和扩展首选项

此部分介绍如何配置 UFT 连接代理 和 Micro Focus UFT 代理 Safari 扩展首选项以及如何检查或修改 UFT 连接代理 的状态。

配置 UFT 连接代理 首选项

1. 在“系统首选项”中，单击 Micro FocusUFT 连接代理。

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

   Safari 端口	UFT 连接代理 与 Micro Focus UFT 代理 扩展进行通信的端口。(默认值:8823) 注: 也可以在 Micro Focus UFT 代理 首选项中修改此端口号，但是之后需要打开并重新应用 UFT 连接代理 首选项。
   UFT 端口	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 证书。
   日志消息配置	Log 文件夹。用于保存日志文件的位置。 确保您对选定位置具有写入权限。 Agent log level。保存在 UFT 连接代理 日志中的信息级别 (例如: Fatal、Error、Warning、Debug)。 UFT Safari 扩展日志。此设置已废弃。

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

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

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

   提示: 如果要出于任何原因重新启动 UFT 连接代理，请运行以下命令:

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

配置 Micro Focus UFT 代理 Safari 扩展首选项

1. 打开配置对话框:

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

      在可以修改任何设置之前，必须选择指向对话框底部的“配置文件”的路径。

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

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

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

   Safari 端口	UFT 连接代理 与 Micro Focus UFT 代理 扩展进行通信的端口。(默认值:8823) 注: 在 UFT 连接代理 首选项中进行此设置更加方便。如果在 Micro Focus UFT 代理 首选项中修改此端口号，则之后需要打开并重新应用 UFT 连接代理 首选项。
   新选项卡导航到的 URL	由 Browser.OpenNewTab 打开的新选项卡自动导航到的 URL。默认值: https://www.microfocus.com 注: URL 必须以 http:// 或 https:// 开头
   日志消息配置	Agent log level。保存在 Micro Focus UFT 代理 日志中的信息级别 (例如: Fatal、Error、Warning、Debug)。 日志保存在 Users > $HOME > Library > Containers > com.microfocus.uft.agent > Data 文件夹的 SafariAppExtension.log 文件中。确保您拥有此文件夹的写入权限。

3. 单击“应用”以保存更改，然后重新启动 Safari 以使更改生效。

返回页首

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

此部分介绍如何解决使用 UFT 连接代理 时出现的问题。

场景	解决方案
更新代理的首选项后代理处于“未运行”状态	请查看 UFTAgent.log 文件获取问题详细信息。 例如，您指定的端口可能正忙。这些端口可能由另一应用程序使用，或由在另一用户帐户下安装在 Mac 计算机上的 UFT 连接代理使用。 或者，Apple 可能限制了您输入的端口号。请查询 Apple 支持站点上有关受限制或被阻止端口的内容。
UFT One 无法连接到 Mac	请确保 UFT One 中定义的安全设置与 UFT 连接代理 中定义的安全设置匹配。有关更多详细信息，请参见保护与远程 Mac 计算机之间的通信。
UFT One 无法运行测试或无法识别该产品是否已安装在 Mac 上	确保 UFT 连接代理 首选项中定义的“Safari 端口”号与 Micro Focus UFT 代理 扩展中定义的“远程代理端口”号匹配。 确保 UFT 连接代理 首选项中定义的 UFT 端口号与 UFT One 中定义的端口号匹配，以启动与 Mac 的远程连接。 确保未使用 Safari 阻止的端口号。请查询 Apple 支持站点上有关受限制或被阻止端口的内容。
已删除 Micro Focus UFT 代理 扩展或 UFT 连接代理 首选项窗格	在 Mac 上重新安装 UFT 连接代理 重新安装 UFT 连接代理会将其首选项重置为默认值。根据需要确保更新首选项，以便代理首选项和 Safari 扩展中定义了正确的端口号。
日志选项已设置为“关闭”	如果已打开 UFT One Safari 扩展日志，但保存首选项时，日志选项设置为 OFF，请查看 SafariLog.log 文件获取问题详细信息。 例如，这些日志使用的端口为 Safari port + 1。如果此端口正忙，则远程记录器服务将失败。

返回页首

卸载代理和扩展

此部分介绍如何删除 UFT 连接代理和 Micro Focus UFT 代理 Safari 扩展。

要卸载 UFT 连接代理和 Micro Focus UFT 代理 Safari 扩展，请执行以下操作:

1. 卸载 UFT 连接代理: 

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

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

2. 删除 Micro Focus UFT 代理 Safari 扩展: 

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

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

返回页首