# @aws-cdk/cloud-assembly-schema 中文文档

规范地址：https://npmcn.com/package/%40aws-cdk/cloud-assembly-schema/

版本：55\.4\.0
npm 元数据更新时间：2026-11-05T16:01:28.717Z
中文译文更新时间：2026-11-07T09:24:14.913Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40aws-cdk/cloud-assembly-schema
原文对照：https://npmcn.com/package/%40aws-cdk/cloud-assembly-schema/?lang=original
项目主页：https://github.com/aws/aws-cdk
源码仓库：https://github.com/aws/aws-cdk-cli

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

- 包体积（解压后）：1.3 MB，122 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>= 18\.0\.0
- 运行依赖：2 个
- 首次发布：2020-04-17T20:20:26.909Z
- 最新版本发布：2026-11-05T16:01:28.365Z
- 近 30 天下载量：22143463（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：711（近 12 个月 76 个）

## 中文简介

CDK 框架和 CDK CLI 之间的协议图示

## 安装

```sh
npm install @aws-cdk/cloud-assembly-schema
```

也可以使用：`pnpm add @aws-cdk/cloud-assembly-schema`、`yarn add @aws-cdk/cloud-assembly-schema`、`bun add @aws-cdk/cloud-assembly-schema`

## README

# 云团司马

这个模块是 [AWS 云开发套件](https://github.com/aws/aws-cdk) 项目.

## 云团

这个 _云团_ 是合成操作的输出。 它是作为《公约》的一部分生产的 [`cdk synth`](https://github.com/aws/aws-cdk-cli/tree/main/packages/aws-cdk#cdk-synthesize) 命令,或 [`app.synth()`](https://github.com/aws/aws-cdk/blob/main/packages/aws-cdk-lib/core/lib/stage.ts#L219) 方法引用.

它本质上是一套文件和目录,其中之一是 `manifest.json` 文档。 它定义了一套指令,即 用于部署组装目录.

> 例如,何时 `cdk deploy` 执行时, CLI 读取此文件并履行指示 :
> 
> -   构建容器图像 .
> -   上传资产.
> -   部署"云阵"模板.

因此,组装是CDK类库和CDK CLI(或任何其他消费者)的交流方式. 确保兼容性 在组装和它的消费者之间,我们把清单视为一个定义明确,版本化的计划.

## 司马

本模块包含包含以下内容的打字结构: `manifest.json` 文档,以及 生成 [_json-schema (日语)_](https://npmcn.com/package/%40aws-cdk/cloud-assembly-schema/schema/cloud-assembly.schema.json)。 。 。 .

## 版本

计划版本 指定我的主要版本的软件包发布。 它跟随语义的版本,但有一个小曲折.

当我们在集会上添加指示时,它们会反映在清单和清单中 _json-schema (日语)_ 相应. 每一个这样的指示对于确保正确的部署行为至关重要。 这意味着为了正确部署云组装, 消费者必须了解所有此类指令修改.

由于这个原因,每一次修改计划,即使它可能不会严格地打破验证 _json-schema (日语)_ 格式,则, 考虑 `major` 版本凸起。 所有不影响计划的变化都被视为 `minor` 版本凸起.

## 如何消费

如果你愿意消费 [计划文件](https://npmcn.com/package/%40aws-cdk/cloud-assembly-schema/schema/cloud-assembly.schema.json) 以进行校验 `manifest.json` 文档, 只需从此 repo 下载并按标准运行 _json-schema (日语)_ 验证符,例如 [杰森斯克马](https://www.npmjs.com/package/jsonschema)。 。 。 .

消费者必须考虑到 `major` 他们正在消费的阴谋 他们应该拒绝云集会 带有 `major` 这个版本比他们预期的要高 虽然计划验证可能传递这些集会,但部署的完整性 无法保证,因为某些指示会被忽略.

> 例如,如果你的消费者是建在2.0.0的图案版本时的,那么你应该拒绝用一个 显示版为3.0.0.

## 捐款

见 [贡献指南](https://npmcn.com/package/%40aws-cdk/cloud-assembly-schema/CONTRIBUTING.md)

## 常见问题

### @aws-cdk/cloud-assembly-schema 是什么？

CDK 框架和 CDK CLI 之间的协议图示

### 如何安装 @aws-cdk/cloud-assembly-schema？

在项目目录运行 npm install @aws-cdk/cloud-assembly-schema，或使用 pnpm add / yarn add / bun add。

### @aws-cdk/cloud-assembly-schema 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @aws-cdk/cloud-assembly-schema 支持 ESM 还是 CommonJS？

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

### @aws-cdk/cloud-assembly-schema 需要什么版本的 Node\.js？

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

### @aws-cdk/cloud-assembly-schema 可以商用吗？

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

### @aws-cdk/cloud-assembly-schema 的下载量有多少？

根据 npm 官方下载统计，@aws-cdk/cloud-assembly-schema 在 2026/10/08 – 2026/11/06 这 30 天内被下载 22,143,463 次，日均约 738,115 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aws-cdk/cloud-assembly-schema 还在维护吗？

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