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

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

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

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

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

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

- 包体积（解压后）：72.3 kB，13 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：21 个
- 首次发布：2024-05-09T13:10:00.846Z
- 最新版本发布：2026-04-24T03:22:17.581Z
- 近 30 天下载量：22470（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 2 个）

## 中文简介

运行本地主机 dev 服务器为本地操作服务

## 安装

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

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

## README

# aio- cli- plugin- app- dev

[![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-dev.svg)](https://npmjs.org/package/@adobe/aio-cli-plugin-app-dev) [![Downloads/week](https://img.shields.io/npm/dw/@adobe/aio-cli-plugin-app-dev.svg)](https://npmjs.org/package/@adobe/aio-cli-plugin-app-dev) ![Node.js CI](https://github.com/adobe/aio-cli-plugin-app-dev/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-dev/master.svg?style=flat-square)](https://codecov.io/gh/adobe/aio-cli-plugin-app-dev/)

-   这一指令是审视地方发展的新方法. 这使用了模拟器的方法,而不是模拟器.
-   支持无害环境管理和类型脚本行动.
-   [应用构建器调试 Docs](https://developer.adobe.com/app-builder/docs/guides/development/#debugging)

## 图标

-   [`aio app dev`](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-dev/#readme-aio-app-dev)

## `aio app dev`

本地运行您的 App 构建程序

```
USAGE
  $ aio app dev [-v] [--version] [-o] [-e <value>]

FLAGS
  -e, --extension=<value>  Run only a specific extension, this flag can only be specified once
  -o, --open               Open the default web browser after a successful run, only valid if your app has a front-end
  -v, --verbose            Verbose output
      --version            Show version

DESCRIPTION
  Run your App Builder app locally
```

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

## 覆盖主机名和端口

默认主机名为 `localhost` 默认端口为 `9080`。您可以通过设置这些环境变量来覆盖这些值:

1.  `SERVER_HOST`
2.  `SERVER_DEFAULT_PORT`

命令将尝试使用默认的端口, 如果无法使用, 它会找到一个开放的端口来取而代之 .

## Visual Studio代码 Webpack 调试支持( 源代码地图)

要允许您在 Visual Studio 代码中对网络包装代码进行分步调试, 您必须添加一个 [自定义网络包配置](https://developer.adobe.com/app-builder/docs/guides/configuration/webpack-configuration/)。 。 。 .

在您的项目根部, 添加一个 `webpack-config.js` 文件 :

```javascript
module.exports = {
  devtool: 'inline-source-map'
}
```

## 类型脚本支持

在您的应用程序中安装这些节点模块 : `npm install --save-dev ts-loader typescript`

在您的项目根部, 添加一个 `webpack-config.js` 文件 :

```javascript
module.exports = {
  devtool: 'inline-source-map',
  module: {
    rules: [
      {
        // includes, excludes are in tsconfig.json
        test: /\.ts?$/,
        exclude: /node_modules/,
        use: 'ts-loader'
      }
    ]
  }
}
```

在您的项目根部, 添加一个 `tsconfig.json` 文件 :

```json
{
  "exclude": ["node_modules", "dist"],
  "compilerOptions": {
    "target": "ES6",
    "module": "ES6",
    "sourceMap": true
  }
}
```

与 TypeScript 有视觉工作室代码问题

[https://github.com/microsoft/vscode/issues/221503 页面存档备份,存于互联网档案馆](https://github.com/microsoft/vscode/issues/221503)

## 捐款

欢迎捐款! 读取 [贡献指南](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-dev/CONTRIBUTING.md) 更多信息.

## 许可证发放

这个项目根据Apache V2许可证获得许可. 见 [自由主义](https://npmcn.com/package/%40adobe/aio-cli-plugin-app-dev/LICENSE) 更多信息.

## 常见问题

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

运行本地主机 dev 服务器为本地操作服务

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

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

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

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

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

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

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

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

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

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

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

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