在 IDE 中工作

使用 UiPath CLI 将本地构建的编码应用程序推送到 Studio Web，并在需要同步时将上次推送的源拉取回本地文件夹。

由于编码应用程序的源代码是在本地编写的，因此您的大多数工作都在自己的 IDE 中进行。UiPath CLI 通过两个命令将该本地工作流与 Studio Web 项目桥接：

• uip codedapp push — 将本地构建的应用程序上传到 Studio Web 项目中。
• uip codedapp pull — 将上次推送的源代码从 Studio Web 项目提取到本地文件夹中。

您无需在首次推送之前拉取。如果您已经准备好本地项目，请直接推送该项目。如果未提供项目 ID，push 会以交互方式提示在 Studio Web 中创建新的编码应用程序项目，并将生成的 UIPATH_PROJECT_ID 保存到 .env 以供以后推送。

先决条件

• Node.js 20.x 或更高版本。
• UiPath CLI。使用 npm install -g @uipath/cli 在全局范围内安装。
• 对目标 UiPath 组织进行身份验证：uip login。这将创建.env CLIUIPATH_ORG_ID UIPATH_TENANT_ID为 、 和UIPATH_ACCESS_TOKEN 读取的 文件。
• 已在 Studio Web 的解决方案中初始化的编码应用程序项目（或让 push 以交互方式创建一个解决方案）。请参阅初始化编码应用程序项目。

推送本地构建的应用程序

生成构建输出（例如 npm run build）后，从项目根目录运行：

uip codedapp push --project-id <project-id>

该命令会将构建输出目录（默认为 dist）上传到 Studio Web 项目。

如果在 UIPATH_PROJECT_ID 中设置了 .env（无论是来自之前的自动创建还是手动），您可以省略该标志：

uip codedapp push

选项

选项	描述	默认
--project-id <id>	“Studio Web”项目 ID。	读取 UIPATH_PROJECT_ID 中的 .env 中的内容。如果缺少，则以交互方式自动创建。
--build-dir <dir>	构建要上传的输出目录。	dist
--ignore-resources	跳过导入应用程序引用的资源的步骤。	false
--verbose	显示详细进度日志。	false

推送时，Studio Web：

• 存储推送路径中的每个文件，并在项目的“源代码”视图下以只读模式显示这些文件。
• 读取bindings_v2.json （如果推送内容的根目录中存在），并在项目的“资源”面板下注册每个已声明的资源。

拉取上次推送的来源

当您需要将上次推送的来源恢复到本地文件夹时（例如，在团队成员推送更改后，或重置本地工作副本），请使用 pull：

uip codedapp pull --project-id <project-id> --target-dir ./my-coded-app

选项

选项	描述	默认
--project-id <id>	“Studio Web”项目 ID。	读取 UIPATH_PROJECT_ID 中的 .env 中的内容。
--target-dir <dir>	要向其中写入拉取文件的本地目录。	当前目录。
--overwrite	覆盖现有文件，而无需提示。	false
--verbose	显示详细进度日志。	false

此命令会将上次推送的内容与推送时完全相同，写入目标文件夹。

备注：

uip codedapp pull 检索已推送的文件，而不是任何本地缓存的依赖项或构建工具。拉取依赖项后，在运行应用程序之前重新安装依赖项（例如 npm install）。

与团队成员协作处理同一项目

编码应用程序项目没有内置的合并机制。如果两个开发者并行推送到同一个项目，则第二个推送会覆盖第一个推送。要安全地进行协调，请执行以下操作：

• 将 Git 而非 Studio Web 项目视为源代码的事实来源。
• 从已知的 Git 提交推送到 Studio Web，最好作为受控发布流程的一部分。
• 使用 uip codedapp pull 检查 Studio Web 中推送的内容，然后将其覆盖。

有关完整的 CLI 参考，请参阅uip codedapp push和uip codedapp pull 。