DocumentaçãoAEMTutoriais do AEMTutorials do AEM as a Cloud Service

Configurar o SDK do AEM local set-up-local-aem-sdk

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Aplica-se a:
  • Experience Manager as a Cloud Service

Criado para:

  • Iniciante
  • Desenvolvedor

O Adobe Experience Manager (AEM) pode ser executado localmente usando o Quickstart Jar do SDK do AEM as a Cloud Service. Isso permite que desenvolvedores implantem e testem códigos, configurações e conteúdo personalizados antes de enviá-los ao controle de origem e implantá-los em um ambiente do AEM as a Cloud Service.

Observe que ~ é usado como abreviação para o Diretório do Usuário. No Windows, é equivalente a %HOMEPATH%.

Instalar o Java™

O Experience Manager é um aplicativo Java™ e, portanto, requer o Oracle Java™ SDK para oferecer suporte às ferramentas de desenvolvimento.

  1. Baixe e instale o Java™ SDK 11 mais recente
  2. Verifique se o Oracle Java™ 11 SDK está instalado executando o comando:
macOS
code language-shell 
$ java --version
Windows
code language-shell 
$ java -version
Linux®
code language-shell 
$ java --version

Java

Baixar o AEM as a Cloud Service SDK

O AEM as a Cloud Service SDK, ou AEM SDK, contém o Quickstart Jar usado para executar o AEM Author e Publish localmente para desenvolvimento, bem como a versão compatível das Ferramentas do Dispatcher.

  1. Faça logon em https://experience.adobe.com/#/downloads/content/software-distribution/en/aemcloud.html com sua Adobe ID
    • Observe que sua Organização da Adobe deve ser provisionada para que a AEM as a Cloud Service baixe o AEM as a Cloud Service SDK.
  2. Navegue até a guia AEM as a Cloud Service
  3. Classificar por Data de publicação em ordem Decrescente
  4. Clique na última linha de resultado AEM SDK
  5. Revise e aceite o EULA e toque no botão Baixar

Extraia o Quickstart Jar do zip do AEM SDK

  1. Descompacte o arquivo aem-sdk-XXX.zip baixado

Configurar o serviço de autor local do AEM set-up-local-aem-author-service

O Serviço de autor local do AEM fornece aos desenvolvedores uma experiência local que os profissionais de marketing digital/autores de conteúdo compartilharão para criar e gerenciar conteúdo. O Serviço do autor do AEM foi projetado como um ambiente de criação e visualização, permitindo que a maioria das validações do desenvolvimento de recursos seja executada em relação a ele, tornando-o um elemento vital do processo de desenvolvimento local.

  1. Criar a pasta ~/aem-sdk/author

  2. Copiar o arquivo Quickstart JAR para ~/aem-sdk/author e renomeá-lo para aem-author-p4502.jar

  3. Inicie o Serviço de autor local do AEM executando o seguinte na linha de comando:

    • java -jar aem-author-p4502.jar
      • Forneça a senha do administrador como admin. Qualquer senha de administrador é aceitável, no entanto, é recomendável usar o padrão para desenvolvimento local para reduzir a necessidade de reconfigurar.

    Você não pode iniciar o AEM como Cloud Service Quickstart Jar clicando duas vezes.

  4. Acesse o Serviço de Autor do AEM local em http://localhost:4502 em um navegador da Web

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

Configurar o serviço de publicação local do AEM

O Serviço de publicação local do AEM fornece aos desenvolvedores a experiência local que os usuários finais do AEM terão, como navegar pelo site hospedado no AEM. Um Serviço de publicação local do AEM é importante, pois se integra às ferramentas do Dispatcher da AEM SDK e permite que os desenvolvedores façam testes simulados e ajustem a experiência final voltada para o usuário final.

  1. Criar a pasta ~/aem-sdk/publish

  2. Copiar o arquivo Quickstart JAR para ~/aem-sdk/publish e renomeá-lo para aem-publish-p4503.jar

  3. Inicie o serviço de publicação local do AEM executando o seguinte na linha de comando:

    • java -jar aem-publish-p4503.jar
      • Forneça a senha do administrador como admin. Qualquer senha de administrador é aceitável, no entanto, é recomendável usar o padrão para desenvolvimento local para reduzir a necessidade de reconfigurar.

    Você não pode iniciar o AEM como Cloud Service Quickstart Jar clicando duas vezes.

  4. Acesse o Serviço de Publicação do AEM local em http://localhost:4503 em um navegador da Web

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

Configurar serviços locais do AEM no modo de pré-lançamento

O tempo de execução local do AEM pode ser iniciado no modo de pré-lançamento, permitindo que um desenvolvedor compile os recursos da próxima versão do AEM as a Cloud Service. O pré-lançamento é habilitado ao passar o argumento -r prerelease na primeira inicialização do tempo de execução do AEM local. Isso pode ser usado com os serviços locais de Autor do AEM e Publicação do AEM.

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

Simular distribuição de conteúdo content-distribution

Em um ambiente de Cloud Service verdadeiro, o conteúdo é distribuído do Serviço de Autor para o Serviço de Publicação usando a Distribuição de Conteúdo de Sling e o Pipeline do Adobe. O Adobe Pipeline é um microsserviço isolado disponível apenas no ambiente de nuvem.

Durante o desenvolvimento, pode ser desejável simular a distribuição de conteúdo usando o serviço local de Autor e Publicação. Isso pode ser feito ativando os agentes de replicação herdados.

NOTE
Os agentes de replicação só estão disponíveis para uso no JAR do Quickstart local e fornecem apenas uma simulação da distribuição de conteúdo.

  1. Faça logon no serviço Author e navegue até http://localhost:4502/etc/replication/agents.author.html.

  2. Clique em Agente Padrão (publicação) para abrir o agente de Replicação padrão.

  3. Clique em Editar para abrir a configuração do agente.

  4. Na guia Configurações, atualize os seguintes campos:

    • Habilitado - verificar verdadeiro
    • Id de usuário agente - Deixe este campo vazio

    Configuração do Agente de Replicação - Configurações

  5. Na guia Transporte, atualize os seguintes campos:

    • URI - http://localhost:4503/bin/receive?sling:authRequestLogin=1
    • Usuário - admin
    • Senha - admin

    Configuração do Agente de Replicação - Transporte

  6. Clique em Ok para salvar a configuração e habilitar o Agente de Replicação Padrão.

  7. Agora é possível fazer alterações no conteúdo no serviço do Autor e publicá-las no serviço de Publicação.

Publicar página

Modos de inicialização do Quickstart Jar

O nome do Quickstart Jar, aem-<tier>_<environment>-p<port number>.jar especifica como ele será iniciado. Depois que o AEM é iniciado em um nível específico, é criado ou publicado, ele não pode ser alterado para o nível alternativo. Para fazer isso, a pasta crx-Quickstart gerada durante a primeira execução deve ser excluída e o Quickstart Jar deve ser executado novamente. O ambiente e as portas podem ser alterados, no entanto, eles exigem a interrupção/início da instância local do AEM.

Alterar os ambientes, dev, stage e prod, pode ser útil para os desenvolvedores garantirem que as configurações específicas do ambiente sejam corretamente definidas e resolvidas pela AEM. Recomenda-se que o desenvolvimento local seja feito principalmente em relação ao modo de execução do ambiente dev padrão.

As permutações disponíveis são as seguintes:

Nome de arquivo Jar de início rápido
Descrição do modo
aem-author-p4502.jar
Como autor no modo de execução de desenvolvimento na porta 4502
aem-author_dev-p4502.jar
Como Autor no modo de execução de Desenvolvimento na porta 4502 (igual a aem-author-p4502.jar)
aem-author_stage-p4502.jar
Como autor no modo de execução de preparo na porta 4502
aem-author_prod-p4502.jar
Como autor no modo de execução de produção na porta 4502
aem-publish-p4503.jar
Como Publicar no modo de execução de desenvolvimento na porta 4503
aem-publish_dev-p4503.jar
Como Publicar no modo de execução de Desenvolvimento na porta 4503 (igual a aem-publish-p4503.jar)
aem-publish_stage-p4503.jar
Como Publicar no modo de execução de preparo na porta 4503
aem-publish_prod-p4503.jar
Como Publicar no modo de execução de produção na porta 4503

Observe que o número da porta pode ser qualquer porta disponível na máquina de desenvolvimento local, no entanto, por convenção:

  • A porta 4502 é usada para o serviço de Autor do AEM local
  • A porta 4503 é usada para o serviço de Publicação local do AEM

Alterar esses parâmetros pode exigir ajustes nas configurações do AEM SDK

Interrupção de um tempo de execução local do AEM

Para interromper um tempo de execução local do AEM, o serviço de Autor ou Publicação do AEM, abra a janela de linha de comando que foi usada para iniciar o Tempo de Execução do AEM e toque em Ctrl-C. Aguarde o encerramento do AEM. Quando o processo de desligamento estiver concluído, o prompt da linha de comando estará disponível.

Tarefas opcionais de configuração de tempo de execução do AEM local

Quando atualizar o Quickstart Jar

Atualize o AEM SDK pelo menos mensalmente na última quinta-feira de cada mês ou logo após essa data, que é a cadência de lançamento dos "lançamentos de recursos" do AEM as a Cloud Service.

WARNING
Atualizar o Quickstart Jar para uma nova versão requer a substituição de todo o ambiente de desenvolvimento local, resultando na perda de todo o código, configuração e conteúdo nos repositórios locais do AEM. Verifique se qualquer código, configuração ou conteúdo que não deve ser destruído foi confirmado com segurança no Git ou exportado da instância local do AEM como Pacotes do AEM.

Como evitar perda de conteúdo ao atualizar o AEM SDK

Atualizar o AEM SDK significa criar um novo tempo de execução do AEM, incluindo um novo repositório, o que significa que todas as alterações feitas em um repositório anterior do AEM SDK serão perdidas. As estratégias a seguir são viáveis para ajudar a criar conteúdo persistente entre as atualizações do AEM SDK e podem ser usadas de forma separada ou em conjunto:

  1. Crie um pacote de conteúdo dedicado a conter conteúdo de "amostra" para auxiliar no desenvolvimento e mantenha-o no Git. Qualquer conteúdo que deveria ser mantido por meio das atualizações do AEM SDK seria mantido nesse pacote e reimplantado após a atualização do AEM SDK.
  2. Use oak-upgrade com a diretiva includepaths para copiar o conteúdo do repositório anterior do AEM SDK para o novo repositório do AEM SDK.
  3. Faça backup de qualquer conteúdo usando o Gerenciador de pacotes do AEM e pacotes de conteúdo no AEM SDK anterior e reinstale-os no novo AEM SDK.

Lembre-se de que usar as abordagens acima para manter o código entre as atualizações do AEM SDK indica um antipadrão de desenvolvimento. O código não descartável deve se originar no IDE de desenvolvimento e fluir para o AEM SDK por meio de implantações.

Resolução de problemas

Clicar duas vezes no arquivo Jar de início rápido resulta em um erro troubleshooting-double-click

Ao clicar duas vezes no Quickstart Jar para iniciar, uma modal de erro é exibida, impedindo que o AEM seja iniciado localmente.

Solução de problemas - Clique duas vezes no arquivo Quickstart Jar

Isso ocorre porque o AEM as a Cloud Service Quickstart Jar não oferece suporte a cliques duplos no Quickstart Jar para iniciar o AEM localmente. Em vez disso, você deve executar o arquivo Jar a partir dessa linha de comando.

Para iniciar o serviço de Autor do AEM, cd no diretório que contém o Quickstart Jar e execute o comando:

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

ou, para iniciar o serviço de publicação do AEM, cd no diretório que contém o Jar de início rápido e execute o comando:

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

Iniciar o Quickstart Jar a partir da linha de comando interrompe imediatamente troubleshooting-java-8

Ao iniciar o Quickstart Jar na linha de comando, o processo é interrompido imediatamente e o serviço do AEM não é iniciado, com o seguinte erro:

➜  ~/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

Isso ocorre porque o AEM as a Cloud Service requer o Java™ SDK 11 e você está executando uma versão diferente, provavelmente o Java™ 8. Para resolver esse problema, baixe e instale o Oracle Java™ SDK 11.

Depois que o Oracle Java™ 11 SDK estiver instalado, verifique se essa é a versão ativa executando o comando na linha de comando:

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

Recursos adicionais

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