# @adobe/aio-cli-plugin-app 中文文档

规范地址：https://npmcn.com/package/%40adobe/aio-cli-plugin-app/

版本：14\.10\.0
npm 元数据更新时间：2026-10-01T01:32:03.857Z
中文译文更新时间：2026-11-05T20:33:26.067Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40adobe/aio-cli-plugin-app
原文对照：https://npmcn.com/package/%40adobe/aio-cli-plugin-app/?lang=original
项目主页：https://github.com/adobe/aio-cli-plugin-app
源码仓库：https://github.com/adobe/aio-cli-plugin-app

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

- 包体积（解压后）：447 kB，67 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.17\.0
- 运行依赖：42 个
- 首次发布：2019-11-12T10:06:42.280Z
- 最新版本发布：2026-09-28T08:06:15.881Z
- 近 30 天下载量：26062（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：176（近 12 个月 21 个）

## 中文简介

创建、构建和部署 Adobe I/O 应用程序

## 安装

```sh
npm install @adobe/aio-cli-plugin-app
```

也可以使用：`pnpm add @adobe/aio-cli-plugin-app`、`yarn add @adobe/aio-cli-plugin-app`、`bun add @adobe/aio-cli-plugin-app`

## README

# aio-cli-plugin-app 软件

创建、构建和部署 Adobe I/O Apps

[![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io/) [![Version](https://img.shields.io/npm/v/@adobe/aio-cli-plugin-app.svg)](https://npmjs.org/package/@adobe/aio-cli-plugin-app) [![Downloads/week](https://img.shields.io/npm/dw/@adobe/aio-cli-plugin-app.svg)](https://npmjs.org/package/@adobe/aio-cli-plugin-app) ![Node.js CI](https://github.com/adobe/aio-cli-plugin-app/workflows/Node.js%20CI/badge.svg) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) [![Codecov Coverage](https://img.shields.io/codecov/c/github/adobe/aio-cli-plugin-app/master.svg?style=flat-square)](https://codecov.io/gh/adobe/aio-cli-plugin-app/)

-   [aio-cli-plugin-app 软件](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-cli-plugin-app)
-   [使用量](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-usage)
-   [图标](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-commands)

# 使用量

```sh-session
$ aio plugins:install -g @adobe/aio-cli-plugin-app
$ # OR
$ aio discover -i
$ aio app --help
```

# 图标

-   [`aio app`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app)
-   [`aio app add`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-add)
-   [`aio app add action`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-add-action)
-   [`aio app add ci`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-add-ci)
-   [`aio app add event`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-add-event)
-   [`aio app add extension`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-add-extension)
-   [`aio app add service`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-add-service)
-   [`aio app add web-assets`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-add-web-assets)
-   [`aio app build`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-build)
-   [`aio app clean`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-clean)
-   [`aio app create [PATH]`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-create-path)
-   [`aio app delete`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-delete)
-   [`aio app delete action [ACTION-NAME]`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-delete-action-action-name)
-   [`aio app delete ci`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-delete-ci)
-   [`aio app delete extension`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-delete-extension)
-   [`aio app delete service`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-delete-service)
-   [`aio app delete web-assets`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-delete-web-assets)
-   [`aio app deploy`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-deploy)
-   [`aio app get-url [ACTION]`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-get-url-action)
-   [`aio app info`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-info)
-   [`aio app init [PATH]`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-init-path)
-   [`aio app install PATH`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-install-path)
-   [`aio app list`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-list)
-   [`aio app list extension`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-list-extension)
-   [`aio app logs`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-logs)
-   [`aio app pack [PATH]`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-pack-path)
-   [`aio app run`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-run)
-   [`aio app test`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-test)
-   [`aio app undeploy`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-undeploy)
-   [`aio app use [CONFIG_FILE_PATH]`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app/#readme-aio-app-use-config_file_path)

## `aio app`

创建、运行、测试和部署 Adobe I/O Apps

```
USAGE
  $ aio app [-v] [--version] [--config-validation]

FLAGS
  -v, --verbose                 Verbose output
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --version                 Show version

DESCRIPTION
  Create, run, test, and deploy Adobe I/O Apps
```

_参见代码 : [src/commands/app/index.js (中文(简体) )](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/index.js)_

## `aio app add`

在现有 Adobe I/O App 中添加新组件

```
USAGE
  $ aio app add [-v] [--version] [--config-validation]

FLAGS
  -v, --verbose                 Verbose output
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --version                 Show version

DESCRIPTION
  Add a new component to an existing Adobe I/O App
```

_参见代码 : [src/commands/app/add/index.js (中文(简体) )](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/add/index.js)_

## `aio app add action`

添加新动作

```
USAGE
  $ aio app add action [-y] [-e <value>] [--install] [-v] [--version] [--config-validation]

FLAGS
  -e, --extension=<value>       Add actions to a specific extension
  -v, --verbose                 Verbose output
  -y, --yes                     Skip questions, and use all default values
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --[no-]install            [default: true] Run npm installation after files are created
      --version                 Show version

DESCRIPTION
  Add new actions


ALIASES
  $ aio app add actions
```

_参见代码 : [src/commands/app/add/action.js (中文(简体) )](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/add/action.js)_

## `aio app add ci`

添加 CI 文件

```
USAGE
  $ aio app add ci [-v] [--version] [--config-validation]

FLAGS
  -v, --verbose                 Verbose output
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --version                 Show version

DESCRIPTION
  Add CI files
```

_参见代码 : [src/commands/app/add/ci.js (中文(简体) )](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/add/ci.js)_

## `aio app add event`

添加新的 Adobe I/O 事件动作

```
USAGE
  $ aio app add event [-y] [-e <value>] [--install] [-v] [--version] [--config-validation]

FLAGS
  -e, --extension=<value>       Add events to a specific extension
  -v, --verbose                 Verbose output
  -y, --yes                     Skip questions, and use all default values
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --[no-]install            [default: true] Run npm installation after files are created
      --version                 Show version

DESCRIPTION
  Add a new Adobe I/O Events action


ALIASES
  $ aio app add events
```

_参见代码 : [sc/命令/应用程序/添加/活动js](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/add/event.js)_

## `aio app add extension`

为工程添加新的扩展名

```
USAGE
  $ aio app add extension [-y] [-e <value>...] [--install] [-v] [--version] [--config-validation]

FLAGS
  -e, --extension=<value>...    Specify extensions to add, skips selection prompt
  -v, --verbose                 Verbose output
  -y, --yes                     Skip questions, and use all default values
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --[no-]install            [default: true] Run npm installation after files are created
      --version                 Show version

DESCRIPTION
  Add new extensions to the project


ALIASES
  $ aio app add ext
  $ aio app add extensions
```

_参见代码 : [sc/命令/应用程序/添加/扩展.js](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/add/extension.js)_

## `aio app add service`

订阅当前工作空间的服务

```
USAGE
  $ aio app add service [-v] [--version] [--config-validation] [--use-jwt]

FLAGS
  -v, --verbose                 Verbose output
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --use-jwt                 if the config has both jwt and OAuth Server to Server Credentials (while migrating),
                                prefer the JWT credentials
      --version                 Show version

DESCRIPTION
  Subscribe to Services in the current Workspace


ALIASES
  $ aio app add services
```

_参见代码 : [src/commands/app/add/ service.js (中文(简体) )](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/add/service.js)_

## `aio app add web-assets`

添加网络资产支持

```
USAGE
  $ aio app add web-assets [-y] [-e <value>] [--install] [-v] [--version] [--config-validation]

FLAGS
  -e, --extension=<value>       Add web-assets to a specific extension
  -v, --verbose                 Verbose output
  -y, --yes                     Skip questions, and use all default values
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --[no-]install            [default: true] Run npm installation after files are created
      --version                 Show version

DESCRIPTION
  Add web assets support
```

_参见代码 : [src/commands/app/add/web-ass.js (中文(简体) )](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/add/web-assets.js)_

## `aio app build`

构建 Adobe I/O App

```
USAGE
  $ aio app build [-v] [--version] [--config-validation] [--actions | -a <value>...] [--web-assets]
    [--force-build] [--content-hash] [--web-optimize] [-e <value>... | ]

FLAGS
  -a, --action=<value>...       Build only a specific action, the flags can be specified multiple times, this will set
                                --no-publish
  -e, --extension=<value>...    Build only a specific extension point, the flags can be specified multiple times
  -v, --verbose                 Verbose output
      --[no-]actions            [default: true] Build actions if any
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --[no-]content-hash       [default: true] Enable content hashing in browser code
      --[no-]force-build        [default: true] Force a build even if one already exists
      --version                 Show version
      --[no-]web-assets         [default: true] Build web-assets if any
      --web-optimize            [default: false] Enable optimization (minification) of js/css/html

DESCRIPTION
  Build an Adobe I/O App

  Build the actions and web assets for an Adobe I/O App. Build is optimized to only build what is necessary.
  Use the --force-build flag to force a build even if one already exists.
```

_参见代码 : [src/命令/应用程序/构建.js](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/build.js)_

## `aio app clean`

从本地机器上取出所有建筑文物

```
USAGE
  $ aio app clean [-v] [--version] [--config-validation]

FLAGS
  -v, --verbose                 Verbose output
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --version                 Show version

DESCRIPTION
  Remove all build artifacts from the local machine
  This command completely cleans all build artifacts from the dist directory including:
  - Action build files
  - Web assets (both production and development)
  - Build tracking files
  - Deployment tracking files

  Note that this will require a full rebuild on your next build command.
```

_参见代码 : [src/commands/app/clean.js (中文(简体) )](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/clean.js)_

## `aio app create [PATH]`

创建一个带有默认参数的新 Adobe I/O App

```
USAGE
  $ aio app create [PATH] [-v] [--version] [--config-validation] [-i <value>]

ARGUMENTS
  [PATH]  [default: .] Path to the app directory

FLAGS
  -i, --import=<value>          Import an Adobe I/O Developer Console configuration file
  -v, --verbose                 Verbose output
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --version                 Show version

DESCRIPTION
  Create a new Adobe I/O App with default parameters
```

_参见代码 : [src/commands/app/create.js (中文(简体) )](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/create.js)_

## `aio app delete`

从现有的 Adobe I/O App 中删除一个组件

```
USAGE
  $ aio app delete [-v] [--version] [--config-validation]

FLAGS
  -v, --verbose                 Verbose output
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --version                 Show version

DESCRIPTION
  Delete a component from an existing Adobe I/O App
```

_参见代码 : [src/commands/app/delete/index.js (中文(简体) )](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/delete/index.js)_

## `aio app delete action [ACTION-NAME]`

删除已存在的动作

```
USAGE
  $ aio app delete action [ACTION-NAME] [-y] [-v] [--version] [--config-validation]

ARGUMENTS
  [ACTION-NAME]  Action `pkg/name` to delete, you can specify multiple actions via a comma separated list

FLAGS
  -v, --verbose                 Verbose output
  -y, --yes                     Skip questions, and use all default values
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --version                 Show version

DESCRIPTION
  Delete existing actions


ALIASES
  $ aio app delete actions
```

_参见代码 : [src/commands/app/delate/ action.js (中文(简体) )](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/delete/action.js)_

## `aio app delete ci`

删除已存在的 CI 文件

```
USAGE
  $ aio app delete ci [-y] [-v] [--version] [--config-validation]

FLAGS
  -v, --verbose                 Verbose output
  -y, --yes                     Skip questions, and use all default values
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --version                 Show version

DESCRIPTION
  Delete existing CI files
```

_参见代码 : [src/commands/app/delete/ci.js (中文(简体) )](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/delete/ci.js)_

## `aio app delete extension`

删除现有的扩展

```
USAGE
  $ aio app delete extension [-y] [--install] [-e <value>...] [-v] [--version] [--config-validation]

FLAGS
  -e, --extension=<value>...    Specify extensions to delete, skips selection prompt
  -v, --verbose                 Verbose output
  -y, --yes                     Skip questions, and use all default values
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --[no-]install            [default: true] Run npm installation after files are created
      --version                 Show version

DESCRIPTION
  Delete existing extensions


ALIASES
  $ aio app delete ext
  $ aio app delete extensions
```

_参见代码 : [src/命令/应用程序/删除/扩展.js](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/delete/extension.js)_

## `aio app delete service`

删除当前工作空间中的服务

```
USAGE
  $ aio app delete service [-v] [--version] [--config-validation] [--use-jwt]

FLAGS
  -v, --verbose                 Verbose output
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --use-jwt                 if the config has both jwt and OAuth Server to Server Credentials (while migrating),
                                prefer the JWT credentials
      --version                 Show version

DESCRIPTION
  Delete Services in the current Workspace


ALIASES
  $ aio app delete services
```

_参见代码 : [src/commands/app/delete/ service.js (中文(简体) )](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/delete/service.js)_

## `aio app delete web-assets`

删除已存在的网络资产

```
USAGE
  $ aio app delete web-assets [-y] [-v] [--version] [--config-validation]

FLAGS
  -v, --verbose                 Verbose output
  -y, --yes                     Skip questions, and use all default values
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --version                 Show version

DESCRIPTION
  Delete existing web assets
```

_参见代码 : [src/commands/app/delete/web-ass.js (中文(简体) )](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/delete/web-assets.js)_

## `aio app deploy`

部署 Adobe I/O App

```
USAGE
  $ aio app deploy [-v] [--version] [--config-validation] [--actions | -a <value>...] [--web-assets] [--build]
    [--force-build | ] [--content-hash] [--open] [-e <value>... | ] [--force-deploy | --publish | --force-publish]
    [--force-events |  | ] [--web-optimize] [--log-forwarding-update]

FLAGS
  -a, --action=<value>...           Deploy only a specific action, the flags can be specified multiple times, this will
                                    set --no-publish
  -e, --extension=<value>...        Deploy only a specific extension, the flags can be specified multiple times
  -v, --verbose                     Verbose output
      --[no-]actions                [default: true] Deploy actions if any
      --[no-]build                  [default: true] Run the build phase before deployment
      --[no-]config-validation      [default: true] Validate the app configuration file(s) before continuing.
      --[no-]content-hash           [default: true] Enable content hashing in browser code
      --[no-]force-build            [default: true] Force a build even if one already exists
      --force-deploy                [default: false] Force deploy changes, regardless of production Workspace being
                                    published in Exchange.
      --[no-]force-events           [default: false] Force event registrations and delete any registrations not part of
                                    the config file
      --force-publish               [default: false] Force publish extension(s) to Exchange, delete previously published
                                    extension points
      --[no-]log-forwarding-update  [default: true] Update log forwarding configuration on server
      --open                        Open the default web browser after a successful deploy, only valid if your app has a
                                    front-end
      --[no-]publish                [default: true] Publish extension(s) to Exchange
      --version                     Show version
      --[no-]web-assets             [default: true] Deploy web-assets if any
      --web-optimize                [default: false] Enable optimization (minification) of web js/css/html

DESCRIPTION
  Deploy an Adobe I/O App

  Deploys the actions and web assets for an Adobe I/O App.
  This will also build any changed actions or web assets before deploying.
  Use the --force-build flag to force a build even if one already exists.
  Deploy is optimized to only deploy what is necessary. Be aware that deploying actions will overwrite any previous
  deployments.
  Use the --force-deploy flag to force deploy changes, regardless of production Workspace being published in Exchange.
```

_参见代码 : [src/命令/应用程序/部署.js](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/deploy.js)_

## `aio app get-url [ACTION]`

获取动作 URL

```
USAGE
  $ aio app get-url [ACTION] [-v] [--version] [--config-validation] [--cdn] [-j] [-h] [-y]

FLAGS
  -h, --hson                    Output human readable json
  -j, --json                    Output json
  -v, --verbose                 Verbose output
  -y, --yml                     Output yml
      --cdn                     Display CDN based action URLs
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --version                 Show version

DESCRIPTION
  Get action URLs
```

_参见代码 : [src/commands/app/get-url.js (韩语)](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/get-url.js)_

## `aio app info`

显示 Adobe I/O App 在使用的设置/配置

```
USAGE
  $ aio app info [-v] [--version] [--config-validation] [-j | -h | -y] [--mask]

FLAGS
  -h, --hson                    Output human readable json
  -j, --json                    Output json
  -v, --verbose                 Verbose output
  -y, --yml                     Output yml
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --[no-]mask               Hide known private info
      --version                 Show version

DESCRIPTION
  Display settings/configuration in use by an Adobe I/O App
```

_参见代码 : [src/commands/app/info.js (中文(简体) )](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/info.js)_

## `aio app init [PATH]`

创建新的 Adobe I/O App

```
USAGE
  $ aio app init [PATH] [--install] [-v] [--version] [--config-validation] [-y] [--login] [-e <value>... | -t
    <value>... | --repo <value>] [--standalone-app |  | ] [--template-options <value>] [-o <value> | -i <value> | ] [-p
    <value> |  | ] [-w <value> |  | ] [--confirm-new-workspace] [--use-jwt] [--github-pat <value> ] [--linter
    none|basic|adobe-recommended]

ARGUMENTS
  [PATH]  [default: .] Path to the app directory

FLAGS
  -e, --extension=<value>...        Extension point(s) to implement
  -i, --import=<value>              Import an Adobe I/O Developer Console configuration file
  -o, --org=<value>                 Specify the Adobe Developer Console Org to init from (orgId, or orgCode)
  -p, --project=<value>             Specify the Adobe Developer Console Project to init from (projectId, or projectName)
  -t, --template=<value>...         Specify a link to a template that will be installed
  -v, --verbose                     Verbose output
  -w, --workspace=<value>           [default: Stage] Specify the Adobe Developer Console Workspace to init from,
                                    defaults to Stage
  -y, --yes                         Skip questions, and use all default values
      --[no-]config-validation      [default: true] Validate the app configuration file(s) before continuing.
      --[no-]confirm-new-workspace  Prompt to confirm before creating a new workspace
      --github-pat=<value>          github personal access token to use for downloading private quickstart repos
      --[no-]install                [default: true] Run npm installation after files are created
      --linter=<option>             [default: basic] Specify the linter to use for the project
                                    <options: none|basic|adobe-recommended>
      --[no-]login                  Login using your Adobe ID for interacting with Adobe I/O Developer Console
      --repo=<value>                Init from gh quick-start repo. Expected to be of the form <owner>/<repo>/<path>
      --standalone-app              Create a stand-alone application
      --template-options=<value>    Optional template options, as a base64-encoded json string
      --use-jwt                     if the config has both jwt and OAuth Server to Server Credentials (while migrating),
                                    prefer the JWT credentials
      --version                     Show version

DESCRIPTION
  Create a new Adobe I/O App
```

_参见代码 : [sc/命令/app/init.js](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/init.js)_

## `aio app install PATH`

此命令将支持安装由“ aio app package” 包装的应用程序 .

```
USAGE
  $ aio app install PATH [-v] [--version] [--config-validation] [--allow-scripts] [-o <value>] [--tests]

ARGUMENTS
  PATH  Path to the app package to install

FLAGS
  -o, --output=<value>          [default: .] The packaged app output folder path
  -v, --verbose                 Verbose output
      --[no-]allow-scripts      Allow post and preinstall scripts during npm install/npm ci
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --[no-]tests              Run packaged app unit tests (e.g. aio app:test)
      --version                 Show version

DESCRIPTION
  This command will support installing apps packaged by 'aio app pack'.
```

_参见代码 : [src/命令/应用程序/安装.js](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/install.js)_

## `aio app list`

列出 Adobe I/O App 的组件

```
USAGE
  $ aio app list [-v] [--version] [--config-validation]

FLAGS
  -v, --verbose                 Verbose output
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --version                 Show version

DESCRIPTION
  List components for Adobe I/O App
```

_参见代码 : [src/commands/app/list/index.js (中文(简体) )](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/list/index.js)_

## `aio app list extension`

列出已执行的扩展

```
USAGE
  $ aio app list extension [-v] [--version] [--config-validation] [-j] [-y]

FLAGS
  -j, --json                    Output json
  -v, --verbose                 Verbose output
  -y, --yml                     Output yml
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --version                 Show version

DESCRIPTION
  List implemented extensions


ALIASES
  $ aio app list ext
  $ aio app list extensions
```

_参见代码 : [sc/命令/应用程序/列表/扩展.js](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/list/extension.js)_

## `aio app logs`

获取 Adobe I/O App 日志

```
USAGE
  $ aio app logs [-v] [--version] [--config-validation] [-l <value>] [-a <value>...] [-r] [-t | -w | -o]

FLAGS
  -a, --action=<value>...       Fetch logs for a specific action
  -l, --limit=<value>           [default: 1] Limit number of activations to fetch logs from ( 1-50 )
  -o, --poll                    Fetch logs continuously
  -r, --strip                   strip timestamp information and output first line only
  -t, --tail                    Fetch logs continuously
  -v, --verbose                 Verbose output
  -w, --watch                   Fetch logs continuously
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --version                 Show version

DESCRIPTION
  Fetch logs for an Adobe I/O App
```

_参见代码 : [sc/命令/app/logs.js](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/logs.js)_

## `aio app pack [PATH]`

此命令将支持用于再分配的包装应用程序 .

```
USAGE
  $ aio app pack [PATH] [-v] [--version] [--config-validation] [--lock-file] [-o <value>]

ARGUMENTS
  [PATH]  [default: .] Path to the app directory to package

FLAGS
  -o, --output=<value>          [default: dist/app.zip] The packaged app output file path
  -v, --verbose                 Verbose output
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --[no-]lock-file          Include the package-lock.json file in the packaged app. When disabled, compatibility
                                validation is skipped since the provisioner will use npm install instead of npm ci.
      --version                 Show version

DESCRIPTION
  This command will support packaging apps for redistribution.
```

_参见代码 : [src/commands/app/ pack.js (简体中文)](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/pack.js)_

## `aio app run`

运行 Adobe I/O App

```
USAGE
  $ aio app run [-v] [--version] [--config-validation] [--serve] [--actions] [--open] [-e <value>]

FLAGS
  -e, --extension=<value>       Run only a specific extension, this flag can only be specified once
  -v, --verbose                 Verbose output
      --[no-]actions            [default: true] Run actions, defaults to true, to skip actions use --no-actions
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --open                    Open the default web browser after a successful run, only valid if your app has a
                                front-end
      --[no-]serve              [default: true] Start frontend server (experimental)
      --version                 Show version

DESCRIPTION
  Run an Adobe I/O App
```

_参见代码 : [src/命令/应用程序/运行.js](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/run.js)_

## `aio app test`

运行 Adobe I/O App 的测试

```
USAGE
  $ aio app test [-v] [--version] [--config-validation] [-e <value>... | -a <value>...] [--all] [--e2e]
    [--unit]

FLAGS
  -a, --action=<value>...       the action(s) to test
  -e, --extension=<value>...    the extension(s) to test
  -v, --verbose                 Verbose output
      --all                     run both unit and e2e tests
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --e2e                     run e2e tests
      --unit                    run unit tests
      --version                 Show version

DESCRIPTION
  Run tests for an Adobe I/O App
  If no flags are specified, by default only unit-tests are run.

  For the --action flag, it tries a substring search on the 'package-name/action-name' pair for an action.
  For the --extension flag, it tries a substring search on the 'extension-name' only.
  If the extension has a hook called 'test' in its 'ext.config.yaml', the script specified will be run instead.
```

_参见代码 : [src/commands/app/test.js (中文(简体) )](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/test.js)_

## `aio app undeploy`

不部署 Adobe I/O App

```
USAGE
  $ aio app undeploy [-v] [--version] [--config-validation] [--actions] [--events] [--web-assets] [-e <value>...]
    [--force-unpublish | --unpublish]

FLAGS
  -e, --extension=<value>...    Undeploy only a specific extension, the flags can be specified multiple times
  -v, --verbose                 Verbose output
      --[no-]actions            [default: true] Undeploy actions if any
      --[no-]config-validation  [default: true] Validate the app configuration file(s) before continuing.
      --[no-]events             [default: true] Undeploy (unregister) events if any
      --force-unpublish         Force unpublish extension(s) from Exchange, will delete all extension points
      --[no-]unpublish          [default: true] Unpublish selected extension(s) from Exchange
      --version                 Show version
      --[no-]web-assets         [default: true] Undeploy web-assets if any

DESCRIPTION
  Undeploys an Adobe I/O App
```

_参见代码 : [src/命令/应用程序/未部署。js](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/undeploy.js)_

## `aio app use [CONFIG_FILE_PATH]`

导入 Adobe 开发者控制台配置文件 .

```
USAGE
  $ aio app use [CONFIG_FILE_PATH] [-v] [--version] [--config-validation] [--overwrite | -m] [-g | -w
    <value>] [--confirm-new-workspace] [--no-service-sync | --confirm-service-sync] [--no-input] [--use-jwt]

ARGUMENTS
  [CONFIG_FILE_PATH]  path to an Adobe I/O Developer Console configuration file

FLAGS
  -g, --global                      Use the global Adobe Developer Console Org / Project / Workspace configuration,
                                    which can be set via `aio console` commands
  -m, --merge                       Merge any .aio and .env files during import of the Adobe Developer Console
                                    configuration file
  -v, --verbose                     Verbose output
  -w, --workspace=<value>           Specify the Adobe Developer Console Workspace name or Workspace id to import the
                                    configuration from
      --[no-]config-validation      [default: true] Validate the app configuration file(s) before continuing.
      --[no-]confirm-new-workspace  Prompt to confirm before creating a new workspace
      --confirm-service-sync        Skip the Service sync prompt and overwrite Service subscriptions in the new
                                    Workspace with current subscriptions
      --no-input                    Skip user prompts by setting --no-service-sync and --merge. Requires one of
                                    config_file_path or --global or --workspace
      --no-service-sync             Skip the Service sync prompt and do not attach current Service subscriptions to the
                                    new Workspace
      --overwrite                   Overwrite any .aio and .env files during import of the Adobe Developer Console
                                    configuration file
      --use-jwt                     if the config has both jwt and OAuth Server to Server Credentials (while migrating),
                                    prefer the JWT credentials
      --version                     Show version

DESCRIPTION
  Import an Adobe Developer Console configuration file.

  If the optional configuration file is not set, this command will retrieve the console org, project, and workspace
  settings from the global config.

  To set these global config values, see the help text for 'aio console --help'.

  To download the configuration file for your project, select the 'Download' button in the toolbar of your project's
  page in https://developer.adobe.com/console/
```

_参见代码 : [src/命令/应用/使用.js](https://github.com/adobe/aio-cli-plugin-app/blob/14.10.0/src/commands/app/use.js)_

## 常见问题

### @adobe/aio-cli-plugin-app 是什么？

创建、构建和部署 Adobe I/O 应用程序

### 如何安装 @adobe/aio-cli-plugin-app？

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

### @adobe/aio-cli-plugin-app 支持 TypeScript 吗？

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

### @adobe/aio-cli-plugin-app 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.17\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @adobe/aio-cli-plugin-app 可以商用吗？

@adobe/aio-cli-plugin-app 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @adobe/aio-cli-plugin-app 的下载量有多少？

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

### @adobe/aio-cli-plugin-app 还在维护吗？

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