AEM 项目原型
AEM 项目原型是一个 Maven 模板，它创建最小的基于最佳实践的 Adobe Experience Manager (AEM) 项目作为您网站的起点。
小贴士
在 GitHub 上可找到最新的 AEM 项目原型。
资源
- 原型文档（本文档）：原型架构及其不同模块的概述。
- 使用原型：有关使用原型和可用模块的更多详细信息
- ui.frontend：如何使用前端构建模块
- 以下教程基于此原型：
- WKND 网站：了解如何启动全新的网站。
- WKND 单页面应用程序：了解如何构建可完全在 AEM 中创作的 React 或 Angular Web 应用程序。
功能
- 最佳实践：使用 Adobe 的所有最新推荐实践引导您的网站。
- 少量代码：编辑您的模板、创建内容、部署您的 CSS，您的网站就可以上线了。
- 云就绪：如果需要，使用 AEM as a Cloud Service 在几天内上线并简化可扩展性和维护。
- Dispatcher：只能通过可确保速度和安全性的 Dispatcher 配置完成项目。
- 多站点：如果需要，原型将为多语言和多区域设置生成内容结构。
- 核心组件：作者可以使用我们通用的标准化组件集创建几乎任何布局。
- 可编辑模板：收集几乎任何不带代码的模板，并定义作者可编辑的内容。
- 响应式布局：在模板或单个页面上，为定义的断点定义元素的重排方式。
- 页眉和页脚：收集页眉和页脚，并使用组件的本地化功能将其本地化而不是使用代码。
- 样式系统：通过允许作者向自定义组件应用不同的样式来避免构建这些组件。
- 前端构建：前端开发人员可以使用 Webpack、TypeScript 和 SASS 模拟 AEM 页面和构建客户端库。
- Web 应用程序就绪：对于使用 React 或 Angular 的网站，使用 SPA 开发工具包保持应用程序的上下文中创作。
- 启用 Commerce：对于要将 AEM Commerce 与 Magento 等商业解决方案集成的项目，使用 Commerce 核心组件。
- 示例代码：查看 HelloWorld 组件以及示例模型、servlet、过滤器和调度程序。
- 开源：如果有出错的地方，请做出您的改进！
用途
要生成项目，请调整以下命令行以满足您的需求：
mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate \
-D archetypeGroupId=com.adobe.aem \
-D archetypeArtifactId=aem-project-archetype \
-D archetypeVersion=XX \
-D appTitle="My Site" \
-D appId="mysite" \
-D groupId="com.mysite" \
- 将
XX替换为最新的原型版本号。 - 为 AEM as a Cloud Service 设置
aemVersion=cloud；
为 Adobe Managed Services 或内部部署设置aemVersion=6.5.0。
仅为非云 AEM 版本添加核心组件依赖项，因为核心组件是针对 AEM as a Cloud Service 提供的 OOTB。 - 调整
appTitle="My Site"以定义网站标题和组件组。 - 调整
appId="mysite"以定义 Maven artifactId、组件、配置和内容文件夹名称以及客户端库名称。 - 调整
groupId="com.mysite"以定义 Maven groupId 和 Java 源程序包。 - 查找可用属性列表以了解是否还需要调整其他属性。
可用属性
| 名称 | 默认 | 描述 |
|---|---|---|
appTitle |
应用程序标题，将用于网站标题和组件组（例如 "My Site"）。 |
|
appId |
技术名称，将用于组件、配置和内容文件夹名称以及客户端库名称（例如，"mysite"）。 |
|
artifactId |
${appId} |
基本 Maven 构件 ID（例如 "mysite"）。 |
groupId |
基本 Maven 组 ID（例如 "com.mysite"）。此值必须是有效的 Java 包名称。 |
|
package |
${groupId} |
Java 源程序包（例如 "com.mysite"）。 |
version |
1.0-SNAPSHOT |
项目版本（例如 1.0-SNAPSHOT）。 |
aemVersion |
cloud |
目标 AEM 版本（可以是 AEM as a Cloud Service 的 cloud；或 Adobe Managed Services 或内部部署的 6.5.0 或 6.4.4）。 |
sdkVersion |
latest |
在为 aemVersion=cloud 时，可指定开发工具包版本（例如 2020.02.2265.20200217T222518Z-200130）。 |
includeDispatcherConfig |
y |
包括用于云或 AMS/内部部署的 Dispatcher 配置，具体取决于 aemVersion 的值（可以是 y 或 n）。 |
frontendModule |
general |
包含一个生成客户端库的 Webpack 前端构建模块（可以是面向常规站点的 general 或 none；可以是面向实施 SPA 编辑器的单页面应用程序的 angular 或 react）。 |
language |
en |
从中创建内容结构的语言代码 (ISO 639-1)（例如 en、deu）。 |
country |
us |
从中创建内容结构的国家/地区代码 (ISO 3166-1)（例如 US）。 |
singleCountry |
y |
包含语言主导的内容结构（可以是 y 或 n）。 |
includeExamples |
n |
包含组件库示例站点（可以是 y 或 n）。 |
includeErrorHandler |
n |
包含将为整个实例全局设置的自定义 404 响应页面（可以是 y 或 n）。 |
includeCommerce |
n |
包含 CIF 核心组件依赖项并生成相应的构件。 |
commerceEndpoint |
仅对于 CIF 是必需的。要使用的商务系统 GraphQL 服务的可选端点（例如 https://hostname.com/grapql）。 |
|
includeFormscommunications |
n |
包括 Forms 核心组件依赖项、模板、表单数据模型、主题，并为 Forms 通信程序生成相应的伪像。 |
includeFormsenrollment |
n |
包括 Forms 核心组件依赖项、模板、表单数据模型、主题，并为 Forms 注册程序生成相应的伪像。 |
sdkFormsVersion |
latest |
当 aemVersion=cloud 并且 includeFormsenrollment=y 或 includeFormscommunications=y 其中之一时，可指定 Forms SDK 版本（例如 2020.12.17.02）。 |
datalayer |
y |
激活与 Adobe Client Data Layer 的集成。 |
amp |
n |
为生成的项目模板启用 AMP 支持。 |
enableDynamicMedia |
n |
在项目策略设置中启用基础 DynamicMedia 组件，并在核心图像组件的策略中激活 Dynamic Media 功能。 |
enableSSR |
n |
用于为前端项目启用 SSR 的选项 |
precompiledScripts |
n |
用于从 ui.apps 预编译服务器端脚本并将它们作为 ui.apps 项目中的次捆绑构件附加到版本的选项。aemVersion 应设置为 cloud。 |
includeFormsheadless |
n |
包括 Forms 核心组件依赖项、ui.frontend.react.forms.af 和 Headless 构件。 |
系统要求
| 原型 | AEM as a Cloud Service | AEM 6.5 | Java SE | Maven |
|---|---|---|---|---|
| 39 | 连续 | 6.5.7.0+ | 8, 11 | 3.3.9+ |
为 AEM as a Cloud Service SDK 或旧版本的 AEM 设置本地开发环境。
已知问题
在 Windows 上运行并生成 Dispatcher 配置时，您应在提升权限的命令提示符下或适用于 Linux 的 Windows 子系统中运行（请参阅 #329）。
在交互模式下执行原型（不带 -B 参数）时，无法更改带默认值的属性，除非取消最终确认，这随后会在问题中包含带默认值的属性来重复问题（有关详细信息，请参阅
ARCHETYPE-308）。
在使用 File -> New -> Maven Project 开始新项目时，无法在 Eclipse 中使用此原型，因为 Eclipse 问题导致无法执行后生成脚本 archetype-post-generate.groovy。解决方法是使用上面的命令行，然后在 Eclipse 中，使用 File -> Import -> Existing Maven Project。
深入阅读
有关使用原型的更多详细信息，包括其好处、选项及其模块的工作方式，请参阅使用原型文档。
Business.Adobe.com 资源
更改语言
