UIP 编码应用程序推送

“uip codedapp push”的语法和选项，用于将本地源代码上传到 Studio Web 编码应用程序项目。

uip codedapp push uploads local source to a Studio Web project. It uploads the build output in --build-dir (default dist) and the project's source files from the project root, after an optional resource import. Use it to ship local edits back to a project that was originally pulled from Studio Web.

大纲

uip codedapp push [options]

选项

标记	描述
--project-id <id>	WebApp project ID. When omitted, read from the UIPATH_PROJECT_ID environment variable, then from UIPATH_PROJECT_ID in the .env file. Refer to Project ID.
--solution-name <name>	Name of the Studio Web solution to create when no project ID is set. Goes with --project-name.
--project-name <name>	Name of the coded app project to create in that solution when no project ID is set. Goes with --solution-name.
--build-dir <dir>	构建输出目录。默认值： dist 。
--ignore-resources	跳过导入引用资源的步骤。
--allow-large-files	Allow pushing files between 2 MB and 10 MB without a confirmation prompt. Required in non-interactive runs when any file is 2 MB or larger.
-v, --version <version>	设置显式代码版本（例如2.0.0 ）。
--verbose	显示详细进度日志。
--base-url <url>	UiPath 基本 URL（身份验证覆盖）。
--org-id <id>	组织 ID（身份验证覆盖）。
--tenant-id <id>	租户 ID（身份验证覆盖）。
--access-token <token>	访问令牌（身份验证覆盖）。

项目 ID

push uploads into an existing Studio Web project. It takes the project ID from the first of these that is set: --project-id, the UIPATH_PROJECT_ID environment variable, or UIPATH_PROJECT_ID in the .env file of the current directory.

When none is set, push creates a new Studio Web solution with a coded app project in it, and saves the new project ID as UIPATH_PROJECT_ID in .env, so the next push reuses it:

• With --solution-name and --project-name, it creates the solution and project with those names, without prompting.
• At an interactive terminal without them, it asks whether to create a new solution or use an existing one, and prompts for any missing name.
• In a non-interactive run, both names are required. Without them, push fails and names the options to pass.

Passing --solution-name or --project-name while a project ID is set from any of the three sources is refused, so a push never goes to an existing project when you asked for a new one.

Excluding files

push reads exclusion patterns from .gitignore and .uipignore in the project root. .uipignore uses the same syntax as .gitignore, and its patterns take precedence when the two files disagree. The following are always excluded, with or without an ignore file:

• node_modules/ 和 .uipath/
• .gitignore、.uipignore、.gitkeep
• .env files, including .env.local, .env.*.local, .env.development, .env.production, .env.test, and .env.example
• Any other file or folder whose name starts with a dot

File checks

Before uploading, push checks every file it would send:

选中	结果
File extension not in the allowed set of web-related types	Push blocked. The disallowed files are listed.
File of 10 MB or larger	Push blocked.
File of 2 MB or larger, below 10 MB	Interactive: confirmation prompt. Non-interactive: push blocked unless you pass --allow-large-files.
action-schema.json present and invalid	Push blocked.

示例

# Push from the default ./dist build directory
uip codedapp push --project-id a1b2c3d4-0000-0000-0000-000000000001

# Custom build directory and explicit version
uip codedapp push --project-id a1b2c3d4-0000-0000-0000-000000000001 \
    --build-dir build \
    --version 2.0.0

# Push files between 2 MB and 10 MB without a prompt (CI)
uip codedapp push --project-id a1b2c3d4-0000-0000-0000-000000000001     --allow-large-files

# First push: create a new Studio Web solution and coded app project (CI)
uip codedapp push --solution-name "Finance Apps" --project-name "InvoiceViewer"

# Skip resource imports
uip codedapp push --project-id a1b2c3d4-0000-0000-0000-000000000001 \
    --ignore-resources

数据形状（--输出 json）

{
  "Code": "PushCompleted",
  "Data": { "message": "Push completed successfully." }
}

A failed push returns Result: "Failure" with Message: "Push failed" and the cause in Instructions.

相关内容

• uip codedapp pull — 在编辑之前将远程项目提取到本地磁盘。
• uip codedapp pack — 在推送内部版本后，将其打包以供发布。

另请参阅

• 编码 Apps 工具概述
• 全局选项
• 退出代码