AEM as a Cloud Service SDK aem-as-a-cloud-service-sdk
AEM as a Cloud Service SDK由以下工件组成：
- 快速入门Jar — 用于本地开发的AEM运行时。
- Java™ API Jar - Java™ Jar/Maven依赖项，它公开可用于针对AEM as a Cloud Service开发的所有允许的Java™ API。 以前称为Uberjar。
- Javadoc Jar - Java™ API Jar的Java文档。
- Dispatcher Tools — 用于针对本地Dispatcher开发的工具集。 为UNIX®和Windows分离工件。
此外，以前部署了AEM 6.5或更早版本的一些客户使用以下工件。 如果本地编译不适用于QuickStart Jar，并且您怀疑它来自从AEM部署的as a Cloud Service中删除界面，请联系客户支持。 他们可以确定您是否需要访问权限。 它需要在后端进行更改。
- 6.5已弃用的Java™ API Jar — 自AEM 6.5之后已移除的额外接口集。
- 6.5已弃用的Javadoc Jar — 用于附加接口集的Java文档。
SDK构建 building-for-the-sdk
AEM as a Cloud Service SDK用于构建和部署自定义代码。 请参阅AEM项目原型文档。 在高级别上，将执行以下步骤：
- 编译代码 — 已编译Source代码，并生成生成的内容包。
- 生成项目 — 在此过程中生成项目。
- 分析包 — 使用Maven分析器插件分析包，该插件查找Maven项目中的问题，例如缺少依赖项。
- 部署项目 — 将项目部署到本地服务器。
Cloud Manager在部署到云环境时执行相同的步骤。 在本地执行内部版本允许本地开发和测试。 开发人员可以在提交到源代码控制之前高效地识别代码或结构问题。 此过程有助于防止因触发Cloud Manager部署而导致的延迟，延迟可能需要更长时间。
访问AEM as a Cloud Service SDK accessing-the-aem-as-a-cloud-service-sdk
- 您可以查看AEM Admin Console的 关于Adobe Experience Manager 图标，以了解您正在生产环境中运行的AEM版本。
- 可以从软件分发门户以zip文件的形式下载QuickStart Jar和Dispatcher工具。 仅限那些在AEM Managed Services或AEM as a Cloud Service上拥有环境的人访问SDK列表。
- Java™ API Jar和Javadoc Jar可以通过Maven工具（命令行或首选IDE）下载。
- maven项目pom应引用以下API Jar包。 还应该引用对任何子包pom的依赖关系。
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-sdk-api</artifactId>
<version>2019.11.3006.20191108T223635Z-191201</version>
<scope>provided</scope>
</dependency>
使用新的SDK版本刷新本地项目 refreshing-a-local-project-with-a-new-skd-version
建议何时使用新的SDK刷新本地项目？
Adobe 建议 在每月维护版本发布后刷新它。
在任何每日维护版本发布后刷新它是 可选的。 当客户的生产实例成功升级到新的AEM版本时，将通知客户。 对于每日维护版本，新的SDK预计不会发生重大变化（如果有的话）。 不过，Adobe建议您偶尔使用最新的SDK刷新本地AEM开发人员环境，然后重建并测试自定义应用程序。 每月维护版本通常包括更具影响力的更改，因此开发人员应立即刷新、重建和测试。
使用新的SDK版本刷新本地项目：
- 确保所有有用的内容都提交给源代码管理。 或者，存储在可变内容包中以供以后导入。
- 本地开发测试内容必须单独存储，以便不会部署为Cloud Manager管道构建的一部分。 原因是它仅用于本地开发。
- 停止当前正在运行的快速启动。
- 将
crx-quickstart文件夹移动到其他文件夹以进行安全保留。 - 请注意新的AEM版本，该版本在Cloud Manager中有说明（用于标识新的快速入门Jar版本，以供进一步下载）。
- 从软件分发门户下载其版本与生产AEM版本相匹配的QuickStart Jar。
- 创建一个全新的文件夹，并将新的QuickStart Jar放入其中。
- 使用所需的运行模式启动新的QuickStart（重命名文件或通过
-r在运行模式中传递）。
确保文件夹中没有遗留的旧快速入门。 - 构建AEM应用程序。
- 通过包管理器将您的AEM应用程序部署到本地AEM。
- 通过包管理器安装本地环境测试所需的任何可变内容包。
- 根据需要继续开发和部署更改。
如果有内容应随每个新的AEM快速入门版本一起安装，请将其包含在内容包和项目的源代码控制中。 然后，每次都安装它。
Adobe建议您经常更新SDK，例如每两周。 并且，每天处理完整的本地状态，这样您就不会意外依赖应用程序中的有状态数据。
如果您使用CryptoSupport for Cloud Services、SMTP Mail配置或CryptoSupport API，则加密的属性将通过密钥进行保护。 有关更多详细信息，请参阅加密支持API文档。 此密钥在AEM环境首次启动时自动生成。 虽然云设置负责自动重用特定于环境的CryptoKey，但必须将加密密钥注入本地开发环境。
默认情况下，AEM配置为将关键数据存储在一个文件夹的数据文件夹中，但为了便于在开发中重复使用，可以在首次启动时使用“-Dcom.adobe.granite.crypto.file.disable=true”初始化AEM进程。 此进程在“/etc/key”处生成加密数据。
要重用包含加密值的内容包：
- 最初启动本地quickstart.jar时，请确保添加以下参数：“
-Dcom.adobe.granite.crypto.file.disable=true”。 Adobe建议您始终添加此代码。 - 首次启动实例时，请创建一个包，其中包含根“
/etc/key”的筛选器。 此包包含要在您希望重复使用它们的所有环境中重复使用的密码。 - 导出包含密钥的任何可变内容。 或者，通过
/crx/de查找加密值，以便将其添加到跨安装重复使用的包中。 - 每当启动新实例（要以新版本替换，或者多个开发环境应共享凭据进行测试）时，请安装步骤2和步骤3中生成的包。 这样，您就可以重复使用内容，而无需手动重新配置。 原因是现在加密密钥处于同步状态。