@adobe/aio-cli

中文文档
11.2.0发布于 2026/10/12Apache-2.0CommonJS近 30 天下载 2.5万

Adobe I/O Extensible CLI








原始使用文档
文档目录26 节
  1. aio app
  2. aio app add
  3. aio app add action
  4. aio app add actions
  5. aio app add ci
  6. aio app add db
  7. aio app add event
  8. aio app add events
  9. aio app add ext
  10. aio app add extension
  11. aio app add extensions
  12. aio app add service
  13. aio app add services
  14. aio app add web-assets
  15. aio app build
  16. aio app clean
  17. aio app config
  18. aio app config get
  19. aio app config get lf
  20. aio app config get lf errors
  21. aio app config get log-forwarding
  22. aio app config get log-forwarding errors
  23. aio app config set
  24. aio app config set lf
  25. aio app config set log-forwarding
  26. aio app create [PATH]

aio-cli

Adobe I/O Extensible CLI

oclif Version Downloads/week Node.js CI License Codecov Coverage

health

Health badges for the aio-cli and its plugins and modules

ModuleVersionDownloadsBuild StatusCoverageIssuesPull Requests
@adobe/aio-cliVersionDownloads/weekNode.js CICodecov CoverageGithub IssuesGithub Pull Requests
@adobe/aio-cli-plugin-configVersionDownloads/weekNode.js CICodecov CoverageGithub IssuesGithub Pull Requests
@adobe/aio-cli-plugin-consoleVersionDownloads/weekNode.js CICodecov CoverageGithub IssuesGithub Pull Requests
@adobe/aio-cli-plugin-runtimeVersionDownloads/weekNode.js CICodecov CoverageGithub IssuesGithub Pull Requests
@adobe/aio-cli-plugin-appVersionDownloads/weekNode.js CICodecov CoverageGithub IssuesGithub Pull Requests
@adobe/aio-cli-plugin-app-templatesVersionDownloads/weekNode.js CICodecov CoverageGithub IssuesGithub Pull Requests
@adobe/aio-cli-plugin-authVersionDownloads/weekNode.js CICodecov CoverageGithub IssuesGithub Pull Requests
@adobe/aio-cli-plugin-certificateVersionDownloads/weekNode.js CICodecov CoverageGithub IssuesGithub Pull Requests
@adobe/aio-cli-plugin-infoVersionDownloads/weekNode.js CICodecov CoverageGithub IssuesGithub Pull Requests
@adobe/aio-cli-plugin-eventsVersionDownloads/weekNode.js CICodecov CoverageGithub IssuesGithub Pull Requests
@adobe/aio-cli-plugin-telemetryVersionDownloads/weekNode.js CICodecov CoverageGithub IssuesGithub Pull Requests
@adobe/generator-aio-appVersionDownloads/weekNode.js CICodecov CoverageGithub IssuesGithub Pull Requests
@adobe/generator-aio-consoleVersionDownloads/weekNode.js CICodecov CoverageGithub IssuesGithub Pull Requests

Getting started

See the Adobe Developer App Builder docs

Technical requirements

See the App Builder Setting up Your Environment doc

Proxy Support

Set these environment variables, to use proxies (case sensitive):

  1. HTTP_PROXY
  2. HTTPS_PROXY

The appropriate proxy will be used to proxy http/https urls respectively.

If your proxy requires basic authentication, embed the username and password in the url itself. For example, if your server is https://example.com and username is user and password is password, the url should look like this:

https://user:[email protected]

If your username or password contains non-alphanumeric characters, they must be url-encoded.

You can verify if you set the proxy info properly by running:

aio info

Usage

$ npm install -g @adobe/aio-cli
$ aio COMMAND
running command...
$ aio (--version|-v)
@adobe/aio-cli/11.2.0 linux-x64 node-v22.23.3
$ aio --help [COMMAND]
USAGE
  $ aio COMMAND
...

Commands

aio app

Create, run, test, and deploy 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

See code: @adobe/aio-cli-plugin-app

aio app add

Add a new component to an existing 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

See code: @adobe/aio-cli-plugin-app

aio app add action

Add new actions

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

See code: @adobe/aio-cli-plugin-app

aio app add actions

Add new actions

USAGE
  $ aio app add actions [-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

aio app add ci

Add CI files

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

See code: @adobe/aio-cli-plugin-app

aio app add db

Provision a new database for your App Builder application

USAGE
  $ aio app add db [--json] [--region <value>] [-y]

FLAGS
  -y, --yes  Skip confirmation prompt and provision automatically

GLOBAL FLAGS
  --json            Format output as json.
  --region=<value>  Database region. Defaults to 'AIO_DB_REGION' environment variable or 'amer' if neither is set. Any
                    database region set in 'app.config.yaml' takes precedence over all of these.
                    <options: amer|emea|apac|aus>

DESCRIPTION
  Provision a new database for your App Builder application

EXAMPLES
  $ aio app add db

  $ aio app add db --region amer

  $ aio app add db --json

  $ aio app add db --yes

aio app add event

Add a new Adobe I/O Events action

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

See code: @adobe/aio-cli-plugin-app

aio app add events

Add a new Adobe I/O Events action

USAGE
  $ aio app add events [-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

aio app add ext

Add new extensions to the project

USAGE
  $ aio app add ext [-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

aio app add extension

Add new extensions to the project

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

See code: @adobe/aio-cli-plugin-app

aio app add extensions

Add new extensions to the project

USAGE
  $ aio app add extensions [-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

aio app add service

Subscribe to Services in the current Workspace

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

See code: @adobe/aio-cli-plugin-app

aio app add services

Subscribe to Services in the current Workspace

USAGE
  $ aio app add services [-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

aio app add web-assets

Add web assets support

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

See code: @adobe/aio-cli-plugin-app

aio app build

Build an 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.

See code: @adobe/aio-cli-plugin-app

aio app clean

Remove all build artifacts from the local machine

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.

See code: @adobe/aio-cli-plugin-app

aio app config

Manage app config

USAGE
  $ aio app config [-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
  Manage app config

ALIASES
  $ aio app config
  $ aio app config

See code: @adobe/aio-cli-plugin-app

aio app config get

Get app config

USAGE
  $ aio app config get [-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
  Get app config

ALIASES
  $ aio app config get

See code: @adobe/aio-cli-plugin-app

aio app config get lf

Get log forwarding destination configuration

USAGE
  $ aio app config get lf [-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
  Get log forwarding destination configuration

ALIASES
  $ aio app config get log-forwarding
  $ aio app config get lf

aio app config get lf errors

Get log forwarding errors

USAGE
  $ aio app config get lf errors [-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
  Get log forwarding errors

ALIASES
  $ aio app config get log-forwarding errors
  $ aio app config get lf errors

aio app config get log-forwarding

Get log forwarding destination configuration

USAGE
  $ aio app config get log-forwarding [-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
  Get log forwarding destination configuration

ALIASES
  $ aio app config get log-forwarding
  $ aio app config get lf

See code: @adobe/aio-cli-plugin-app

aio app config get log-forwarding errors

Get log forwarding errors

USAGE
  $ aio app config get log-forwarding errors [-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
  Get log forwarding errors

ALIASES
  $ aio app config get log-forwarding errors
  $ aio app config get lf errors

See code: @adobe/aio-cli-plugin-app

aio app config set

Set app config

USAGE
  $ aio app config set [-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
  Set app config

ALIASES
  $ aio app config set

See code: @adobe/aio-cli-plugin-app

aio app config set lf

Set log forwarding destination configuration

USAGE
  $ aio app config set lf [-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
  Set log forwarding destination configuration

ALIASES
  $ aio app config set log-forwarding
  $ aio app config set lf

aio app config set log-forwarding

Set log forwarding destination configuration

USAGE
  $ aio app config set log-forwarding [-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
  Set log forwarding destination configuration

ALIASES
  $ aio app config set log-forwarding
  $ aio app config set lf

See code: @adobe/aio-cli-plugin-app

aio app create [PATH]

Create a new Adobe I/O App with default parameters

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

_See code: [@adobe/aio-cli-plug

版本与发布记录

@adobe/aio-cli 共发布 62 个版本,首次发布于 2018/08/31;过去 12 个月发布了 7 个版本。

版本发布日期距今
11.2.0latest2026/10/1226 天前
11.1.42026/09/211 个月前
11.1.22026/06/045 个月前
11.1.12026/06/045 个月前
11.1.02026/05/086 个月前
11.0.22026/03/107 个月前

其他发布通道:next → 8.3.0-pre.2022-06-22.sha-075e355f。

关于 @adobe/aio-cli 的常见问题

@adobe/aio-cli 是什么?

Adobe I/O Extensible CLI

如何安装 @adobe/aio-cli?

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

@adobe/aio-cli 支持 TypeScript 吗?

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

@adobe/aio-cli 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@adobe/aio-cli 需要什么版本的 Node.js?

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

@adobe/aio-cli 可以商用吗?

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

@adobe/aio-cli 的下载量有多少?

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

@adobe/aio-cli 还在维护吗?

最新版本 11.2.0 发布于 2026/10/12(26 天前);至今共发布 62 个版本,其中过去 12 个月发布了 7 个;首次发布于 2018/08/31。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。