Studio 用户指南

• 应用程序级别 - 从“设置”>“管理源”选项卡中配置订阅源；
• 项目级别 - 通过功能区中的“管理包”按钮配置订阅源。

• Orchestrator 租户和 Orchestrator 主机 - 如果机器人已连接到 Orchestrator，则会默认添加这些活动订阅源，并且无法禁用它们。只有在 Orchestrator 中启用了租户库订阅源时，才可使用“Orchestrator 租户”选项。这些订阅源具有以下来源：https://[Orchestrator_host]/nuget/activities。

• “本地”- 与 Studio 一起在本地安装的包的订阅源。此订阅源具有来源 %ProgramFiles%\UiPath\Studio\Packages（对于为每台计算机安装）或 %localappdata%\Programs\UiPath\Studio\Packages（对于为每个用户安装）。

  备注：

  对于本地订阅源中的包，“管理包”窗口中显示的发布日期是指 Studio 安装程序的构建日期，而不是包的发布日期。

• 官方 - 官方在线 UiPath 订阅源，从中您可找到我们提供官方支持的活动包。此订阅源具有以下来源：https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json。

• Marketplace - 此公共订阅源包含 UiPath Marketplace 上发布的所有活动。请注意，包是否由 UiPath 构建并提供官方支持，具体列于“管理包”窗口的“包信息”选项卡中。此订阅源具有以下来源：https://gallery.uipath.com/api/v3/index.json。

  请注意，UiPath 不掌控由合作伙伴或 UiPath 市场订阅源社区创建的包的取消列出。不过，UiPath 会使取消列出的包保持活跃，以确保运行时目的所需的向后兼容性。

  所有 UiPath Marketplace 活动均需通过 UiPath 验证，并且必须通过 UiPath Marketplace 安全认证。

  

  备注：

  Studio 升级至更高版本后，订阅源配置将会保留。

• Official US（包括 Automation Cloud for Public Sector）- 官方在线 UiPath 订阅源的副本。此订阅源阻止从美国以外的位置下载包，其来源如下：https://pkgs.dev.azure.com/uipath-us/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json。

添加自定义订阅源​

1. 在“管理包”窗口中，单击“设置”。系统将显示包来源。

   

2. 单击 按钮以向“用户定义的包来源”类别中添加订阅源。

3. 填写包来源的名称或 NuGet 订阅源的名称。

4. 在“来源”字段中，键入本地驱动器文件夹路径、共享网络文件夹路径或 NuGet 订阅源 URL。

5. 单击“添加”。新订阅源会添加到“管理包”窗口的“用户定义的包来源”和“所有包”类别中。默认情况下启用订阅源。

6. 单击“保存”以应用所有更改。

添加安全订阅源​

<packageSources>
  <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
  <add key="FeedName" value="https://FeedSource" />
  </packageSources>
  
 <packageSourceCredentials>
  <FeedName>
    <add key="Username" value="YourUsername" />
    <add key="Password" value="YourPassword" />
  </FeedName>
</packageSourceCredentials>
<packageSources>
  <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
  <add key="FeedName" value="https://FeedSource" />
  </packageSources>
  
 <packageSourceCredentials>
  <FeedName>
    <add key="Username" value="YourUsername" />
    <add key="Password" value="YourPassword" />
  </FeedName>
</packageSourceCredentials>

删除自定义订阅源​

1. 在“设置”类别中，单击“用户定义的包来源”部分下的任何订阅源。

2. 按“删除”按钮。 订阅源已从“所有包”类别和“用户定义的包来源”部分中删除。

3. 单击“保存”以应用更改。

通过代理服务器连接到订阅源​

1. 从 https://www.nuget.org/downloads 下载 nuget.exe。

2. 在存储已下载 nuget.exe 的文件夹中打开命令提示符窗口，然后运行以下命令，配置代理服务器的地址、用户名和密码：

   nuget.exe config -set http_proxy=<http://proxy.server.address:port>

   nuget.exe config -set http_proxy.user=<mydomain\myUserName>

   nuget.exe config -set http_proxy.password=<myPassword>

3. 检查位于 %AppData%\NuGet 的 NuGet.config 文件是否已使用新配置更新：

   assignment

   <config>
       <add key="http_proxy" value="http://proxy.server.address:port" />
       <add key="http_proxy.user" value="mydomain\myUserName" />
       <add key="http_proxy.password" value="myEncryptedPassword" />
   </config>
   <config>
       <add key="http_proxy" value="http://proxy.server.address:port" />
       <add key="http_proxy.user" value="mydomain\myUserName" />
       <add key="http_proxy.password" value="myEncryptedPassword" />
   </config>
   

4. 重新启动 Studio。

管理包​

安装包​

1. 在“管理包”窗口中，选择“所有包”类别。这将打开从您的订阅源收集的所有包的列表。

   

2. 找到要安装的包。请注意，可用的活动包和版本取决于为项目选择的兼容性。

• 向下滚动列表以查找包。

• 通过在搜索栏中键入包的部分名称或说明来搜索包。

• 通过单击搜索栏旁边的“筛选器” 图标，然后仅选择要查看的选项来筛选列表：

  • 包括预发行版 - 包括包的测试版（如果可用）。
  • 仅限 StudioX - 仅列出为 StudioX 设计的包。（此选项仅适用于 StudioX 配置文件）
  • 仅限 UiPath - 仅列出由 UiPath 发布的包。
  • 仅限活动 - 仅列出活动包。
  • 仅限库 - 仅列出库。
  • 仅限用户界面库 - 仅列出从对象存储库发布的“用户界面库”。
  • Compatible Only - List only packages whose latest version is compatible with the project's compatibility. Do not select this option if you want to see packages with older versions that are compatible with the project's compatibility.

3. 选择一个活动包，以查看其说明、版本、依赖项、项目 URL 以及发布日期。

4. 单击“版本”旁边的下拉列表，以选择包的某一版本，然后设置 Runtime 规则。若要进一步阅读有关项目依赖项 Runtime 规则的信息，请查阅“管理依赖项”页面。

5. 单击“安装”按钮。 此外，也可单击名称旁边的 图标，为它标上 图标，使其准备好进行安装。

6. “许可证接受”窗口显示您要安装的每个第三方软件包的许可条款。单击“查看许可证”以阅读许可条款。

   • 单击“我接受”，以同意接受许可条款并安装这个包。

   • 单击“我拒绝”，以取消安装并返回到“管理包”窗口。

     备注：

     在安装 Studio 时，已默认接受 UiPath 包及其依赖项的条款和条件。阅读 UiPath 使用条款和隐私政策。

7. 单击“保存”以安装软件包或更新版本。

   备注：

   如果活动包的安装过程中路径受损，安装不会完成。建议备份并清除下列本地文件夹中的内容：%userprofile%\.nuget\packages 和 %userprofile%\AppData\Local\UiPath\.cache。

   卸载包​

降级软件包​

更改包的下载文件夹​

• 在安装期间，通过在命令行中使用选项 PACKAGES_FOLDER 安装。

• 安装完成后，通过手动编辑 uipath.config 文件：

  1. 在文本编辑器中打开 uipath.config 文件。默认情况下，该文件位于 C:\Program Files\UiPath\Studio。
  2. 在 packageSettings 节点中，添加 packagesInstallationFolder 键，并将新文件夹的路径作为其值。
  3. 保存更改，如果将机器人作为服务安装，请重新启动服务。

 ```
 <packageSettings>
   <add key="packagesInstallationFolder" value="C:\Nuget" />
 </packageSettings>
 ```
 ```
 <packageSettings>
   <add key="packagesInstallationFolder" value="C:\Nuget" />
 </packageSettings>
 ```

在离线环境中管理包​

1. 在可以访问互联网的计算机上，下载并安装 NuGet 包资源管理器。
2. 打开 NuGet 包资源管理器，然后选择“从在线订阅源打开包”。
3. 在“包来源”字段中，输入要从中下载包的订阅源的 URL。官方 UiPath 包订阅源为 https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json。
4. 在订阅源中找到包并下载。
5. 将 NUPKG 文件传输到 Studio 计算机中定义为 Studio 中包源的文件夹中。要将包添加到默认的本地订阅源，请将该文件复制到 %ProgramFiles%\UiPath\Studio\Packages（对于为每台计算机安装）或 %localappdata%\Programs\UiPath\Studio\Packages（对于为每位用户安装）。

将存档与可选软件包一起使用​

• UiPath.MobileAutomation.Activities
• UiPath.Terminal.Activities
• UiPath.Persistence.Activities
• UiPath.PDF.Activities

1. 从 UiPath Customer Portal 下载 ZIP 存档。
2. 将存档放在 Studio 或机器人计算机可访问的位置。
3. 使用以下方法之一添加包：

• 安装过程中 - 在开始安装之前，请将存档放在 Studio MSI 安装程序所在的根文件夹中。安装程序会将包添加到本地订阅源文件夹。
• 安装后 - 默认情况下，将存档的内容解压缩到本地包文件夹：
  • 对于按用户安装模式，文件夹为 %localappdata%\Programs\UiPath\Studio\Packages。
  • 对于按计算机安装模式，文件夹为 %ProgramFiles%\UiPath\Studio\Packages。