Desenvolvimento dos Componentes principais developing-core-components
Quando usar os Componentes principais? when-to-use-the-core-components
Como os Componentes principais são totalmente novos e oferecem vários benefícios, é recomendável que os novos projetos AEM os usem. No caso dos projetos existentes, a migração deve fazer parte de um maior esforço de projeto, por exemplo, uma reformulação da marca ou uma reformulação global.
Portanto, a Adobe recomenda o seguinte:
- Novos projetos
Os novos projetos devem sempre tentar usar os Componentes principais. Se os Componentes principais não puderem ser usados diretamente ou estendidos para atender aos requisitos do projeto, crie um componente personalizado seguindo a arquitetura de componentes definida nos Componentes principais. Exceto quando não for possível, evite usar os componentes de base. - Projetos existentes
Recomenda-se continuar usando os componentes de base, a menos que haja planos de reestruturação do site ou de componentes.
Como são muito usados pela maioria dos projetos existentes, os componentes de base continuarão sendo compatíveis. - Novos componentes personalizados
Avalie se um Componente principal existente pode ser personalizado.
Caso contrário, a recomendação é criar um novo componente personalizado seguindo as Diretrizes de componentes. - Componentes personalizados existentes
Se os componentes funcionarem conforme o esperado, mantenha-os como estão.
Caso contrário, consulte "Novos componentes personalizados" acima.
Como obter resultados com os Componentes principais how-to-succeed
Os Componentes principais são avançados, flexíveis e simples de usar e personalizar. Seguir algumas diretrizes principais garantirá que seu projeto com os Componentes principais seja bem-sucedido.
Migração para os Componentes principais
Recomenda-se que qualquer novo projeto seja implementado com os Componentes principais. No entanto, os projetos existentes normalmente terão implementações abrangentes dos Componentes de Base.
Migração de Componentes de base from-foundation
Um esforço maior em um projeto existente (por exemplo, uma reformulação da marca ou reestruturação geral) geralmente oferece uma chance de migrar para os Componentes principais. Para facilitar essa migração, a Adobe disponibilizou uma série de ferramentas de migração para incentivar a adoção dos Componentes principais e a tecnologia mais recente do AEM.
As Ferramentas de modernização do AEM permitem a fácil conversão de:
- Modelos estáticos em modelos editáveis
- Configurações de design em políticas
- Componentes de base para Componentes principais
- IU Clássica em IU ativada por toque
Para mais informações sobre o uso dessas ferramentas, consulte a documentação.
Migração por meio da transição para o AEM as a Cloud Service via-aemaacs
O AEM as a Cloud Service vem automaticamente com a versão mais recente dos Componentes principais. Por isso, ao mudar de uma instalação local do AEM, será necessário remover qualquer dependência dos Componentes principais no arquivo de projetos pom.xml
.
Os componentes proxy ainda funcionarão como antes, uma vez que os proxies apontam para o supertipo necessário, e o caminho do supertipo tem a versão nele. Dessa forma, basta remover a dependência para que os Componentes principais funcionem no AEMaaCS, como funcionavam localmente.no local.
Assim como qualquer outro projeto do AEMaaCS, também será preciso adicionar uma dependência ao jar do SDK do AEM. Isso não é específico dos Componentes principais, mas é obrigatório.
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-sdk-api</artifactId>
</dependency>
Consulte o documento Estrutura de projeto AEM para mais informações sobre projetos AEMaaCS.
Suporte aos Componentes principais core-component-support
Por serem uma parte integrante do AEM, os Componentes principais são suportados nos mesmos termos e condições, como se fossem fornecidos como parte do Início rápido.
Assim como outros recursos de produtos AEM, a regra geral é: primeiro, é anunciado que os Componentes se tornarão obsoletos, e os mais antigos são removidos da versão seguinte do AEM. Isso dá aos clientes pelo menos um ciclo de lançamento para migrar para a nova versão do componente, antes que ele não tenha mais suporte.
A versão de cada componente indica claramente as versões do AEM suportadas. Quando o suporte para uma versão do AEM é interrompido, o mesmo acontece com o suporte dos Componentes principais para essa versão do AEM.
Para obter detalhes sobre o suporte às personalizações de componentes, consulte a página Personalização de Componentes principais.
Recursos técnicos technical-capabilities
A tabela a seguir fornece uma visão geral das diferenças entre os Componentes principais e os Componentes de base.
Para obter detalhes sobre recursos de criação dos Componentes principais e opções de pré-configuração, consulte a página de criação sobre esses componentes.
Lista de componentes component-list
A tabela a seguir lista os Componentes principais disponíveis, vinculando à API desses componentes, e indica quais componentes de base eles substituem.
/libs/foundation/components/page /libs/wcm/foundation/components/page
/libs/foundation/components/text /libs/foundation/components/table /libs/wcm/foundation/components/text
/libs/foundation/components/image /libs/foundation/components/adaptiveimage /libs/foundation/components/logo /libs/foundation/components/mobileimage /libs/foundation/components/mobilelogo /libs/wcm/foundation/components/image
/libs/foundation/components/list /libs/foundation/components/mobilelist /libs/wcm/foundation/components/list
/libs/foundation/components/form/start /libs/foundation/components/form/end
/libs/foundation/components/form/text /libs/foundation/components/form/password
/libs/foundation/components/form/checkbox /libs/foundation/components/form/radio /libs/foundation/components/form/dropdown
/libs/foundation/components/topnav /libs/foundation/components/mobiletopnav
/libs/foundation/components/search
-
/libs/foundation/components/carousel
/libs/cq/experience-fragments/editor/components/experiencefragment
Atualização dos Componentes principais upgrade-of-core-components
Um benefício dos componentes com versão é permitir separar a migração para uma nova versão do AEM, da migração para novas versões de componentes. Além disso, se as novas versões de componentes estiverem disponíveis, é possível fazer a migração individual de cada componente para a nova versão.
As migrações para uma nova versão do AEM não afetarão o funcionamento dos Componentes principais, desde que suas versões também sejam compatíveis com a nova versão do AEM para a qual está sendo migrada. As personalizações feitas nos Componentes principais também não devem ser afetadas, desde que elas não usem APIs que tenham se tornado obsoletas ou sido removidas.
As migrações para novas versões dos Componentes principais também não afetam o funcionamento do componente. Porém, novos recursos podem ser introduzidos aos autores da página, o que pode exigir alguma configuração por um editor de modelo, caso o comportamento padrão não seja o desejado. As personalizações, no entanto, podem precisar de adaptação. Para mais detalhes, consulte a página Personalização dos Componentes principais.