Utilização dos Componentes principais

Última atualização: 5 de maio de 2025

Criado para:

  • Desenvolvedor
  • Administrador
  • Usuário

Para começar a usar os Componentes principais no seu próprio projeto, há quatro etapas, que são detalhadas individualmente nas seções abaixo:

DICA
Para instruções mais detalhadas sobre como começar do zero com a configuração do projeto, os Componentes principais, Modelos editáveis, Bibliotecas de clientes e desenvolvimento de componentes, o tutorial abaixo, dividido em várias partes, pode ser de interesse:
Introdução ao AEM Sites - Tutorial do WKND
DICA
Se você usa o Arquétipo de projeto do AEM, os Componentes principais serão incluídos automaticamente em seu projeto com base nas práticas recomendadas da Adobe.

Download e instalação

Uma das ideias por trás dos componentes principais é a flexibilidade. O lançamento mais frequente de novas versões dos Componentes principais permite que a Adobe seja mais flexível em fornecer novos recursos. Os desenvolvedores, por sua vez, podem ser flexíveis em quais componentes escolher para integrar em seus projetos e com que frequência desejam atualizá-los. Isso resulta em um processo de versão separado para o AEM e os Componentes principais.

Portanto, se você estiver executando o AEM as a Cloud Service ou um serviço no local, as etapas de instalação serão determinadas.

AEM as a Cloud Service

Não há etapa um. O AEM as a Cloud Service vem automaticamente com a versão mais recente dos Componentes principais. Assim como o AEMaaCS oferece os recursos mais recentes do AEM, o AEMaaCS automaticamente mantém você atualizado com a versão mais recente dos Componentes principais.

Deve-se lembrar de alguns pontos ao usar os Componentes principais no AEMaaCS:

  • Os Componentes principais estão incluídos em /libs.
  • O pipeline de build de projeto gerará avisos no log se incluir os Componentes principais novamente como parte de /apps e ignorará a versão incorporada como parte do projeto.
    • Em uma próxima versão, incluir os Componentes principais novamente causará falha no build do pipeline.
  • Se o projeto incluiu os Componentes principais em /apps, talvez seja necessário ajustar o projeto.
  • Mesmo que os Componentes principais agora estejam em /libs, não é recomendável criar qualquer sobreposição do mesmo caminho em /apps. O padrão do componente proxy deve ser usado se qualquer aspecto dos componentes precisar ser personalizado.
  • Para que o Componente Tabela de conteúdos renderize seu conteúdo, um filtro precisa ser configurado no OSGi.

AEM 6.5 e anteriores

Os Componentes principais não fazem parte do início rápido ao iniciar no modo de produção (sem conteúdo de amostra). Portanto, seu primeiro passo é baixar o pacote de conteúdo mais recente lançado do GitHub e instalá-lo em seus ambientes do AEM.

Há várias maneiras de automatizar isso, mas a maneira mais simples de instalar rapidamente um pacote de conteúdo em uma instância é usando o Gerenciador de Pacotes. Consulte Instalar pacotes. Além disso, uma vez que uma instância de publicação também estiver em execução, será necessário replicar esse pacote para o editor. Consulte Replicação de pacotes.