# @corva/create-app 中文文档

规范地址：https://npmcn.com/package/%40corva/create-app/

版本：0\.131\.0
npm 元数据更新时间：2026-11-10T11:41:06.932Z
中文译文更新时间：2026-11-10T19:58:45.378Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40corva/create-app
原文对照：https://npmcn.com/package/%40corva/create-app/?lang=original
项目主页：https://github.com/corva-ai/create-corva-app#readme
源码仓库：https://github.com/corva-ai/create-corva-app

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：274 kB，197 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：17 个
- 首次发布：2020-10-05T16:02:24.432Z
- 最新版本发布：2026-11-10T11:41:06.711Z
- 近 30 天下载量：18741（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：592（近 12 个月 33 个）

## 中文简介

在 CORVA 中创建应用程序使用 。 大赦国际

## 安装

```sh
npm install @corva/create-app
```

也可以使用：`pnpm add @corva/create-app`、`yarn add @corva/create-app`、`bun add @corva/create-app`

## README

# @ corva/ 创建- app

应用程序生成器用于 [科瓦.艾岛](https://corva.ai/)。 。 。 .

## 先决条件

-   节点: js 24.22.2或更新([https://nodejs.org/en/download/ (中文(简体) )](https://nodejs.org/en/download/)(中文(简体) )

## 安装

```sh
npm i -g @corva/create-app
```

## 使用量

`corva-create-app` 提供方便用户的 CLI 向导以创建应用程序 .

```sh
Usage: create-corva-app [options] [command]

Options:
  -h, --help                                           display help for command

Commands:
  create [options] [project-directory]                 Create a new app
  zip [options] <project-directory> [patterns...]      Bundle app
  release [options] <project-directory> [patterns...]  Release app
  rerun [options] <project-directory>                  Rerun app
  attach [options] <project-directory>                 Add app to live assets streams
  help [command]                                       display help for command
```

## 创建应用程序

创建新应用 `create` 命令.

```sh
Usage: create-corva-app create <project-directory> [options]

Create a new app

Arguments:
  project-directory               Project directory to work with (default: "Current working dir")

Options:
  --developerName [string]        Enter the Developer Name (default: "O&G Company")
  --developerIdentifier [string]  Enter the Developer Identifier (default: "oandgc")
  --appType                       Choose the App Type (choices: "ui", "scheduler", "stream", "task")
  --schedulerType                 Choose the scheduler type (choices: "1", "2", "4")
  --cronString [string]           Provide CRON string for the scheduler (default: "*/5 * * * *")
  --depthMilestone [number]       Provide depth milestone for the scheduler (default: 1)
  --logType                       Choose the log type (choices: "time", "depth")
  --appName [string]              Enter the App Name (default: "Corva Dev Center App")
  --description [string]          Enter description (default: "This is the description of my app. You can do great things with it!")
  --summary [string]              Enter summary (default: "More information about this app goes here")
  --category [string]             Enter category (default: "")
  --website [string]              Enter website (default: "https://www.oandgexample.com/my-app/")
  --segments                      Choose segments (choices: "drilling", "completion")
  --runtime                       Choose runtime (choices: "ui", "nodejs24.x", "python3.14", "python3.13")
  -p, --packageManager            Please select the desired package manager (choices: "yarn", "npm")
  -t, --useTypescript [boolean]   Would you like to use TypesScript? (default: false)
  --silent [boolean]              Only log result of the operation (default: false)
  --no-dependencies-install       Skip installing dependencies
  --no-git-init                   Skip initializing git repository
```

### 实例

#### 创建 UI 应用程序

```sh
create-corva-app test --appName "Test" --segments "drilling" --category "wellDesign" --appKey "some-company.test.ui" --appType "ui" --runtime "ui"
```

#### 创建节点Js TypeScript应用程序

```sh
create-corva-app test --appName "Test" --segments "drilling" --category "wellDesign" --appKey "some-company.test.scheduler" --appType "scheduler" --runtime "nodejs24.x" -t
```

#### 创建 Python 应用程序

```sh
create-corva-app test --appName "Test" --segments "drilling" --category "analytics" --appKey "some-company.test.stream" --appType "stream" --runtime "python3.14"
```

## 齐普

创建包含应用程序的zip, 准备用于 Corva 用途 `zip` 命令.

```sh
Usage: create-corva-app zip [options] <project-directory> [patterns...]

Bundle app

Arguments:
  project-directory                  Project directory to work with
  patterns                           Additional patterns to zip (default: [])

Options:
  --bump-version <string>            Bump version (choices: "major", "minor", "patch", "skip")
  --ignored-files [ignoredFiles...]  Patterns to skip zip
  --silent [boolean]                 Only log result of the operation (default: false)
```

### 什么是得到拉链?

默认情况下将包含下一份文件 .

对于 `frontend` 应用程序 :

-   `manifest.json`
-   `package.json`
-   `yarn.lock`
-   `.npmrc`
-   `config-overrides.js` (网页软件)
-   `vite.config.mjs`
-   `index.html`
-   `devApp.js`
-   `isolatedApp.js`
-   `vitest.setup.js`
-   `vitest.global-setup.js`
-   下方的所有文件 `src`
-   下方的所有文件 `config`
-   下方的所有文件 `public`
-   `tsconfig.json`

对于写在 `node`数字 :

-   `manifest.json`
-   `package.json`
-   无论是 `package-lock.json` 或者说 `yarn.lock`
-   下方的所有文件 `config` 文件夹
-   全部 `*.js` 文件在 `src` 财务报告和审定财务报表 `lib` 文件夹( 如果 `typescript` 未使用)
-   `tsconfig.json`, (中文(简体) ), `tsconfig.build.json` (如果有的话) `typescript` 用于)
-   全部 `*.ts` 文件在 `src` 财务报告和审定财务报表 `lib` 文件夹( 如果 `typescript` 用于)

对于写在 `python`数字 :

-   `manifest.json`
-   `pyproject.toml`, (中文(简体) ), `uv.lock` (如果应用中存在)
-   全部 `*.py` 文件

如果您想要将一些未包含的文件绑定, 请通过 `patterns` 参数. 请使用 ziping 跳过一些文件 `--ignored-files` 选项.

### 实例

#### 从内容创建 zip 文件 `test-app` 文件夹将zip文件放入其中( p) .

```sh
create-corva-app zip test-app
```

#### 创建 zip 文件自动凸起版本( A)

```sh
create-corva-app zip test-app --bump-version=patch
```

#### 从内容创建 zip 文件 `test-app` 有自定义内容的文件夹( x)[缩写](https://en.wikipedia.org/wiki/Glob_\(programming\)) 支持)

```sh
create-corva-app zip test-app some/missing/file1 some/other/missing/file2 all/files/*.glob
```

## 释放

将应用推到 Corva 使用 `release` 命令.

```sh
Usage: create-corva-app release [options] <project-directory> [patterns...]

Release app

Arguments:
  project-directory            Project directory to work with
  patterns                     Additional patterns to zip (default: [])

Options:
  --bump-version <string>      Bump version (choices: "major", "minor", "patch", "skip")
  --ignored-files [string...]  Patterns to skip zip (default: [])
  --env [string]               Environment to use (choices: "qa", "staging", "production", default: "qa")
  --api-key [string]           Pre generated API key for authorization during app upload
  --app-key [string]           Explicitly set appKey that CLI is going to use. Otherwise it will be taken from manifest.json file. [works only for Front-End apps currently]
  --notes [string]             Add custom notes to published app
  --label [string]             Put a label on the release (choices: "DEV", "BETA", "PROD")
  --remove-on-fail [boolean]   Remove release if it fails during deployment (default: false)
  --silent [boolean]           Only log result of the operation (default: false)
  --remove-on-success          App package (.zip) will not be deleted after upload (default: true)
  --remove-existing [boolean]  If package.json version is already taken - remove the previously published package and upload a new one (default: false)
  --zip-file-name <string>     Upload an existing ZIP without recreating it or bumping its version
  --prebuilt                  Skip the Corva build for an existing ZIP (requires --zip-file-name)
  --author [string]            Author name for the audit
```

### 实例

#### 释放本地制作的软件包

在您自己的 CI 中构建应用程序并安装其依赖性, 然后上传已准备的 ZIP :

```sh
create-corva-app release . --zip-file-name app-prebuilt.zip --prebuilt \
  --env production --api-key "$CORVA_API_KEY" --label BETA --notes "Prebuilt release"
```

CLI 上传 ZIP 不变, 等待部署, 用请求的标签发布 和笔记。 它不构建,安装依赖,凸起版本,或删除所提供的ZIP. 无 `--prebuilt`,Corva使用其正常的构建过程,包括何时 `--zip-file-name` 提供.

保留 `manifest.json` 在项目目录中,以及 `package.json` javaScript 应用程序: CLI 使用 用于识别应用程序的文件 `--remove-existing`,它的版本。 他们必须符合ZIP. 设置最后的应用密钥和版本 **在此之前** 编译 FE 应用程序; 捆绑嵌入此身份 . 与 `--prebuilt`,CLI在联系Corva之前检查了ZIP结构和相关元数据. 它检查根表/应用元数据, FE `app.js`, JavaScript 包版本,和 Python 条目点和 安装依赖性布局。 重复和不安全的归档路径被拒绝 。 元数据文件为 每只限取一米B. 它不改写ZIP或核实进口、嵌入式FE身份或原生 依赖兼容性;部署和运行时间测试仍然需要.

ZIP 条目必须位于归档根上, 没有附加工程文件夹 :

-   **菲欧:** `manifest.json`, (中文(简体) ), `package.json`,和内容 `dist/` (包括 `app.js`,块, 和任何所需资产)。 不包括 `dist/` 本身,源代码, `node_modules/`或离线镜.
-   **Python BE: (英语)** `manifest.json`,在运算表的出入口路径上应用代码, `requirements.txt`,并在 `requirements/`。 。 。 . 构建 Linux 和 Python 版本的依赖性和 CPU 架构在表单中声明; macOS或Windows依赖性可能不会运行于Lambda上. 包含所有运行时间依赖, 因为 Corva跳过依赖性安装.

预建上传仍然使用平台的上传和运行时间限制;这个选项不会增加它们.

#### 发布并请求版本

```sh
create-corva-app release test-app
```

#### 在不增加版本的情况下发布

```sh
create-corva-app release test-app --bump-version=skip
```

#### 用增加的版本发布

```sh
create-corva-app release test-app --bump-version=patch
```

#### 使用自定义版本发布

```sh
create-corva-app release test-app --bump-version=4.2.0
```

#### 使用作者选项发布( 默认情况下它将使用您的 GitHub 用户名)

```sh
create-corva-app release test-app --author=MyName
```

## 常见问题

### @corva/create-app 是什么？

在 CORVA 中创建应用程序使用 。 大赦国际

### 如何安装 @corva/create-app？

在项目目录运行 npm install @corva/create-app，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 create-corva-app，可以用 npx create-corva-app 直接运行。

### @corva/create-app 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/corva\_\_create-app 是否存在。

### @corva/create-app 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @corva/create-app 可以商用吗？

@corva/create-app 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @corva/create-app 的下载量有多少？

根据 npm 官方下载统计，@corva/create-app 在 2026/10/11 – 2026/11/09 这 30 天内被下载 18,741 次，日均约 625 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @corva/create-app 还在维护吗？

最新版本 0\.131\.0 发布于 2026/11/10（今天）；至今共发布 592 个版本，其中过去 12 个月发布了 33 个；首次发布于 2020/10/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。