Studio 用户指南

上次更新日期 2024年11月18日

关于发布自动化项目

发布自动化项目意味着将项目文件夹存档，以便将其发送到机器人，然后执行。

默认情况下，将发布项目文件夹中的所有文件，测试用例除外。如果要防止已发布的包中包含特定文件，请在“项目”面板中右键单击该文件，然后选择“从发布中忽略”（不适用于库项目中的工作流文件）。对于库，要防止在项目中安装已发布的库时，工作流文件在“活动”面板中显示为可重用组件，请在“项目”面板中右键单击该文件，然后选择“设为私有”。

您可以将自动化项目发布到 Orchestrator、自定义 NuGet 订阅源或在本地发布。发布到 Orchestrator 后，已归档的项目将显示在“包”页面上，您可以创建要分发给机器人的流程。当您将自动化流程发布到 Orchestrator 个人工作区或发布测试用例时，如果一个流程不存在，则会自动创建一个流程，并且现有流程会自动更新为最新发布的版本。

此外，自动化项目可以发布到自定义 NuGet 订阅源，如果订阅源需要身份验证，还可以使用添加 API 密钥的选项。

如果在本地发布项目，那么会要求您在本地计算机上提供与发布流程包的位置不同的路径。从这里开始，您之后可以手动将包发送给机器人，这样就可以执行包了。默认的本地发布位置是 %ProgramData%\\UiPath\\Packages。

您可以通过 Studio 或命令行发布项目。要更新多个项目的依赖项并一次发布所有依赖项，请使用项目依赖项批量更新工具。

从 Studio 发布项目

要发布项目，请在 Studio 的“设计”选项卡功能区中选择“发布”。请注意，如果 project.json 文件位于只读位置，则无法发布自动化项目。

要发布自动化项目，请执行以下操作：

在 Studio 中，创建一个新项目。
在“设计”功能区选项卡中，单击“发布”。系统将打开“发布”窗口。请注意，窗口的标题栏会根据上下文发生变化：
- 发布流程（发布流程时）；
- 发布库（发布库项目时）；
- 发布用户界面库项目时发布用户界面库；
- 发布测试用例（发布测试用例时）。
- 发布模板时发布模板。
在“包属性”选项卡中：
- 输入包名称。下拉列表最多包含您先前发布的包的 5 个最新名称。
- 在“版本”部分，查看项目的“当前版本”，并根据需要键入“新版本”。选中“为预发行版”方框以将该版本标记为 alpha。请注意，这会自动将项目的版本架构更改为语义架构。在本地发布文件的新版本时，请确保自定义位置中并未包含使用相同拟定版本号的文件。有关项目版本控制的更多详细信息，请参阅关于自动化项目页面。
- （可选）使用“项目图标”选项定义项目的自定义图标。您可以浏览并选择一个文件，或者为大小至多 1MB 的 ico、jpeg、jpg 或 png 文件输入路径或公共 URL。
  
  项目发布后，图标显示如下：
  - 对于进程，在“进程名称”旁的“助手”中显示，以便更轻松地在进程列表中识别进程。
  - 对于模板，在“主页（Studio 后台视图）”>“模板”中的模板旁边显示。
  - 对于库，该图标将在 Studio 中“管理包”窗口中的程序包旁显示。
    
    注意：如果将本地文件用于发布到 Orchestrator 的库或不支持嵌入式图标的订阅源，则此图标在“管理包”中不可见。在这种情况下，请使用 URL 指明该图标。
- 在“发行说明”文本框中，输入有关版本的详细信息以及其他相关信息。已发布项目的发行说明可在 Orchestrator 的“包”部分中查看。请注意，“发行说明”字段最多可接受 10,000 个字符。
单击“下一步”。

如果要发布模板，则接下来要打开“模板信息”选项卡（步骤 5）。否则，请继续执行步骤 6。
（仅适用于模板）在“模板信息”选项卡中，提供以下信息，然后单击“下一步”：
- 名称 - 模板的名称。
- 说明 - 模板选项卡中的模板说明。
- 默认项目名称 - 使用此模板创建新项目时的默认项目名称。
  
  注意：请避免在文件名中使用标点符号、分隔符和不允许的字符。使用模板时，可以从默认名称中删除这些字符。
- 默认项目说明 - 使用此模板创建新项目时的默认说明。
在“发布选项”选项卡中，选择发布项目的位置。可用的选项取决于您要发布的项目的类型：
- 对于流程（包括 StudioX 项目）：
  - Orchestrator 租户流程订阅源、Orchestrator 个人工作区订阅源，以及文件夹层次结构的订阅源（如果是具有单独包订阅源的第一级文件夹，或者如果从 Studio 状态栏的文件夹菜单中选择了该文件夹的子文件夹）。如果 Studio 已连接到 Orchestrator，则这些选项可用。仅当您的用户在 Orchestrator 中启用了个人工作区功能时，“Orchestrator 个人工作区订阅源”才可用。
    
    如果在 Studio 中选择了“个人工作区”或具有单独包订阅源的层次结构中的文件夹，则该文件夹的订阅源是默认选项。否则，租户订阅源是默认选项。如果您已在当前会话中发布项目，则在您关闭 Studio 或从 Studio 状态栏更改 Orchestrator 文件夹之前，系统会默认选择您上次使用的发布位置。
  - “Assistant（机器人默认值）”- 机器人和 Assistant 的默认包位置，C:\ProgramData\UiPath\Packages。此处发布的项目会自动显示在 Assistant 中。如果 Studio 连接到 Orchestrator，则该选项不可用。
  - 自定义 - 自定义 NuGet 订阅源 URL 或本地文件夹。添加 API 密钥是可选的。
- 对于测试用例：
  - 可用于流程的相同选项，但 Orchestrator 个人工作区订阅源除外。
- 对于库和用户界面库：
  - Orchestrator 租户库订阅源或 Orchestrator 共享库订阅源 - 在 Studio 连接到 Orchestrator 时可用。可用选项取决于是否已在 Orchestrator 中启用租户库订阅源。
  - 自定义 - 自定义 NuGet 订阅源 URL 或本地文件夹。添加 API 密钥是可选的。
- 对于模板：
  - Orchestrator 租户库订阅源或 Orchestrator 共享库订阅源 - 在 Studio 连接到 Orchestrator 时可用。可用选项取决于是否已在 Orchestrator 中启用租户库订阅源。
  - 本地 - 默认情况下，在本地发布模板的位置：C:\Users\User\Documents\UiPath\.templates。
  - 自定义 - 自定义 NuGet 订阅源 URL 或本地文件夹。添加 API 密钥是可选的。
如果要发布库或任何具有 Windows 或跨平台兼容性（模板除外）的项目，则可以在“编译设置”下的“发布选项”选项卡中使用其他设置：
- （仅适用于库） 活动根类别 - 输入类别的名称，在该类别下可重用组件将在“活动”面板中列出。
- 包含源 - 选择此选项以打包发布的包中的所有 .xaml 源，包括先前设为私有的工作流。对于 Windows - 旧版库，这些文件保存在生成的程序集文件和 .nupkg 文件的 lib\net45 文件夹中。对于 Windows 和跨平台库与流程，文件将保存在 .nupkg 文件的 content 文件夹中。
- （仅适用于 Windows 旧版库） 编译活动表达式 - 选择此选项可编译并打包所有活动表达式。这可缩短执行时间。
- （对于 Windows - 仅限旧版库） 准备运行 - 选择此选项可优化生成的程序集，以便在运行时更快地进行 JIT 编译。
  
  注意：要找出可能导致库无法成功发布的原因，请阅读发布库时的限制。
单击“下一步”进入“证书签名”选项卡，或单击“发布”以发布您的项目。
（可选）在“证书签名”选项卡中，在“证书”框旁边添加本地证书路径。此外，根据需要添加“证书密码”和“可选证书时间戳记程序”。如需更多详细信息，请查阅为包签名页面。

注意：目前，接受将 .pfx 和 .p12 证书扩展程序用于为项目签名。
单击“发布”。系统会创建一个 NUPKG 文件，并将其上传到 Orchestrator（自定义 NuGet 订阅源），或保存在本地目录中。根据项目的不同，包中包含：
- 对于模板项目和 Windows - 旧版流程，为项目源文件。
- 对于具有 Windows 或跨平台兼容性的库和项目，经过编译的 DLL 文件。
如果项目已成功发布，则将显示“信息”对话框，并且项目将复制到 UiPath.settings 文件中的 NuGetServerUrl 参数中设置的 NuGet 位置。

系统将显示“信息”对话框：

包发布时采用的名称。
包发布时采用的版本号。
如果是在本地或在机器人默认位置发布项目，则其即为项目的发布位置。单击路径可转至包，除非发布位置是 Orchestrator。
“详情”选项中会列出已发布的项目文件的名称列表。
“复制到剪贴板”选项。

在发布过程中添加的信息（例如发布位置）将会保留在窗口中，以便将其用于后续针对同一类型项目执行的发布操作。每次单击“发布”时，都会创建项目的新版本，并将其发送到包订阅源。发布到安全订阅源时，可以通过机器人密钥、Orchestrator 凭据、Windows 身份验证或 API 密钥进行身份验证。

重要提示：已发布的项目一定不能解压缩。要进行任何更改，请在 Studio 中打开最初的 .xaml 文件执行更改，然后再次发布项目。

通过命令行发布项目

可以使用 UiPath.Studio.CommandLine.exe 发布命令发布项目。

UiPath.Studio.CommandLine.exe 位于安装文件夹中：

对于基于计算机的安装，默认路径为 C:\Program Files\UiPath\Studio\。
对于基于用户的安装，默认路径为 %localappdata%\Programs\UiPath\Studio\。

以下参数可用于发布命令：

参数	描述
-p, --project-path	要发布的 project.json 的路径。此为必选参数。
-g, --target	发布项目的位置：自定义 - 自定义 URL 或本地文件夹。使用“-f”、“--feed”参数定义位置。机器人 - 机器人的默认发布位置（如果未连接到 Orchestrator）。不适用于发布库或模板。 Orchestrator 租户 - Orchestrator 租户流程订阅源（对于流程和测试用例）或 Orchestrator 库订阅源（对于库和模板）。 Orchestrator 个人文件夹 - Orchestrator 个人工作区订阅源。不适用于发布库、模板或测试用例。 Orchestrator 文件夹层次 - 如果是有单独包订阅源的一级文件夹，或者如果在 Studio 状态栏中，一个文件夹的子文件夹是从文件夹菜单中选择的，则为该文件夹层次结构的订阅源。不适用于发布库或模板。
-f, --feed	用于发布项目的自定义 URL。这也可以是自定义本地目录，类似于 Studio 中“ 发布选项 ”选项卡中的路径。
-a, --api-key	用于发布项目的 API 密钥。此参数可用于自定义目标。
-i, --icon	用于包的自定义图标的路径。
-n, --notes	包含引入到项目中的更改的发行说明。
-v, --new-version	项目的新版本。如果未提供，版本将自动递增。
-t, --timeout	指定发布项目的超时值。默认超时为 30 秒。此设置仅适用于指示将包传输到 Orchestrator 的持续时间。
--cer-path	用于包签名的证书的本地路径。
--cer-password	证书的密码。
--timestamper-url	时间戳记程序的 URL。
--incl-all-feeds	非必填。
--help	查看可用于每个命令的参数。
版本	检查 UiPath.Studio.CommandLine.exe 的版本。

例如：

以下命令将示例流程发布到 Orchestrator 租户流程订阅源：

UiPath.Studio.CommandLine.exe publish --project-path "C:\Users\username\Documents\UiPath\Sample\project.json"--target OrchestratorTenant --notes "Fixed a couple of bugs."
以下命令会将相同流程发布到本地文件夹：

UiPath.Studio.CommandLine.exe publish --project-path "C:\Users\username\Documents\UiPath\Sample\project.json"--target Custom --feed "C:\Users\username\Desktop\myfeed" --notes "Fixed a couple of bugs."

有关 CommandLine.exe 实用程序的更多信息，请参见批量更新命令行参数。

在此页面上