- 入门指南
- 使用编码Apps
- 构建并部署编码 Apps
- Sample Coded Apps
- 常见问题
- Studio Web 中的编码 Apps
- Coded Action Apps
构建和部署编码应用程序
在 UiPath 中构建和部署编码应用程序：开始之前的准备、该应用程序如何在 IDE 中构建，以及如何将其发布到 Orchestrator 文件夹。
编码应用程序首先是开发者在自己的 IDE 中编写的网页应用程序，最后是用户从 UiPath URL 打开的应用程序。本页介绍该旅程以及在 UiPath 中进行的部署步骤。
该流程包括四个阶段：
- 在 IDE 中定义应用程序逻辑
- 与 UiPath 建立安全连接。
- 将应用程序部署到 Orchestrator。
- 访问 UiPath 生态系统中的应用程序。
在开始之前
在 Automation Cloud（专属）和 Test Cloud（专属）中，请对1.202.0 、UiPath CLI 版本执行pack 、 publish 、 deploy和push步骤，直到您的专属生产环境升级到 9 月 24 日的 Apps 版本， 2026。更高的 CLI 版本包含与当前在“专用”环境中运行的 Apps 版本不兼容的重大更改。在专用生产环境升级到 2026 年 9 月 24 日的 Apps 版本后，您可以使用更高版本的 UiPath CLI。
有关故障排除的信息，请参阅为什么uip codedapp命令在 Automation Cloud (专属) 中失败？ 。
确保满足以下条件：
- 包含 Node.js 20.x 或更高版本和 npm 的本地开发环境，用于构建应用程序和安装 UiPath 工具。从nodejs.org下载安装程序，其中包括 npm。要查看已安装的内容，请运行
node -v和npm -v。 - 安装了
codedapp工具的 UiPath CLI。有关安装说明，请参阅UiPath CLI指南。 - 在您的组织中注册的外部应用程序中的外部应用程序 ID。应用程序使用它来登录用户并代表用户调用 UiPath 服务。编码应用程序在浏览器中运行，无法存储应用程序密码，因此需要将其注册为具有用户作用域的非机密应用程序。要注册一个，请参阅 《Automation Cloud 管理员指南》中的“添加外部应用程序” 。
- 在您作为目标的 Orchestrator 文件夹中发布包和部署应用程序的权限。
构建应用程序
开发者可以在自己选择的框架（例如 React、Vue 或 Angular）中构建应用程序，就像构建任何网页应用程序一样。UiPath 为该工作流添加了两点：
- 与您组织的连接。项目根目录的配置文件用于标识您的组织、租户和外部应用程序 ID。UiPath TypeScript SDK 会读取此配置，因此应用程序可以调用 UiPath 服务，例如 Orchestrator、资产、存储桶和流程。
- 本地开发设置。当应用程序在开发者计算机上运行时，项目构建工具的 UiPath 插件会提供相同的配置，因此可以在部署应用程序之前，在真实租户上进行测试。
两者都是项目的一次性设置。有关完整的开发者设置，包括配置文件、构建工具插件以及应用程序在打包之前所需的调整，请参阅 SDK 文档中的编码 Apps 入门。
部署应用程序
部署分两个部分：开发者打包并发布应用程序，然后将该包部署到 Orchestrator 文件夹。
打包并发布应用程序
编码应用程序作为.nupkg包发布到 Orchestrator，这与自动化使用的包格式相同。
-
构建应用程序：
npm run buildnpm run build -
将构建输出打包：
uip codedapp pack dist -n <appName> --version 1.0.0uip codedapp pack dist -n <appName> --version 1.0.0 -
登录到您的 UiPath 组织：
uip loginuip login -
将包发布到租户订阅源或个人工作区订阅源：
uip codedapp publishuip codedapp publish -
部署应用程序：
uip codedapp deployuip codedapp deploy
有关每个命令的完整参数列表，请参阅 UiPath CLI 指南中的uip codedapp 。
从 Orchestrator 部署应用程序
如果包已发布，或者您不希望使用命令行，请改为从 Orchestrator 部署应用程序。
- 在 Orchestrator 中，转到“租户” > “包” 。
- 选择“上传” ，然后上传由
uip codedapp pack创建的.nupkg文件。有关详细过程，请参阅管理包。 - 转到要部署应用程序的文件夹，然后转到“自动化” > “Apps” 。
- 选择“部署应用程序” ，然后选择您的应用程序及其版本。有关详细过程，请参阅管理应用程序。
从 Studio Web 部署应用程序
如果应用程序在 Studio Web 解决方案中构建为编码应用程序项目，则与该解决方案一起打包和部署，而不是单独打包和部署。编码应用程序的版本与其依赖的工作流、智能体和资源保持一致。
-
在本地构建应用程序，然后将其推送到 Studio Web 项目：
uip codedapp push --project-id <project-id>uip codedapp push --project-id <project-id> -
在 Studio Web 中，打开解决方案，然后选择“部署” 。
-
设置包版本，选择是打包到个人工作区还是共享工作区，为部署命名，选择文件夹，然后选择部署。
有关部署面板中的完整选项，请参阅《Studio Web 用户指南》中的发布和部署解决方案。
您的应用程序现在可在https://<orgName>.uipath.host/<appName>使用。