Studio
2022.10
False
横幅背景图像
Studio 用户指南
上次更新日期 2024年4月3日

关于发布自动化项目

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

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

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

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

如果在本地发布项目,那么会要求您在本地计算机上提供与发布流程包的位置不同的路径。从这里开始,您之后可以手动将包发送给机器人,这样就可以执行包了。默认的本地发布位置是 %ProgramData%\UiPath\Packages
要发布项目,项目文件夹中的 project.jsondesign.json 文件不得位于只读位置(例如,如果项目受源代码管理,则您必须签出文件以进行编辑)。

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

从 Studio 发布项目

要发布项目,请在Studio 的“设计”选项卡功能区中选择“发布”。



要发布自动化项目,请执行以下操作:

  1. 在 Studio 中,创建一个新项目。
  2. 在“设计”功能区选项卡中,单击“发布”。系统将打开“发布”窗口。请注意,窗口的标题栏会根据上下文发生变化:
    • 发布流程(发布流程时);
    • 发布库(发布库项目时);
    • 发布用户界面库项目时发布用户界面库;
    • 发布测试用例(发布测试用例时)。
    • 发布模板时发布模板
  3. 在“包属性”选项卡中:
    • 输入包名称。下拉列表最多包含您先前发布的包的 5 个最新名称。
    • 在“ 版本 ” 部分中,查看项目的“ 当前版本 ”,并在需要时键入 “新版本” 。 选中“ 为预发行 版” 框以将该版本标记为 alpha。 请注意,这会自动将项目的版本架构更改为语义架构。 在本地发布文件的新版本时,请确保自定义位置中未包含具有相同拟定版本号的文件。 有关项目版本控制的更多详细信息,请查看 关于自动化项目 页面。
    • (可选)使用“项目图标”选项定义项目的自定义图标。您可以浏览并选择一个文件,或者为大小至多 1MB 的 jpegjpgpng 文件输入路径或公共 URL。

      项目发布后,图标显示如下:

      • 对于进程,在“进程名称”旁的“助手”中显示,以便更轻松地在进程列表中识别进程。
      • 对于模板,在“主页(Studio 后台视图)”>“模板”中的模板旁边显示。
      • 对于库,该图标将在 Studio 中“管理包”窗口中的程序包旁显示。

        注意:如果将本地文件用于发布到 Orchestrator 的库或不支持嵌入式图标的订阅源,则此图标在“管理包”中不可见。在这种情况下,请使用 URL 指明该图标。
    • 在“项目标签”对话框中,您可以通过创建新标签或重用 Orchestrator 中已定义的标签来向项目添加一个或多个标签。标签有两种类型:“标签”和“属性”(键值对)。标签包含在已发布的包中,它们有助于描述项目并对其进行分类。例如,它们可以引用自动化应用程序(Excel 标签)或部门(department:accounting 键值属性)。
      当您开始输入时,系统会根据已定义的标签建议可能的匹配项,您可以通过从匹配项列表中选择一个标签来重复使用它。对于属性匹配,首先显示后跟 :(冒号)字符的键,并在选择键后显示关联的值。要添加新标签,请在输入名称后,单击名称旁边带有加号的条目。通过使用 :(冒号)字符分隔字符串,您可以添加属性,而不包含 : 的条目则可以添加标签。
      标签和键值属性不得超过 256 个字符。 标签名称不能包含以下字符:<>%&\?/:

      项目标签可以自动应用于 Orchestrator 中的流程。有关使用标签的更多信息,请参阅 Orchestrator 指南中的“使用标签组织资源”

    • 在“发行说明”文本框中,输入有关版本的详细信息以及其他相关信息。已发布项目的发行说明可在 Orchestrator 的“”部分中查看。请注意,“发行说明”字段最多可接受 10,000 个字符。



  4. 单击“下一步”

    如果要发布模板,则接下来要打开“模板信息”选项卡(步骤 5)。否则,请继续执行步骤 6。

  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 编译。

      注意:要找出可能导致库无法成功发布的原因,请阅读发布库时的限制


  7. 单击“下一步”进入“证书签名”选项卡,或单击“发布”以发布您的项目。
  8. (可选) 在“ 证书签名 ” 选项卡中,在“ 证书 ” 框旁边添加本地“证书路径”。 此外,根据需要添加 证书密码 和可选的证书 时间戳记程序 。 有关更多详细信息,请查看为 包签名 页面。


    注意:目前,接受将 .pfx.p12 证书扩展程序用于为项目签名。
  9. 单击“发布”。系统会创建一个 NUPKG 文件,并将其上传到 Orchestrator(自定义 NuGet 订阅源),或保存在本地目录中。根据项目的不同,包中包含:
    • 对于具有 Windows - 旧版兼容性的模板项目和流程,为项目源文件。
    • 对于具有 Windows 或跨平台兼容性的库和项目,经过编译的 DLL 文件。
  10. 如果项目已成功发布,则将显示“信息”对话框,并且项目将复制到 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 实用程序的更多信息,请参见批量更新命令行参数

  • 从 Studio 发布项目
  • 通过命令行发布项目

此页面是否有帮助?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath 白色徽标
信任与安全
© 2005-2024 UiPath. All rights reserved.