初始化编码应用程序项目

在 Studio Web 解决方案中初始化编码应用程序项目，在您自己的本地项目中构建应用程序，并使用 UiPath CLI 将其推送到 Studio Web。

由于编码应用程序源代码是在本地 IDE 中编写，因此在 Studio Web 中处理编码应用程序项目遵循两个不同步骤：在 Studio Web 中的解决方案中初始化项目，然后从您自己的本地项目构建并推送其源代码。

在 Studio Web 中初始化编码应用程序项目

以创建任何其他 Studio Web 项目的相同方式初始化项目：

1. 转到 Studio Web 中的“云工作区”或“本地工作区”页面。

2. 在页面的右上角，选择“新建” 。

3. 在“开始构建”对话框中的“构建块”下，选择“应用程序” 。

   

4. 在“ 新建应用程序 ”屏幕上的“从头开始构建”下，选择“ 编码应用程序 ” 。

   

Studio Web 使用默认名称（App、App 1、App 2 等）创建项目。您可以将其重命名为更有意义的名称，也可以保留默认名称。

此时，编码应用程序项目包含一个文件 webAppManifest.json，其中描述了项目的类型和配置。目前没有源代码、模板或框架框架 — 您需要从自己的本地项目中获取这些内容。

在 Studio Web 中审核项目

初始化后，Studio Web 会在解决方案的项目列表中显示编码应用程序项目。打开该包将显示设置页面，其中包含指向 SDK 文档的链接以及从 IDE 同步代码所需的 CLI 命令：

在此屏幕中，您可以访问：

• 项目概述— 名称、当前版本和所属的解决方案。
• 来源— 推送代码后，Studio Web 在此处以只读模式显示上次推送的来源。Studio Web 不提供浏览器内代码编辑器；请使用本地 IDE 进行所有编辑。
• 资源— 推送包含bindings_v2.json文件的代码后，Studio Web 会在此处显示已注册的资源，并让您将已声明的每个资源映射到 Orchestrator 实体。请参阅绑定和运行时资源。

在本地构建应用程序

要开发应用程序的源代码，请执行以下操作：

1. 使用您选择的框架（React、Vue、Angular 或任何生成静态浏览器资产的框架）在 IDE 中创建一个本地项目。
2. 使用框架的工具链（例如 npm run build）构建应用程序，该工具链会生成应用程序将在运行时提供的可部署工件。

如果应用程序在运行时调用 UiPath 资源，请在已构建的工件旁边添加一个 bindings_v2.json 文件，以声明每个资源。请参阅绑定和运行时资源。

提示：

如果您使用 UiPath 编码智能体，请调用 uipath-coded-apps 技能——该技能会搭建项目框架，生成 bindings_v2.json，并使其与代码引用的资源保持同步。

将应用程序推送到 Studio Web

本地内部版本准备就绪后，使用 UiPath CLI 将其推送到 Studio Web 项目中：

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

该命令会将构建输出目录（默认为 dist）上传到 Studio Web。如果您的框架在其他位置构建，请使用 --build-dir <dir> 覆盖目录。

如果您尚未初始化项目，push 会交互式提示您创建一个项目，并将生成的 UIPATH_PROJECT_ID 保存至 .env，以供后续推送。

推送时，Studio Web：

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

有关完整的 CLI 参考和往返命令，请参阅在 IDE 中工作。