Show Menu
TÓPICOS×

Desenvolver com o CRXDE Lite

Esta seção descreve como desenvolver seu aplicativo AEM usando o CRXDE Lite.
Consulte a documentação de visão geral para obter mais informações sobre os diferentes ambientes de desenvolvimento disponíveis.
O CRXDE Lite está incorporado ao AEM e permite que você execute tarefas de desenvolvimento padrão no navegador. Com o CRXDE Lite, você pode criar um projeto, criar e editar arquivos (como .jsp e .java), pastas, modelos, componentes, caixas de diálogo, nós, propriedades e pacotes enquanto faz logon e integração com o SVN. O CRXDE Lite é recomendado quando você não tem acesso direto ao servidor AEM, quando desenvolve um aplicativo, estendendo ou modificando os componentes predefinidos e os pacotes Java ou quando não precisa de um depurador dedicado, finalização de código e realce de sintaxe.
Por padrão, todos os usuários do AEM podem acessar o CRXDE Lite. Se desejar, configure ACLs para o seguinte nó, de modo que somente os desenvolvedores possam acessar o CRX DE Lite:
/libs/granite/crxde
É recomendável usar as Ferramentas do desenvolvedor do AEM para o Eclipse e a Extensão dos suportes HTL do AEM durante o desenvolvimento do projeto.

Introdução ao CRXDE Lite

Para começar a usar o CRXDE Lite, proceda da seguinte forma:
  1. Instale o AEM.
  2. Em seu navegador, digite https://<host>:<port>/crx/de . Por padrão é https://localhost:4502/crx/de .
  3. Digite seu nome de usuário e senha . Por padrão é admin e admin .
  4. Clique em OK .
A interface do usuário CRXDE Lite é exibida da seguinte forma em seu navegador:
Agora você pode usar o CRXDE Lite para desenvolver seu aplicativo.

Visão geral da interface do usuário

O CRXDE Lite oferta a seguinte funcionalidade:
Barra do comutador superior Permite alternar rapidamente entre o CRXDE Lite, o Package Manager e o Package Share.
Widget de caminho de nó
Exibe o caminho para o nó selecionado no momento.
Você também pode usá-lo para pular para um nó, inserindo o caminho manualmente ou colando-o de outro lugar e pressionando Enter.
Também oferece suporte para procurar nós com nome de nó específico. Digite o nome do nó que você deseja localizar e aguarde (ou pressione o símbolo de pesquisa no lado direito). Você pode tentar inserir, por exemplo, o carvalho de corda no widget para ver como ele funciona. Se um determinado nó ou nós forem carregados no painel explorador, a lista será exibida e você poderá selecionar o caminho e pressionar Enter para navegar até ele. Observe que ele só funciona para os nós carregados no momento no aplicativo cliente CRXDE no navegador. Se quiser pesquisar o repositório inteiro, use Ferramentas e, em seguida, Query.
Painel do Explorer
Exibe uma árvore de todos os nós no repositório.
Clique em um nó para exibir suas propriedades na guia Propriedades . Depois de clicar em um nó, você pode selecionar uma ação na barra de ferramentas. Clique no nó novamente para renomeá-lo.
Filtro de navegação da árvore (ícone binocular): permite que você filtre os nós no repositório para os quais o nome contém o texto de entrada. Ela se aplica somente aos nós que foram carregados localmente.
Painel Editar
Guia Início : permite pesquisar conteúdo e/ou documentação e acessar recursos do desenvolvedor (documentação, blog do desenvolvedor, base de conhecimento) e suporte (página inicial e centro de suporte da Adobe).
Duplo clique em um arquivo no painel do Explorer para exibir seu conteúdo; como, por exemplo, um arquivo .jsp ou .java. Em seguida, você pode modificá-la e salvar as alterações.
Depois que um arquivo é editado no painel Editar , as seguintes ferramentas ficam disponíveis na barra de ferramentas:
- Mostrar na árvore: mostra o arquivo na árvore do repositório. - Pesquisar/Substituir ... : faça pesquisa ou substitua. O clique com o Duplo na linha de status do painel Editar abre a caixa de diálogo Ir para linha para que você possa digitar um número de linha específico para acessar.
Guia Propriedades Exibe as propriedades do nó selecionado. É possível adicionar novas propriedades ou excluir as existentes.
guia Controle de acesso
Exibir permissões com base no caminho atual, no nível do repositório ou no principal.
As permissões são divididas em
- Política de Controles de acesso aplicável: As políticas que podem ser aplicadas à seleção atual.
- Políticas de Controle de acesso local: As políticas atuais aplicadas localmente à seleção atual.
- Políticas eficazes em matéria de Controles de acesso: As políticas atuais aplicadas à seleção atual podem ser definidas localmente ou herdadas dos nós pais.
Nota. Para poder ver as informações do Controle de acesso, o usuário conectado ao CRXDE Lite deve ter direitos de leitura das entradas ACL. O usuário anônimo não pode ver essas informações por padrão - faça logon como, por exemplo, administrador para ver as informações.
Guia Replicação
Exibir o status de replicação do nó atual. É possível replicar e excluir o nó atual.
Guia Console
Logs do servidor :
Exibe mensagens de registro. Você pode configurar o nível de log, limpar o console, fixar na posição de rolagem selecionada e ativar/desativar a exibição de mensagens.
Controle da versão :
Exibe mensagens de controle de versão.
Guia Informações da criação Exibe informações quando um pacote está sendo criado.
Atualizar Atualiza a seleção atual. As alterações de outros usuários são atualizadas na visualização do repositório. As alterações efetuadas não são afetadas.
Salvar Tudo
Salvar Tudo :
Salva todas as alterações feitas. Até que você clique em salvar, as alterações serão temporárias e serão perdidas quando você sair do console.
Reverter :
Descarta todas as alterações feitas no nó selecionado desde a última ação de salvamento e, em seguida, recarrega o estado atual do repositório para o nó selecionado.
Reverter tudo :
Descarta todas as alterações feitas em todo o repositório desde a última ação de salvar e, em seguida, carrega o estado atual do repositório.
Criar ...
Menu suspenso para criar o seguinte sob o nó selecionado:
- : um nó com um tipo de nó arbitrário
- Arquivo : nt:nó de arquivo e seu subnó nt:resource
- Pasta : nt:nó de pasta
- Modelo : Modelo AEM
- Componente : Componente AEM
- Diálogo : Caixa de diálogo AEM
Exclua Exclui o nó selecionado.
Copiar Copia o nó selecionado.
Colar Cola o nó copiado abaixo do nó selecionado.
Mover ... Move o nó selecionado para o nó definido pela caixa de diálogo.
Renomeie ... Renomeia o nó selecionado.
Misturas ... Permite adicionar tipos de mixagem ao tipo de nó. Os tipos de mixin são usados para adicionar recursos avançados, como controle de versão, controle de acesso, referência e bloqueio ao nó.
Equipe
Menu suspenso para executar tarefas de controle de versão padrão:
- Atualizar repositório do servidor SVN
- Confirmar alterações locais no servidor SVN
- Status da Visualização do nó atual
- Status Recursivo da Visualização da subárvore do nó atual
- Fazer check-out de uma cópia funcionando do servidor SVN
- Exportar um projeto do servidor SVN (sem criar uma cópia funcional)
- Importar um projeto do repositório para o servidor SVN
Observe que você precisa estar conectado como usuário com permissões suficientes para poder executar algumas das tarefas (especialmente aquelas que gravam no repositório local).
Ferramentas
Menu suspenso com as seguintes ferramentas:
- Configuração do servidor ... : para acessar o Console do Felix.
- Query ... : para query do repositório.
- Privilégios ... : para abrir o gerenciamento de privilégios, onde você pode visualização e adicionar privilégios.
- Controle de acesso de ensaio ... : um local onde você pode testar a permissão para determinado caminho e/ou principal.
- Tipo de nó de exportação: para exportar os tipos de nó no sistema como notação cnd.
- Tipo de nó de importação ... : para importar tipos de nó usando a notação cnd.
- Instalar o SiteCatalyst Debugger ... : instruções sobre como instalar o Analytics Debugger.
Widget de logon
Exibe os usuários conectados no momento e o espaço de trabalho em que eles estão conectados, por exemplo, admin@crx.default.
Clique nele para fazer logon ou login novamente como um usuário específico. Se você não especificar um espaço de trabalho para fazer logon, você estará conectado ao espaço de trabalho padrão, crx.default.
Se você quiser navegar no repositório como usuário Anônimo, use anônimo como nome de logon e qualquer senha (por exemplo, um espaço ou um ponto).
Se sua autorização não for mais válida (por exemplo, ela expirou), o widget de logon exibirá " Não autorizado - Logon... ". Clique nele para fazer logon novamente.

Criação de um projeto

Com o CRXDE Lite, você pode criar um projeto em funcionamento com três cliques. O assistente de projeto cria um novo projeto em /apps , algum conteúdo sob /conten ele e um pacote que envolve todo o projeto no qual o conteúdo está /etc/packages . O projeto pode ser usado imediatamente para renderizar uma página de amostra exibindo Hello World , com base em um script jsp que renderiza uma propriedade do repositório e chama uma classe Java para renderizar algum texto.
Para criar um projeto com o CRXDE Lite:
  1. Abra o CRXDE Lite no seu navegador da
  2. No painel de Navegação, clique com o botão direito do mouse em um nó, selecione Criar ... , em seguida, Criar projeto ... . Observação: você pode clicar com o botão direito do mouse em qualquer nó na navegação em árvore, como os novos nós do projeto são, por padrão, criados abaixo /apps, e /content /etc/packages .
  3. Definir:
    • Nome do projeto - o nome do projeto é usado para criar os novos nós e o pacote, por exemplo, myproject .
    • Pacote Java - o prefixo do nome do pacote Java, por exemplo, com.mycompany .
  4. Clique em Criar .
  5. Clique em Salvar tudo para salvar as alterações no servidor.
Para acessar a página de amostra exibindo Hello World , aponte o navegador para:
https://localhost:4502/content/<project-name>.html
A página Hello World é baseada em um nó de conteúdo, que chama um script jsp pela sling:resourceType propriedade. O script lê a jcr:title propriedade do repositório e obtém o conteúdo do corpo chamando um método da classe SampleUtil, que está disponível no conjunto de projetos.
Os seguintes nós são criados:
  • /apps/<project-name> : o container do aplicativo.
  • /apps/<project-name>/components : o container components, que contém o arquivo html.jsp de amostra, usado para renderizar uma página.
  • /apps/<project-name>/src : o container bundles, que contém um pacote de projeto de amostra.
  • /apps/<project-name>/install : o container de pacotes compilados, que contém o conjunto de projetos de amostra compilado.
  • /content/<project-name> : o container de conteúdo.
  • /etc/packages/<java-suffix>/<project-name>.zip, um pacote que envolve todo o aplicativo e o conteúdo do projeto. Você pode usá-lo para recriar o projeto para implantação adicional (por exemplo, para outros ambientes) ou para compartilhamento por meio do Compartilhamento de pacotes.
A estrutura tem a seguinte aparência no CRXDE Lite com um projeto chamado myproject e um sufixo de pacote java chamado mycompany :

Creating a Folder

Para criar uma pasta com o CRXDE Lite:
  1. Abra o CRXDE Lite no seu navegador da
  2. No painel Navegação, clique com o botão direito do mouse na pasta sob a qual deseja criar a nova pasta, selecione Criar ... e, em seguida, Criar pasta ... .
  3. Digite o Nome da pasta e clique em OK .
  4. Clique em Salvar tudo para salvar as alterações no servidor.

Creating a Template

Para criar um modelo com o CRXDE Lite:
  1. Abra o CRXDE Lite no seu navegador da
  2. No painel de Navegação, clique com o botão direito do mouse na pasta em que deseja criar o modelo, selecione Criar ... , em seguida, Criar modelo ... .
  3. Informe o Rótulo , Título , Descrição , Tipo de Recurso e Classificação do modelo. Clique em Avançar .
  4. Esta etapa é opcional: defina os Caminhos permitidos . Clique em Avançar
  5. Esta etapa é opcional: defina os pais permitidos . Clique em Avançar .
  6. Esta etapa é opcional: defina os filhos permitidos . Clique em OK .
  7. Clique em Salvar tudo para salvar as alterações no servidor.
Cria:
  • Um nó do tipo cq:Template com propriedades de Modelo
  • Um nó filho do tipo cq:PageContent com propriedades de Conteúdo da página
É possível adicionar propriedades ao modelo: consulte a seção Criação de uma propriedade .

Criação de um componente

O recurso descrito aqui só estará disponível se o CQ5 estiver instalado, isto é, se o tipo de nó cq:Component estiver disponível no repositório.
Para criar um componente com CRXDE Lite:
  1. Abra o CRXDE Lite no seu navegador da
  2. No painel de Navegação, clique com o botão direito do mouse na pasta em que deseja criar o componente, selecione Criar ... e, em seguida, Criar componente ... .
  3. Informe o Rótulo , o Título , a Descrição , o Tipo de Super Recurso e o Grupo do componente. Clique em Avançar .
  4. Esta etapa é opcional: defina as propriedades do componente Is Container, No Decoration , Cell Name e Dialog Path . Clique em Avançar .
  5. Esta etapa é opcional: defina a propriedade do componente Permitidos pais . Clique em Avançar .
  6. Esta etapa é opcional: defina a propriedade do componente Filhos permitidos. Clique em OK .
  7. Clique em Salvar tudo para salvar as alterações no servidor.
Cria:
  • Um nó do tipo cq:Component
  • Propriedades do componente
  • Um script .jsp componente

Criando uma caixa de diálogo

Para criar uma caixa de diálogo com o CRXDE Lite:
  1. Abra o CRXDE Lite no seu navegador da
  2. No painel Navegação, clique com o botão direito do mouse no componente no qual deseja criar a caixa de diálogo, selecione Criar ... e, em seguida, Criar caixa de diálogo ... .
  3. Insira o Rótulo e o Título . Clique em OK .
  4. Clique em Salvar tudo para salvar as alterações no servidor.
Cria um diálogo com a seguinte estrutura:
dialog[cq:Dialog]/items[cq:Widget]/items[cq:WidgetCollection]/tab1[cq:Panel]
Agora você pode adaptar a caixa de diálogo às suas necessidades modificando as propriedades ou criando novos nós.
Você também pode usar o Editor de diálogo para editar uma caixa de diálogo. O Duplo que clicar no nó de diálogo no CRXDE Lite exibirá o editor. Mais informações sobre o Editor de diálogo podem ser encontradas aqui .

Criação de um nó

Para criar um nó com CRXDE Lite:
  1. Abra o CRXDE Lite no seu navegador da
  2. No painel de Navegação, clique com o botão direito do mouse no nó em que deseja criar o novo nó, selecione Criar ... e, em seguida, Criar nó ... .
  3. Insira o Nome e o Tipo . Clique em OK .
  4. Clique em Salvar tudo para salvar as alterações no servidor.
Agora você pode adaptar o nó às suas necessidades modificando as propriedades ou criando novos nós.
A maioria das operações de edição, incluindo Criar nó, mantém todas as alterações na memória e só as armazena no repositório ao salvar (por meio do botão "Salvar tudo"). No entanto, algumas operações, como mover, são automaticamente persistentes.
A validação para determinar se o nó recém-criado é permitido pelo tipo de nó do nó pai também é realizada pelo repositório JCR primeiro ao salvar alterações. Se você receber uma mensagem de erro ao salvar um nó, verifique se a estrutura de conteúdo é válida (por exemplo, não é possível criar um nt:unstructured nó como filho de nt:folder nó).

Criação de uma propriedade

Para criar uma propriedade com CRXDE Lite:
  1. Abra o CRXDE Lite no seu navegador da
  2. No painel Navegação, selecione o nó no qual deseja adicionar a nova propriedade.
  3. Na guia Propriedades , no painel inferior, digite o Nome , o Tipo e o Valor . Clique em Adicionar .
  4. Clique em Salvar tudo para salvar as alterações no servidor.

Criação de um script

Para criar um novo script:
  1. Abra o CRXDE Lite no seu navegador da
  2. No painel de Navegação, clique com o botão direito do mouse no componente no qual deseja criar o script, selecione Criar ... , em seguida, Criar arquivo ... .
  3. Insira o Nome do arquivo, incluindo sua extensão. Clique em OK .
  4. O novo arquivo é aberto como uma guia no painel Editar.
  5. Edite o arquivo.
  6. Click Save All to save the changes.

Gerenciar um pacote

Com o CRXDE Lite, é fácil criar um pacote OSGI, adicionar classes Java e criá-lo. O pacote é então instalado automaticamente e iniciado no container OSGI.
Esta seção descreve como criar um Test pacote com uma classe HelloWorld Java que exibe Hello World! no seu navegador quando o recurso for solicitado.

Criação de um pacote

Para criar o conjunto de testes com o CRXDE Lite:
  1. No CRXDE Lite, crie um myapp projeto com o assistente de projeto. Entre outros, os seguintes nós são criados:
    • /apps/myapp/src
    • /apps/myapp/install
  2. Clique com o botão direito do mouse na pasta /apps/myapp/src que conterá o Test pacote, selecione Criar ... e, em seguida, Criar pacote ... .
  3. Defina as propriedades do pacote da seguinte maneira:
    • Nome do pacote simbólico: com.mycompany.test.TestBundle
    • Nome do pacote: Test Bundle
    • Descrição do pacote:
      This is my Test Bundle
      
      
    • Pacote:
      com.mycompany.test
      
      
    Clique em OK .
  4. Clique em Salvar tudo para salvar as alterações no servidor.
O assistente cria os seguintes elementos:
  • O nó com.mycompany.test.TestBundle do tipo nt:folder. É o nó do container de conjunto.
  • O arquivo com.mycompany.test.TestBundle.bnd . Ele atua como descritor de deployment para seu pacote e consiste em um conjunto de cabeçalhos.
  • As estruturas de pastas:
    • src/main/java/com/mycompany/test . Ele conterá os pacotes e as classes Java.
    • src/main/resources . Ele conterá os recursos usados dentro do pacote.
  • O Activator.java arquivo. É a classe de ouvinte opcional que deve ser notificada dos eventos de start e parada.
A tabela a seguir lista todas as propriedades do arquivo .bnd, seus valores e descrições:
Propriedade Valor (na criação do pacote) Descrição
Pacote de exportação:
*
Observação: este valor deve ser adaptado para refletir a especificidade do pacote.
O cabeçalho Export-Package define os pacotes exportados do pacote (lista de pacotes separada por vírgulas). Os pacotes exportados constituem a visualização pública do pacote.
Pacote de importação:
*
Observação: este valor deve ser adaptado para refletir a especificidade do pacote.
O cabeçalho Import-Package define os pacotes importados para o pacote (lista de pacotes separada por vírgulas)
Pacote privado:
*
Observação: este valor deve ser adaptado para refletir a especificidade do pacote.
O cabeçalho Private-Package define pacotes privados para o pacote (lista de pacotes separada por vírgulas). Os pacotes privados constituem a execução interna.
Nome do pacote: Testar conjunto Define um nome curto e legível para o grupo
Descrição do pacote: Este é o meu pacote de testes Define uma descrição curta e legível para o grupo
Bundle-SymbaticName: com.mycompany.test.TestBundle Especifica um nome exclusivo e não localizável para o conjunto
Versão do pacote: 1.0.0-SNAPSHOT Especifica a versão do pacote
Bundle-Ativator: com.mycompany.test.Activator Especifica o nome da classe listener opcional a ser notificado sobre o start de conjunto e eventos stop
Para obter mais informações sobre o formato de lance, consulte o utilitário de lance usado pelo CRXDE para criar pacotes OSGI.

Criação de uma classe Java

Para criar a classe HelloWorld Java no conjunto de testes:
  1. Abra o CRXDE Lite no seu navegador da
  2. No painel Navegação, clique com o botão direito do mouse no nó que contém o Activator.java arquivo ( /apps/myapp/src/com.mycompany.test.TestBundle/src/main/java ), selecione Criar ... e, em seguida, Criar arquivo ... .
  3. Nomeie o arquivo HelloWorld.java . Clique em OK .
  4. O HelloWorld.java arquivo é aberto no painel Editar.
  5. Adicione as seguintes linhas em HelloWorld.java :
      package com.mycompany.test;
    
      public class HelloWorld {
      public String getString(){
      return "Hello World!";
      }
      }
    
    
  6. Clique em Salvar tudo para salvar as alterações no servidor.

Construção de um pacote

Para criar o conjunto de testes:
  1. Abra o CRXDE Lite no seu navegador da
  2. No painel Navegação, clique com o botão direito do mouse no arquivo .bnd, selecione Ferramentas e, em seguida , Pacote .
O assistente de compilação de pacote:
  • Compila as classes Java.
  • Cria o arquivo .jar contendo as classes Java compiladas e os recursos e o coloca na myapp/install pasta.
  • Instala e start o pacote no container OSGI.
Para ver o efeito do conjunto de testes, crie um componente que use o método Java HelloWorld.getString() e um recurso que é renderizado por esse componente:
  1. Crie o componente mycomp em myapp/components .
  2. Edite mycomp.jsp e substitua o código pelas seguintes linhas:
      <%@ page import="com.mycompany.test.HelloWorld"%><%
      %><%@ include file="/libs/foundation/global.jsp"%><%
      %><% HelloWorld hello = new HelloWorld();%><%
      %>
      <html>
      <body>
      <b><%= hello.getString() %></b><br>
      </body>
      </html>
    
    
  3. Crie o recurso test_node do tipo nt:unstructured em /content .
  4. Para test_node , crie a seguinte propriedade: Nome = sling:resourceType , Tipo = String , Valor = myapp/components/mycomp .
  5. Clique em Salvar tudo para salvar as alterações no servidor.
  6. Em seu navegador, solicite test_node : https://<hostname>:<port>/content/test_node.html .
  7. Uma página é exibida com o Hello World! message.

Exportação e importação de tipos de nó

Com o CRXDE Lite, é possível importar e/ou exportar definições de tipo de nó na notação node-type-notation.htmlCND (Namespace compacta e Definição de tipo de nó).
Para exportar uma definição de tipo de nó:
  1. Abra o CRXDE Lite no seu navegador da
  2. Selecione o nó desejado.
  3. Selecione Ferramentas e, em seguida, Exportar tipo de nó.
  4. A definição, em notação cnd, será exibida no seu navegador. Salve as informações, se necessário.
Para importar uma definição de tipo de nó:
  1. Abra o CRXDE Lite no seu navegador da
  2. Selecione Ferramentas e, em seguida, Importar Tipo de Nó... .
  3. Insira a notação CND para a definição na caixa de texto.
  4. Marque Permitir atualização se estiver atualizando uma definição existente.
  5. Clique em Importar .

Registro

Com o CRXDE Lite, é possível exibir o arquivo error.log localizado no sistema de arquivos em <crx-install-dir>/crx-quickstart/server/logs e filtrá-lo com o nível de log apropriado. Proceda do seguinte modo:
  1. Abra o CRXDE Lite no seu navegador da
  2. Na guia Console , na parte inferior da janela, no menu suspenso à direita, selecione Server Logs (Logs de servidor).
  3. Clique no ícone Parar para exibir as mensagens.
É possível:
  • Ajuste os parâmetros de log no Console do Felix clicando no ícone Configurações de log.
  • Limpe as mensagens clicando no ícone Pincel .
  • Fixar a mensagem na seleção atual clicando no ícone Fixar .
  • Ative ou desative a exibição de mensagens clicando no ícone Parar .

Controle de acesso

Consulte Usuários, grupos e administração de direitos de acesso para obter mais informações.