Documentação AEM Guia dos Componentes principais

Versões dos Componentes principais

Última atualização: 1 de abril de 2025

Tópicos:
Componentes principais

Criado para:

Desenvolvedor
Administrador
Usuário

Os componentes principais são compatíveis com instalações do AEM as a Cloud Service e do AEM no local.

Histórico e compatibilidade da versão

Os Componentes principais foram projetados para serem flexíveis e compatíveis com todas as versões do AEM. Por causa disso, uma versão dos componentes pode conter várias versões do mesmo componente.

As tabelas a seguir ilustram a compatibilidade das versões dos Componentes principais, juntamente com as versões dos componentes em que elas estão contidas.

Histórico e requisitos da versão

A tabela a seguir, cujo conteúdo está disponível no GitHub com detalhes completos da versão, fornece uma visão geral das versões dos Componentes principais e sua compatibilidade com as versões do AEM e do Java.

Versão	Descrição	AEM 6.4	AEM 6.5	AEM as a Cloud Service	Java	Data de lançamento
2.28.0	Esta versão aborda várias correções de erros.	-	6.5.21.0+	Contínuo	8, 11	17 de março de 2025
2.27.0	Esta versão aborda várias correções de erros.	-	6.5.21.0+	Contínuo	11	10 de setembro de 2024
2.26.0	Esta versão aborda várias correções de erros.	-	6.5.21.0+	Contínuo	11	31 de julho de 2024
2.25.4	Esta é uma versão secundária que corrige algumas falhas de TI.	-	6.5.21.0+	Contínuo	8, 11	10 de maio de 2024
2.25.2	Esta é uma versão secundária que corrige algumas falhas de TI.	-	6.5.21.0+	Contínuo	8, 11	9 de maio de 2024
2.25.0	Esta versão adiciona suporte para smartcrops nomeados no Dynamic Media, inclui melhorias de desempenho e acessibilidade e várias correções de erros.	-	6.5.21.0+	Contínuo	8, 11	2 de maio de 2024
2.24.6	Esta correção inclui melhorias para a inicialização da camada de dados.	-	6.5.21.0+	Contínuo	8, 11	22 de abril de 2024
2.24.4	Esta correção resolve o problema de uma inicialização do modelo Sling.	-	6.5.21.0+	Contínuo	8, 11	1º de abril de 2024
2.24.2	Esta correção melhora a estabilidade dos testes de integração.	-	6.5.21.0+	Contínuo	8, 11	22 de fevereiro de 2024
2.24.0	Esta versão adiciona suporte para a camada de dados do Google Tag Manager e inclui várias correções de erros.	-	6.5.21.0+	Contínuo	8, 11	14 de fevereiro de 2024
2.23.4	Esta versão de correção inclui várias correções de erros.	-	6.5.17.0+	Contínuo	8, 11	15 de setembro de 2023
2.23.2	Esta versão de correção adiciona o corte inteligente do Dynamic Media para ativos remotos aos componentes de imagem e teaser, além de corrigir vários erros.	-	6.5.17.0+	Contínuo	8, 11	4 de agosto de 2023
2.23.0	Esta versão inclui suporte para ativos remotos do Dynamic Media de última geração.	-	6.5.17.0+	Contínuo	8, 11	6 de junho de 2023
2.22.12	Esta versão de correção soluciona dois problemas.	-	6.5.14.0+	Contínuo	8, 11	25 de maio de 2023
2.22.10	Esta versão de correção corrige duas regressões.	-	6.5.14.0+	Contínuo	8, 11	11 de maio de 2023
2.22.8	Esta versão de correção traz de volta recursos que foram removidos acidentalmente na versão anterior.	-	6.5.14.0+	Contínuo	8, 11	9 de maio de 2023
2.22.6	Esta versão de correção corrige uma regressão no componente de container.	-	6.5.14.0+	Contínuo	8, 11	21 de abril de 2023
2.22.4	Esta é uma versão de correção para corrigir um problema no Componente de lista de fragmentos de conteúdo.	-	6.5.14.0+	Contínuo	8, 11	5 de abril de 2023
2.22.2	Esta é uma versão de manutenção para lidar com dois problemas introduzidos na versão 2.22.0	-	6.5.14.0+	Contínuo	8, 11	31 de março de 2023
2.22.0	Este lançamento apresenta uma nova versão do componente de Lista, juntamente com aprimoramentos do Teaser e a atualização do visualizador de PDF e do Carrossel	-	6.5.14.0+	Contínuo	8, 11	9 de fevereiro de 2023
2.21.2	Esta é uma versão de correção para corrigir um problema com v1 e v2 Componentes do Teaser.	-	6.5.13.0+	Contínuo	8, 11	12 de setembro de 2022
2.21.0	Esta versão inclui várias melhorias, como a publicação da API do LinkHandler, melhorias no Componente de imagem e na Camada de dados, bem como melhorias nos componentes de múltiplos painéis.	-	6.5.13.0+	Contínuo	8, 11	12 de setembro de 2022
2.20.8	Esta versão corrige um problema na entrega de imagens de SVG pelo AdaptiveImageServlet.	-	6.5.13.0+	Contínuo	8, 11	4 de agosto de 2022
2.20.6	Esta versão de correção corrige um problema com o novo Componente de índice.	-	6.5.13.0+	Contínuo	8, 11	7 de julho de 2022
2.20.4	Esta versão de correção corrige um problema com o novo Componente de índice.	-	6.5.13.0+	Contínuo	8, 11	29 de junho de 2022
2.20.2	Esta é uma versão de correção que corrige um problema no novo serviço de entrega de ativos otimizados para a Web do AEMaaCS.	-	6.5.13.0+	Contínuo	8, 11	20 de junho de 2022
2.20.0	Esta versão adiciona um novo Componente de índice, compatibilidade com o serviço de entrega de ativos otimizados para a Web do AEMaaCS e inclui correções de erros.	-	6.5.13.0+	Contínuo	8, 11	9 de junho de 2022
2.19.0	Este lançamento adiciona uma nova versão ao Componente de pesquisa e recursos ao Componente do botão, assim como muitas melhorias de acessibilidade e correções de erros.	-	6.5.10.0+	Contínuo	8, 11	7 de abril de 2022
2.18.8	Esta versão corrige um problema no AEMaaCS.	-	6.5.10.0+	Contínuo	8, 11	17 de março de 2022
2.18.6	Esta é uma versão de correção.	-	6.5.10.0+	Contínuo	8, 11	3 de março de 2022
2.18.0	Essa versão principal dos componentes principais introduz um novo manipulador de links para novas versões de vários componentes, juntamente com muitas melhorias de acessibilidade e correções de erros.	-	6.5.10.0+ *	Contínuo	8, 11	16 de fevereiro de 2022
2.17.14	Esta é uma versão de correção.	6.4.8.4+	6.5.6.0+	Contínuo	8, 11	13 de dezembro de 2021
2.17.12	Esta é uma versão de correção que corrige uma regressão introduzida na versão anterior.	6.4.8.4+	6.5.6.0+	Contínuo	8, 11	1 de outubro de 2021
2.17.10	Esse patch melhora os componentes Lista e Navegação para exibir o URL externo para destinos de redirecionamento, habilita a herança de imagens da página para a próxima v2 do componente Teaser e contém outras correções de erros.	6.4.8.4+	6.5.6.0+	Contínuo	8, 11	31 de agosto de 2021
2.17.8	Esta é uma versão de patch para corrigir uma alteração incompatível com versões anteriores que foi introduzida anteriormente.	6.4.8.4+	6.5.6.0+	Contínuo	8, 11	2 de agosto de 2021
2.17.6	Esta versão de patch adiciona suporte para mapas de site para Páginas e inclui várias melhorias de acessibilidade.	6.4.8.4+	6.5.6.0+	Contínuo	8, 11	29 de julho de 2021
2.17.2	Esta versão de patch inclui uma correção para a Camada de dados que não está funcionando com o AEMaaCS.	6.4.8.4+	6.5.6.0+	Contínuo	8, 11	8 de julho de 2021
2.17.0	Esta versão inclui visualizações técnicas de várias versões de novos componentes que oferecem suporte a recursos do manipulador de links, bem como uma visualização técnica de um recurso de imagem em destaque para o componente de Página. Várias correções de erros também estão incluídas.	6.4.8.4+	6.5.6.0+	Contínuo	8, 11	16 de junho de 2021
2.16.4	Esta é uma versão de patch para corrigir um problema com o novo Manipulador de links.	6.4.8.1+	6.5.5.0+	Contínuo	8, 11	19 de maio de 2021
2.16.2	Esta foi uma versão de patch corrigindo principalmente um problema com o novo Manipulador de links e adicionando um aprimoramento para suportar aplicativos de várias páginas para PWA.	6.4.8.1+	6.5.5.0+	Contínuo	8, 11	15 de maio de 2021
2.16.0	Essa versão se concentrou em melhorias de acessibilidade, bem como na introdução de um novo Manipulador de links para os componentes existentes.	6.4.8.1+	6.5.5.0+	Contínuo	8, 11	22 de abril de 2021
2.15.2	Essa foi uma versão de patch corrigindo problemas principalmente de compatibilidade com versões anteriores da Camada de dados e falha nos testes de TI em determinadas situações.	6.4.8.1+	6.5.5.0+	Contínuo	8, 11	16 de março de 2021
2.15.0	Essa versão inclui suporte para aplicativos web progressivos (PWA) no componente de Página e é compatível com a versão 2.0.0 da Camada de dados da Adobe.	6.4.8.1+	6.5.5.0+	Contínuo	8, 11	23 de fevereiro de 2021
2.14.0	Essa versão inclui novas opções para o Componente de Incorporação e introduz o Brand Slug no nível da página, bem como a resolução de muitos problemas.	6.4.8.1+	6.5.5.0+	Contínuo	8, 11	9 de fevereiro de 2021
2.13.2	Essa foi uma versão de patch que abordou um problema com o RTE quando usado no AEMaaCS	6.4.8.1+	6.5.5.0+	Contínuo	8, 11	16 de dezembro de 2020
2.13.0	Essa versão inclui novos recursos do Dynamic Media para o componente de Imagem.	6.4.8.1+	6.5.5.0+	Contínuo	8, 11	4 de dezembro de 2020
2.12.2	Essa foi uma versão de patch para 2.12.0, incluindo pequenas correções.	6.4.8.1+	6.5.5.0+	Contínuo	8, 11	11 de novembro de 2020
2.12.1	Essa foi uma versão de patch para 2.12.0 que corrige um erro principal no componente de Imagem.	6.4.8.1+	6.5.5.0+	Contínuo	8, 11	5 de novembro de 2020
2.12.0	Essa versão apresentou um novo manipulador de formulário POST; a capacidade de incluir CSS personalizado, JavaScript e tags de metadados pela configuração com reconhecimento de contexto; e um utilitário `DataLayerBuilder` para simplificar a integração da camada de dados em componentes personalizados.	6.4.8.1+	6.5.5.0+	Contínuo	8, 11	29 de outubro de 2020
2.11.0	Essa versão introduziu o suporte ao AMP.	6.4.8.1+	6.5.5.0+	Contínuo	8, 11	20 de julho de 2020
2.10.0	Essa versão apresentou o componente de Visualizador de PDF.	6.4.8.1+	6.5.5.0+	Contínuo	8, 11	17 de junho de 2020
2.9.0	Essa versão habilitou a integração com a Camada de Dados de clientes Adobe e introduziu o componente de Barra de progresso.	6.4.8.0+	6.5.4.0+	Contínuo	8, 11	29 de maio de 2020
2.8.0	Essa versão enfocou correções com pequenos aprimoramentos.	6.4.4.0+	6.5.0.0+	Contínuo	8, 11	5 de dezembro de 2019
2.7.0	Essa versão apresentou o novo componente de Incorporação.	6.4.4.0+	6.5.0.0+	Contínuo	8, 11	25 de setembro de 2019
2.6.0	Essa versão apresentou o novo componente de Fragmento de experiência.	6.4.4.0+	6.5.0.0+	Contínuo	8, 11	6 de setembro de 2019
2.5.0	Essa versão apresentou os novos componentes Acordeão, Botão, Container e Download.	6.4.2.0+	6.5.0.0+	Contínuo	8, 11	25 de junho de 2019
2.4.0	Essa versão apresentou o componente de Lista de fragmentos de conteúdo.	6.4.2.0+	6.5.0.0+	Contínuo	8, 11	7 de maio de 2019
2.3.2	Essa versão enfocou refinamentos da Biblioteca de componentes, mas também contém algumas melhorias de recursos para o componente Separador.	6.4.2.0+	6.5.0.0+	Contínuo	8	14 de março de 2019
2.3.0	Essa versão focou a Biblioteca de componentes e introduziu o novo Componente de Separador, mas também contém algumas melhorias de recursos para o Componente de Imagem.	6.4.2.0+	-	-	8	11 de fevereiro de 2019
2.2.2	Essa versão focou principalmente correções de erros, mas também contém algumas melhorias de recursos para o componente Carrossel.	6.4.2.0+	-	-	8	27 de novembro de 2018
2.2.0	Essa versão introduziu o componente de Guias e o componente Carrossel, melhorias no componente de Imagem, componente de Página e componente de Título, e rastreamento aprimorado.	6.4.2.0+	-	-	8	16 de outubro de 2018
2.1.0	Esta versão introduziu o componente de Teaser juntamente com aprimoramentos no componente de Imagem e várias correções de erros.	6.4.2.0+	-	-	8	13 de julho de 2018
2.0.8	Essa foi uma versão de correção de bug.	6.4.0.0+	-	-	8	12 de junho de 2018
2.0.6	Essa versão foi adicionada com melhorias internas, correções de erros e pequenos aprimoramentos, incluindo suporte de inversão de imagem no componente de Imagem.	6.4.0.0+	-	-	8	11 de abril de 2018
2.0.4	Essa versão focou principalmente melhorias internas, correções de erros, além de alguns aprimoramentos secundários no componente de Imagem, componente de Página e componente de Fragmento de conteúdo.	6.4.0.0+	-	-	8	7 de março de 2018
2.0.0	Essa versão introduziu o componente de Navegação, componente de Navegação por idiomas e o componente de Pesquisa rápida, e implementou o Sistema de Estilos para todos os componentes.	6.4.0.0+	-	-	8	16 de janeiro de 2018
1.1.0	Essa versão implementa a exportação JSON em todos os componentes e introduz o componente de Fragmento de conteúdo.	6.4.0.0+	-	-	8	10 de outubro de 2017
1.0.6	Essa versão adiciona várias correções para o componente de Imagem.	6.4.0.0+	-	-	8	4 de agosto de 2017
1.0.4	Essa versão adiciona correções para o componente de Página, componente de Imagem e várias correções e melhorias gerais.	6.4.0.0+	-	-	8	26 de abril de 2017
1.0.2	Essa versão adiciona correções para imagens GIF animadas no componente de Imagem.	6.4.0.0+	-	-	7	22 de março de 2017
1.0.0	Versão inicial dos Componentes principais.	6.4.0.0+	-	-	7	20 de março de 2017

TIP

Assim como o AEM, a Adobe recomenda que os desenvolvedores usem a versão mais recente dos Componentes principais disponíveis, que sejam compatíveis com a versão do AEM que está sendo executada para que se beneficiem das correções e recursos mais atualizados.

Versões dos componentes

A tabela a seguir detalha que versões de quais componentes estão contidas em quais versões dos Componentes principais.

	Versão 1.0.0 - 1.0.6	Versão 1.1.0	Versão 2.0.0 - 2.0.8	Versão 2.1.0	Versão 2.2.0 - 2.2.0	Versão 2.3.0 - 2.3.2	Versão 2.4.0	Versão 2.5.0	Versão 2.6.0	Versão 2.7.0 - 2.8.0	Versão 2.9.0 - 2.17.14	Versão 2.18.0	Versão 2.19.0	Versão 2.20.0-2.21.2	Versão 2.22.0+
Página	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2, v3	v1, v2, v3	v1, v2, v3	v1, v2, v3
Título	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2, v3	v1, v2, v3	v1, v2, v3	v1, v2, v3
Imagem	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2, v3	v1, v2, v3	v1, v2, v3	v1, v2, v3
Lista	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2, v3	v1, v2, v3	v1, v2, v3	v1, v2, v3, v4
Navegação estrutural	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2, v3	v1, v2, v3	v1, v2, v3	v1, v2, v3
Compartilhamento em redes sociais	v1	v1	v1	v1	v1	v1	v1	v1	v1	v1	v1	v1, descontinuado	v1, descontinuado	v1, descontinuado	v1, descontinuado
Container de formulário	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2
Texto de formulário	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2
Opções de formulário	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2
Formulário oculto	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2
Botão de formulário	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2
Fragmento de conteúdo		Sandbox	v1	v1	v1	v1	v1	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2	v1, v2
Navegação			v1	v1	v1	v1	v1	v1	v1	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2
Navegação de idiomas			v1	v1	v1	v1	v1	v1	v1	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2
Pesquisa rápida			v1	v1	v1	v1	v1	v1	v1	v1	v1	v1	v1, v2	v1, v2	v1, v2
Teaser				v1	v1	v1	v1	v1	v1	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2
Guias					v1	v1	v1	v1	v1	v1	v1	v1	v1	v1	v1
Carrossel					v1	v1	v1	v1	v1	v1	v1	v1	v1	v1	v1
Separador						v1	v1	v1	v1	v1	v1	v1	v1	v1	v1
Lista de fragmentos de conteúdo							v1	v1	v1	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2
Acordeão								v1	v1	v1	v1	v1	v1	v1	v1
Botão								v1	v1	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2
Container								v1	v1	v1	v1	v1	v1	v1	v1
Download								v1	v1	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2
Fragmento de experiência									v1	v1	v1	v1, v2	v1, v2	v1, v2	v1, v2
Incorporação										v1	v1	v1, v2	v1, v2	v1, v2	v1, v2
Barra de progresso											v1	v1	v1	v1	v1
Visualizador de PDF											v1	v1	v1	v1	v1
Índice														v1	v1

Versões e lançamentos

Os Componentes principais são distribuídos pelo GitHub. Isso permite que a Adobe adicione funcionalidades aos componentes com mais rapidez e permita contribuições da comunidade fora do ciclo de lançamento do AEM.

Os Componentes principais são disponibilizados com versões AEM definidas com as quais são compatíveis. Isso significa que uma versão do AEM pode ser compatível com várias versões dos componentes principais.

Versões

A principal iteração dos Componentes principais são as versões. Cada componente tem uma versão. As versões são indicadas com v anexadas com um número inteiro positivo diferente de zero, como v1 e v2. As versões são aumentadas apenas para alterações que não são compatíveis com versões anteriores, o que normalmente ocorre para a introdução de novos recursos e funcionalidades.

Desenvolvedores e administradores podem reconhecer versões dos componentes principais por um número em seus caminhos de tipo de recurso e nos nomes de classe Java totalmente qualificados de suas implementações. Esse número de versão representa uma versão principal conforme definido pelas diretrizes de controle de versão semântico.

Para mais detalhes sobre as versões dos componentes principais, consulte a documentação do desenvolvedor dos Componentes principais.

Versões

Os Componentes principais são disponibilizados por meio de versões e representam os artefatos reais publicados e disponíveis no GitHub. As versões são indicadas com um número decimal do formato X.Y.Z e coletam todos os componentes principais juntos como um pacote de entrega.

Versões principais introduzem componentes totalmente novos, melhorias às versões existentes de componentes, bem como correções de erros padrão. Isso é representado por um incremento no componente X do número da versão.
Versões secundárias introduzem novos componentes, novas funcionalidades às versões existentes de componentes, bem como correções de erros. Isso é representado por um incremento no componente Y do número da versão.
As versões de correção contêm apenas correções de erros. Isso é representado por um incremento no componente Z do número da versão.

NOTE

As versões podem conter várias versões do mesmo componente.

A mesma versão de um componente pode aparecer em várias versões.

Versões dos componentes

Versões e lançamentos

Versões

Versões

Suporte para componentes principais

Suporte aos Componentes de base