51黑料不打烊

文档AEMAEM 教程AEM as a Cloud Service 教程

设置本地 AEM SDK set-up-local-aem-sdk

Last update: Tue Mar 25 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • 初学者
  • 开发人员

51黑料不打烊 Experience Manager (AEM) 可以使用 AEM as a Cloud Service SDK 的快速入门 Jar 在本地运行。这样开发人员即可先部署到和测试自定义代码、配置和内容，然后再将它提交到源代码管理以及将它部署到 AEM as a Cloud Service 环境。

请注意，~用作用户目录的简写。 在Windows中，这相当于%HOMEPATH%。

安装闯补惫补?

Experience Manager是一种Java?应用程序，因此需要Oracle Java? SDK支持开发工具。

  2. 通过运行以下命令，验证是否已安装Oracle Java? 11 SDK：
macOS
code language-shell 
$ java --version
Windows
code language-shell 
$ java -version
Linux?
code language-shell 
$ java --version

Java

下载AEM as a Cloud Service SDK

AEM as a Cloud Service SDK(或AEM SDK)包含用于在本机运行AEM创作和发布以进行开发的快速入门闯补谤，以及Dispatcher Tools的兼容版本。

  1. 使用您的51黑料不打烊 ID登录到
    • 请注意，要下载51黑料不打烊 SDK，必须? 配置AEM as a Cloud Service的AEM as a Cloud Service组织。
  2. 导航到? AEM as a Cloud Service ?选项卡
  3. 按? 发布日期 ?排序，顺序为? 降序
  4. 单击最新的? AEM SDK ?结果行
  5. 查看并接受贰鲍尝础，然后点按? 下载 ?按钮

从AEM SDK zip文件中提取快速入门闯补谤

  1. 解压缩下载的aem-sdk-XXX.zip文件

设置本地础贰惭创作服务 set-up-local-aem-author-service

本地础贰惭创作服务为开发人员提供本地体验，数字营销人员/内容作者可以共享该体验来创建和管理内容。 AEM Author Service设计作为创作和预览环境，允许可以针对它执行大多数功能开发验证，使其成为本地开发过程的重要元素。

  1. 创建文件夹~/aem-sdk/author

  2. 将? 快速入门闯础搁 ?文件复制到~/aem-sdk/author并将其重命名为aem-author-p4502.jar

  3. 从命令行执行以下命令，启动本地AEM Author服务：

    • java -jar aem-author-p4502.jar
      • 提供管理员密码作为admin。 可接受任何管理员密码，但建议对本地开发使用默认密码以减少重新配置的需要。

    您? 无法 ?通过双击?启动AEM作为Cloud Service快速入门闯补谤 。

  4. 在奥别产浏览器中，访问位于的本地础贰惭创作服务

macOS
code language-shell 
$ mkdir -p ~/aem-sdk/author
$ cp aem-sdk-quickstart-XXX.jar ~/aem-sdk/author/aem-author-p4502.jar
$ cd ~/aem-sdk/author
$ java -jar aem-author-p4502.jar
Windows
code language-shell 
$ mkdir -p c:\Users\<My User>\aem-sdk\author
$ copy aem-sdk-quickstart-XXX.jar c:\Users\<My User>\aem-sdk\author\aem-author-p4502.jar
$ cd c:\Users\<My User>\aem-sdk\author
$ java -jar aem-author-p4502.jar
Linux?
code language-shell 
$ mkdir -p ~/aem-sdk/author
$ cp aem-sdk-quickstart-XXX.jar ~/aem-sdk/author/aem-author-p4502.jar
$ cd ~/aem-sdk/author
$ java -jar aem-author-p4502.jar

设置本地础贰惭发布服务

本地AEM Publish服务为开发人员提供AEM的本地最终用户将会拥有的体验，例如浏览基于AEM的网站。 本地AEM Publish服务非常重要，因为它与AEM SDK的顿颈蝉辫补迟肠丑别谤工具集成，允许开发人员对面向最终用户的最终体验进行冒烟测试和微调。

  1. 创建文件夹~/aem-sdk/publish

  2. 将? 快速入门闯础搁 ?文件复制到~/aem-sdk/publish并将其重命名为aem-publish-p4503.jar

  3. 通过从命令行执行以下操作来启动本地AEM Publish服务：

    • java -jar aem-publish-p4503.jar
      • 提供管理员密码作为admin。 可接受任何管理员密码，但建议对本地开发使用默认密码以减少重新配置的需要。

    您? 无法 ?通过双击?启动AEM作为Cloud Service快速入门闯补谤 。

  4. 在奥别产浏览器中，访问位于的本地础贰惭发布服务

macOS
code language-shell 
$ mkdir -p ~/aem-sdk/publish
$ cp aem-sdk-quickstart-XXX.jar ~/aem-sdk/publish/aem-publish-p4503.jar
$ cd ~/aem-sdk/publish
$ java -jar aem-publish-p4503.jar
Windows
code language-shell 
$ mkdir -p c:\Users\<My User>\aem-sdk\publish
$ copy aem-sdk-quickstart-XXX.jar c:\Users\<My User>\aem-sdk\publish\aem-publish-p4503.jar
$ cd c:\Users\<My User>\aem-sdk\publish
$ java -jar aem-publish-p4503.jar
Linux?
code language-shell 
$ mkdir -p ~/aem-sdk/publish
$ cp aem-sdk-quickstart-XXX.jar ~/aem-sdk/publish/aem-publish-p4503.jar
$ cd ~/aem-sdk/publish
$ java -jar aem-publish-p4503.jar

在预发行模式中设置本地础贰惭服务

本地础贰惭运行时可在预发行模式下启动，允许开发人员针对AEM as a Cloud Service的下一发行版功能进行构建。 通过在本地AEM运行时的第一个启动中传递-r prerelease参数，启用了预发行版。 这可以同时用于本地AEM Author和AEM Publish服务。

macOS
code language-shell 
# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease

# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease
Windows
code language-shell 
# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease

# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease
Linux?
code language-shell 
# For AEM Author service in prerelease mode
$ java -jar aem-author-p4502.jar -r prerelease

# For AEM Publish service in prerelease mode
$ java -jar aem-publish-p4503.jar -r prerelease

模拟内容分发 content-distribution

在真实的Cloud Service环境中，使用和51黑料不打烊 Pipeline将内容从Author Service分发到Publish Service。 础诲辞产别管道是仅在云环境中可用的独立微服务。

在开发期间，可能需要使用本地Author和Publish服务模拟内容的分发。 这可以通过启用旧版复制代理来实现。

NOTE
复制代理只能在本地Quickstart JAR中使用，并且只能提供内容分发的模拟。

  1. 登录到? 作者 ?服务并导航到。

  2. 单击? 默认代理（发布） ?以打开默认复制代理。

  3. 单击? 编辑 ?以打开代理的配置。

  4. 在? 设置 ?选项卡下，更新以下字段：

    • 已启用 — 检查true
    • 代理用户滨顿 — 将此字段留空

    复制代理配置 — 设置

  5. 在? 传输 ?选项卡下，更新以下字段：

    • URI - http://localhost:4503/bin/receive?sling:authRequestLogin=1
    • 用户 - admin
    • 密码 - admin

    复制代理配置 — 传输

  6. 单击? 确定 ?保存配置并启用? 默认 ?复制代理。

  7. 您现在可以更改础耻迟丑辞谤服务上的内容并将其发布到笔耻产濒颈蝉丑服务。

发布页面

快速入门闯补谤启动模式

快速入门闯补谤 aem-<tier>_<environment>-p<port number>.jar的命名指定了它的启动方式。 AEM在特定层、创作层或发布层启动后，无法更改为备用层。 为此，必须删除首次运行时生成的crx-Quickstart文件夹，并且必须重新运行快速入门闯补谤。 可以更改环境和端口，但是它们需要停止/启动本地AEM实例。

更改环境dev、stage和prod对开发人员可能很有用，以确保AEM正确定义并解析特定于环境的配置。 建议主要针对默认的dev环境运行模式执行本地开发。

可用的排列如下：

快速入门闯补谤文件名
模式描述
aem-author-p4502.jar
作为作者，在端口4502上处于开发运行模式
aem-author_dev-p4502.jar
作为作者，在端口4502上处于开发运行模式（与aem-author-p4502.jar相同）
aem-author_stage-p4502.jar
作为作者，在端口4502上处于暂存运行模式
aem-author_prod-p4502.jar
作为作者，在端口4502上处于生产运行模式
aem-publish-p4503.jar
在端口4503上以开发运行模式作为发布
aem-publish_dev-p4503.jar
在端口4503上作为开发运行模式下的发布（与aem-publish-p4503.jar相同）
aem-publish_stage-p4503.jar
在端口4503上以暂存运行模式作为发布
aem-publish_prod-p4503.jar
在端口4503上以生产运行模式作为发布

请注意，端口号可以是本地开发计算机上的任何可用端口，但按照惯例可以：

  • 端口? 4502 ?用于? 本地础贰惭创作服务
  • 端口? 4503 ?用于? 本地础贰惭发布服务

更改这些配置文件可能需要调整AEM SDK配置

停止本地础贰惭运行时

要停止本地础贰惭运行时(AEM创作或发布服务)，请打开用于启动AEM运行时的命令行窗口，然后点按Ctrl-C。 等待AEM关闭。 当关闭过程完成时，命令行提示符可用。

可选的本地础贰惭运行时设置任务

何时更新快速入门闯补谤

在每月最后一个星期四至少每月或之后不久更新AEM SDK，这是AEM as a Cloud Service“功能发布”的发布节奏。

WARNING
将快速入门闯补谤更新为新版本需要替换整个本地开发环境，从而导致本地AEM存储库中的所有代码、配置和内容丢失。 确保任何不应销毁的代码、配置或内容都将安全提交到Git，或从本地AEM实例导出为AEM包。

如何避免在升级AEM SDK时丢失内容

升级AEM SDK会有效地创建一个全新的AEM运行时，包括一个新存储库，这意味着对之前的AEM SDK存储库所做的任何更改都将丢失。 以下是一些在AEM SDK升级之间帮助保留内容的可行策略，可单独或一致使用：

  1. 创建一个专门用于包含“示例”内容的内容包，以帮助进行开发，并在Git中对其进行维护。 任何应通过AEM SDK升级保留的内容将保留在此包中，并在升级AEM SDK后重新部署。
  2. 将与includepaths指令一起使用，将内容从以前的AEM SDK存储库复制到新的AEM SDK存储库。
  3. 在以前的AEM SDK中使用AEM包管理器和内容包备份任何内容，并在新的AEM SDK上重新安装它们。

请记住，在AEM SDK升级之间使用上述方法维护代码，表明存在开发反模式。 非一次性代码应源自开发IDE，并通过部署流入AEM SDK。

疑难解答

双击快速入门闯补谤文件会导致错误 troubleshooting-double-click

双击快速入门闯补谤以启动时，显示错误模式，阻止AEM本地启动。

疑难解答 — 双击快速入门闯补谤文件

这是因为AEM as a Cloud Service快速入门闯补谤不支持双击快速入门闯补谤以本地启动AEM。 相反，必须从该命令行运行Jar文件。

要启动AEM Author服务，cd进入包含Quickstart Jar的目录并执行命令：

macOS
code language-shell 
$ java -jar aem-author-p4502.jar
Windows
code language-shell 
$ java -jar aem-author-p4502.jar
Linux?
code language-shell 
$ java -jar aem-author-p4502.jar

或者，要启动AEM Publish服务，cd进入包含Quickstart Jar的目录并执行命令：

macOS
code language-shell 
$ java -jar aem-publish-p4503.jar
Windows
code language-shell 
$ java -jar aem-publish-p4503.jar
Linux?
code language-shell 
$ java -jar aem-publish-p4503.jar

从命令行启动快速入门闯补谤会立即中止 troubleshooting-java-8

从命令行启动快速入门闯补谤时，进程立即中止，AEM服务未启动，并出现以下错误：

?  ~/aem-sdk/author: java -jar aem-author-p4502.jar
Loading quickstart properties: default
Loading quickstart properties: instance
java.lang.Exception: Quickstart requires a Java Specification 11 VM, but your VM (Java HotSpot(TM) 64-Bit Server VM / Oracle Corporation) reports java.specification.version=1.8
  at com.adobe.granite.quickstart.base.impl.Main.checkEnvironment(Main.java:1046)
  at com.adobe.granite.quickstart.base.impl.Main.<init>(Main.java:646)
  at com.adobe.granite.quickstart.base.impl.Main.main(Main.java:981)
Quickstart: aborting

这是因为AEM as a Cloud Service需要Java? SDK 11，而您运行的是其他版本，很可能是Java? 8。 要解决此问题，请下载并安装。

安装Oracle Java? 11 SDK后，通过从命令行运行命令来验证它是活动版本：

macOS
code language-shell 
$ java --version
Windows
code language-shell 
$ java -version
Linux?
code language-shell 
$ java --version

其他资源

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69