Robot 开发者指南

上次更新日期 2025年9月10日

配置步骤

先决条件

为使自动化项目受益于 Robot JavaScript SDK，需要满足以下先决条件：

安装 2021.10 或更高版本的 Studio 和机器人
在机器人计算机上安装 UiPath JavaScript 插件

允许访问

运行 UiPath 机器人 JavaScript 加载项时，您需要提供对自定义应用程序或网页的访问权限，以连接到机器人。

访问由两步对话框处理。必须确认这两个步骤才能运行 RobotJS。它们可以自动化，如下所述。

浏览器访问对话框

此步骤是指浏览器请求打开 UiPath Assistant 的权限。

自动接受“浏览器访问权限”对话框

可以通过在浏览器设置中添加 uipath-web://* 值作为受信任（允许）的 URL 来自动化此操作。 uipath-web://* 是指 UiPath 机器人网页协议处理程序。

注意：根据所使用的浏览器，需要配置不同的设置。例如，如果您使用的是 Google Chrome，请按照 Google Chrome URL 白名单文档中所述的步骤操作。

Robot JavaScript SDK

该 SDK 提供可以包含在自定义应用程序或网页中的所有必要方法和属性。您可以通过下列方式下载它：

NPM

npm 包可用于 TypeScript 绑定。要将其包含在项目中，您需要在项目目录的根目录中执行以下命令：

npm install --save @uipath/robotnpm install --save @uipath/robot

CDN

如果是 CDN，则需要在关闭 </body> 标签之前将 SDK 包含在其中。

<body>
...
...
<script href="//download.uipath.com/js/1.3.2/UiPathRobot.js"></script>
</body><body>
...
...
<script href="//download.uipath.com/js/1.3.2/UiPathRobot.js"></script>
</body>

直接下载

您也可以通过直接下载获取 Robot JavaScript SDK。

插件设定

要更改加载项设置，您需要在安装文件夹的uipath.config文件中添加ListenerPort和TokenExpiryInDays参数。默认情况下，该部分不包含任何键。

配置文件需要包含以下内容：

<robotJsSettings>
    <add key="ListenerPort" value="2323" />
    <add key="TokenExpiryInDays" value="30" />
</robotJsSettings><robotJsSettings>
    <add key="ListenerPort" value="2323" />
    <add key="TokenExpiryInDays" value="30" />
</robotJsSettings>

属性	描述
`ListenerPort`	`UiPath.RobotJS.ServiceHost.exe` 在已配置的端口上启动 Http 侦听器，其中包含该系统上活动用户会话中其他本地侦听器的相关信息。请注意，此处的端口值必须与“SDK 设置”中配置的端口值相符。
`TokenExpiryInDays`	来自新域的任何请求都需要获得用户的同意，以允许从网页应用程序访问 UiPath 机器人。这些同意在此设置中提到的上述天数内有效。