# @adobe/aem-site-theme-builder 中文文档 规范地址：https://npmcn.com/package/%40adobe/aem-site-theme-builder/ 版本：6\.0\.1 npm 元数据更新时间：2026-10-01T01:31:56.957Z 中文译文更新时间：2026-11-06T00:41:12.341Z 软件包许可：MIT License, Copyright 2020 Adobe Systems Incorporated 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40adobe/aem-site-theme-builder 原文对照：https://npmcn.com/package/%40adobe/aem-site-theme-builder/?lang=original ## 关键信息（来自 npm 元数据） - 包体积（解压后）：17.8 kB，11 个文件 - 模块格式：CommonJS - TypeScript 类型：未声明 - 运行依赖：7 个 - 首次发布：2020-10-26T18:20:25.806Z - 最新版本发布：2026-05-11T14:48:55.974Z - 近 30 天下载量：8073（2026-10-05 至 2026-11-03，npm 官方下载统计） - 已发布版本数：21（近 12 个月 1 个） ## 中文简介 这个寄存器包含用于构建站点主题的脚本,确保与AEM站点模板的要求相兼容. 建议整合"主题构建器"的方式是将其安装为"站点模板主题"的npm依赖. 这边 ## 安装 ```sh npm install @adobe/aem-site-theme-builder ``` 也可以使用：`pnpm add @adobe/aem-site-theme-builder`、`yarn add @adobe/aem-site-theme-builder`、`bun add @adobe/aem-site-theme-builder` ## README # AEM 站点主题构建器 这个寄存器包含用于构建站点主题的脚本,确保与AEM站点模板的要求相兼容. 建议整合"主题构建器"的方式是将其安装为"站点模板主题"的npm依赖. 这边 `aem-site-theme-builder` 命令可以在国家预防机制脚本中使用。 这种整合的例子可见于 [标准站点模板](https://github.com/adobe/aem-site-template-standard/blob/main/theme/package.json)。 。 。 . ## 安装 ``` cd npm install @adobe/aem-site-theme-builder --save-dev ``` ## 使用量 ### 代理服务器 代理您在 AEM 上运行的站点作为 Cloud Service 到本地主机, 用您本地编译的站点主题替换向站点主题提出的请求 . ``` npx aem-site-theme-builder proxy ``` 网站主题的 URL 可以通过 `.env` 说明 [环境变量](https://npmcn.com/package/%40adobe/aem-site-theme-builder/#readme-environment-variables)。为了输入您本地编译的主题 [编辑网站主题的位置](https://npmcn.com/package/%40adobe/aem-site-theme-builder/#readme-expected-location-of-compiled-site-theme) 必须匹配. ### 现场预览 直播预览会运行代理服务器(上面被描述)以及浏览器同步功能. 浏览器同步将指向代理页面,并正在查找 `dist` 文件夹,每次有更改都会刷新页面. ``` npx aem-site-theme-builder live ``` ### 主题 部署 1. 编译您的主题,并在GitHub上提供这些文物. AEM 作为云服务将尝试访问 `https://api.github.com/repos/%GIT_ORG%/%GIT_REPO%/actions/artifacts/%GIT_ARTIFACT_ID%/zip` 以便下载主题. 2. 执行 `npx aem-site-theme-builder deploy` 以更新AEM作为"云服务"的参考. ## 完成开发工作流程 为了充分利用主题构建器, 您必须运行提供代理和浏览器同步功能的活预览 。 除此之外,您还需要确保您的源文件有额外的监视器,该监视器将触发您的主题构建进程,该进程将产生修改 `dist` 文件夹。 通过浏览器同步刷新您的代理页面 . ## API 密码 ### 环境变量 主题构建器脚本基于您提供的环境变量. 这些变量用于正确提供AEM站点主题构建器的活性预览并部署功能. 以下是所需变量列表: ``` AEM_URL= AEM_SITE= AEM_PROXY_PORT= ``` 以下是可选变量列表: ``` AEM_ADAPTIVE_FORM= ``` 建议定义站点变量的方式是使用/创建 `.env` 在主题项目仓库中保存文件. ### 编译网站主题的预期输出 你可以随意使用你选择的任何建造工具. 唯一与"站点主题构建者"签订的合同是所编译的文物应当提供如下: 1 ``` dist/ css/ theme.css js/ theme.js resources/ a-font.font an-image.png ``` ## 发行和出版 运行"放出并发布"GitHub工作流程,提供您即将发布的语义版. ## 捐款 欢迎捐款! 读取 [贡献指南](https://npmcn.com/package/%40adobe/aem-site-theme-builder/.github/CONTRIBUTING.md) 更多信息. ## 许可证发放 这个项目根据麻省理工学院的许可证获得许可。 见 [自由主义](https://npmcn.com/package/%40adobe/aem-site-theme-builder/LICENSE.md) 更多信息. ## 常见问题 ### @adobe/aem-site-theme-builder 是什么？ 这个寄存器包含用于构建站点主题的脚本,确保与AEM站点模板的要求相兼容\. 建议整合"主题构建器"的方式是将其安装为"站点模板主题"的npm依赖\. 这边 ### 如何安装 @adobe/aem-site-theme-builder？ 在项目目录运行 npm install @adobe/aem-site-theme-builder，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 aem-site-theme-builder，可以用 npx aem-site-theme-builder 直接运行。 ### @adobe/aem-site-theme-builder 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/adobe\_\_aem-site-theme-builder 是否存在。 ### @adobe/aem-site-theme-builder 支持 ESM 还是 CommonJS？ 以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。 ### @adobe/aem-site-theme-builder 可以商用吗？ @adobe/aem-site-theme-builder 使用 MIT License, Copyright 2020 Adobe Systems Incorporated 许可。声明的许可为 MIT License, Copyright 2020 Adobe Systems Incorporated，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。 ### @adobe/aem-site-theme-builder 的下载量有多少？ 根据 npm 官方下载统计，@adobe/aem-site-theme-builder 在 2026/10/05 – 2026/11/03 这 30 天内被下载 8,073 次，日均约 269 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @adobe/aem-site-theme-builder 还在维护吗？ 最新版本 6\.0\.1 发布于 2026/05/11（5 个月前）；至今共发布 21 个版本，其中过去 12 个月发布了 1 个；首次发布于 2020/10/27。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。