Instalar artefatos de terceiros - não disponível no repositório Maven público

Os Componentes Principais do AEM WCM pacote foram adicionados como uma dependência no arquivo ​ ​ do pom.xmlprojeto WKND. Aqui, o escopo provided é usado, pois o conjunto de componentes principais WCM do AEM é fornecido pelo tempo de execução do AEM. Se o pacote não for fornecido pelo tempo de execução do AEM, você usaria o escopo compile e esse é o escopo padrão.

WKND Compartilhado pacote é adicionado como uma dependência no arquivo ​ ​ do pom.xmlprojeto WKND.

O pacote é fornecido por uma equipe interna ou fornecedor terceirizado e não está disponível no repositório Maven público.

O arquivo jar do Java™ não é um pacote OSGi e pode ou não estar disponível no repositório Maven público.

Você precisa de um recurso que ainda não foi lançado na versão mais recente do pacote de terceiros disponível no repositório Maven público. Você decidiu instalar a versão RELEASE ou SNAPSHOT criada localmente.

Instalação do ambiente de desenvolvimento local do AEM ou do Ambiente de Desenvolvimento Rápido(RDE).

O projeto WKND do AEM para adicionar o pacote ou jar ou o pacote de terceiros e verificar as alterações.

Configurar o ambiente de desenvolvimento local do AEM 6.X ou AEM as a Cloud Service (AEMCS) ou RDE.

Clonar e implantar o projeto WKND do AEM.

$ git clone git@github.com:adobe/aem-guides-wknd.git
$ cd aem-guides-wknd
$ mvn clean install -PautoInstallPackage

Verifique se as páginas do site WKND são renderizadas corretamente.

Baixe e extraia o arquivo my-example-bundle.zip.

No módulo all do projeto WKND do AEM, crie a estrutura de diretório all/src/main/content/jcr_root/apps/wknd-vendor-packages/container/install. O diretório /all/src/main/content existe, você só precisa criar os diretórios jcr_root/apps/wknd-vendor-packages/container/install.

Copie o arquivo my-example-bundle-1.0-SNAPSHOT.jar do diretório target extraído para o diretório all/src/main/content/jcr_root/apps/wknd-vendor-packages/container/install acima.

No módulo core do projeto WKND do AEM, crie o servlet Sling SayHello.java às core/src/main/java/com/adobe/aem/guides/wknd/core/servlet.

package com.adobe.aem.guides.wknd.core.servlet;

import java.io.IOException;

import javax.servlet.Servlet;
import javax.servlet.ServletException;

import org.apache.sling.api.SlingHttpServletRequest;
import org.apache.sling.api.SlingHttpServletResponse;
import org.apache.sling.api.servlets.HttpConstants;
import org.apache.sling.api.servlets.ServletResolverConstants;
import org.apache.sling.api.servlets.SlingSafeMethodsServlet;
import org.osgi.service.component.annotations.Component;
import org.osgi.service.component.annotations.Reference;
import com.example.services.HelloWorldService;

@Component(service = Servlet.class, property = {
    ServletResolverConstants.SLING_SERVLET_PATHS + "=/bin/sayhello",
    ServletResolverConstants.SLING_SERVLET_METHODS + "=" + HttpConstants.METHOD_GET
})
public class SayHello extends SlingSafeMethodsServlet {

        private static final long serialVersionUID = 1L;

        // Injecting the HelloWorldService from the `my-example-bundle` bundle
        @Reference
        private HelloWorldService helloWorldService;

        @Override
        protected void doGet(SlingHttpServletRequest request, SlingHttpServletResponse response) throws ServletException, IOException {
            // Invoking the HelloWorldService's `sayHello` method
            response.getWriter().write("My-Example-Bundle service says: " + helloWorldService.sayHello());
        }
}

No arquivo pom.xml raiz do projeto WKND do AEM, adicione o my-example-bundle como uma dependência.

...
<!-- My Example Bundle -->
<dependency>
    <groupId>com.example</groupId>
    <artifactId>my-example-bundle</artifactId>
    <version>1.0-SNAPSHOT</version>
    <scope>system</scope>
    <systemPath>${maven.multiModuleProjectDirectory}/all/src/main/content/jcr_root/apps/wknd-vendor-packages/container/install/my-example-bundle-1.0-SNAPSHOT.jar</systemPath>
</dependency>
...

Aqui:

• O escopo system indica que a dependência não deve ser pesquisada no repositório Maven público.
• O systemPath é o caminho para o arquivo my-example-bundle no módulo all do projeto WKND do AEM.
• O ${maven.multiModuleProjectDirectory} é uma propriedade Maven que aponta para o diretório raiz do projeto de vários módulos.

No arquivo core do módulo core/pom.xml do projeto WKND do AEM, adicione my-example-bundle como uma dependência.

...
<!-- My Example Bundle -->
<dependency>
    <groupId>com.example</groupId>
    <artifactId>my-example-bundle</artifactId>
</dependency>
...

Crie e implante o projeto WKND do AEM usando o seguinte comando:

$ mvn clean install -PautoInstallPackage

Verifique se o servlet SayHello funciona conforme esperado acessando a URL http://localhost:4502/bin/sayhello no navegador.

Confirme as alterações acima no repositório do projeto WKND do AEM. Em seguida, verifique as alterações no ambiente RDE ou AEM executando o pipeline do Cloud Manager.

Copie o pacote OSGi para o diretório all do módulo jcr_root/apps/<PROJECT-NAME>-vendor-packages/container/install. Essa etapa é necessária para empacotar e implantar o pacote na instância do AEM.

Atualize os arquivos pom.xml dos módulos raiz e principal para adicionar o pacote OSGi como uma dependência com o escopo system e systemPath apontando para o arquivo de pacote. Essa etapa é necessária para compilar o projeto.

Baixe e extraia o arquivo my-example-jar.zip.

No módulo all do projeto WKND do AEM, crie a estrutura de diretório all/resource/jar.

Copie o arquivo my-example-jar-1.0-SNAPSHOT.jar do diretório target extraído para o diretório all/resource/jar acima.

No módulo core do projeto WKND do AEM, crie o servlet Sling SayHello.java às core/src/main/java/com/adobe/aem/guides/wknd/core/servlet.

package com.adobe.aem.guides.wknd.core.servlet;

import java.io.IOException;

import javax.servlet.Servlet;
import javax.servlet.ServletException;

import org.apache.sling.api.SlingHttpServletRequest;
import org.apache.sling.api.SlingHttpServletResponse;
import org.apache.sling.api.servlets.HttpConstants;
import org.apache.sling.api.servlets.ServletResolverConstants;
import org.apache.sling.api.servlets.SlingSafeMethodsServlet;
import org.osgi.service.component.annotations.Component;

import com.my.example.MyHelloWorldService;

@Component(service = Servlet.class, property = {
        ServletResolverConstants.SLING_SERVLET_PATHS + "=/bin/sayhello",
        ServletResolverConstants.SLING_SERVLET_METHODS + "=" + HttpConstants.METHOD_GET
})
public class SayHello extends SlingSafeMethodsServlet {

    private static final long serialVersionUID = 1L;

    @Override
    protected void doGet(SlingHttpServletRequest request, SlingHttpServletResponse response)
            throws ServletException, IOException {

        // Creating an instance of MyHelloWorldService
        MyHelloWorldService myHelloWorldService = new MyHelloWorldService();

        // Invoking the MyHelloWorldService's `sayHello` method
        response.getWriter().write("My-Example-JAR service says: " + myHelloWorldService.sayHello());
    }
}

No arquivo pom.xml raiz do projeto WKND do AEM, adicione o my-example-jar como uma dependência.

...
<!-- My Example JAR -->
<dependency>
    <groupId>com.my.example</groupId>
    <artifactId>my-example-jar</artifactId>
    <version>1.0-SNAPSHOT</version>
    <scope>system</scope>
    <systemPath>${maven.multiModuleProjectDirectory}/all/resource/jar/my-example-jar-1.0-SNAPSHOT.jar</systemPath>
</dependency>
...

Aqui:

• O escopo system indica que a dependência não deve ser pesquisada no repositório Maven público.
• O systemPath é o caminho para o arquivo my-example-jar no módulo all do projeto WKND do AEM.
• O ${maven.multiModuleProjectDirectory} é uma propriedade Maven que aponta para o diretório raiz do projeto de vários módulos.

No arquivo core do módulo core/pom.xml do projeto WKND do AEM, faça duas alterações:

• Adicione o my-example-jar como uma dependência.

  code language-xml
  ... <!-- My Example JAR --> <dependency> <groupId>com.my.example</groupId> <artifactId>my-example-jar</artifactId> </dependency> ...

• Atualize a configuração bnd-maven-plugin para incluir my-example-jar no pacote OSGi (aem-guides-wknd.core) que está sendo compilado.

  code language-xml

  ... <plugin> <groupId>biz.aQute.bnd</groupId> <artifactId>bnd-maven-plugin</artifactId> <executions> <execution> <id>bnd-process</id> <goals> <goal>bnd-process</goal> </goals> <configuration> <bnd><![CDATA[ Import-Package: javax.annotation;version=0.0.0,* <!-- Include the 3rd party jar as inline resource--> -includeresource: \ lib/my-example-jar.jar=my-example-jar-1.0-SNAPSHOT.jar;lib:=true ]]></bnd> </configuration> </execution> </executions> </plugin> ...

Crie e implante o projeto WKND do AEM usando o seguinte comando:

$ mvn clean install -PautoInstallPackage

Verifique se o servlet SayHello funciona conforme esperado acessando a URL http://localhost:4502/bin/sayhello no navegador.

Confirme as alterações acima no repositório do projeto WKND do AEM. Em seguida, verifique as alterações no ambiente RDE ou AEM executando o pipeline do Cloud Manager.

Copie o jar do Java para o diretório all do módulo resource/jar.

Atualize os arquivos pom.xml da raiz e do módulo principal para adicionar o jar Java como uma dependência com o escopo system e systemPath apontando para o arquivo jar.

Comente ou remova a dependência da versão ACS AEM Commons do arquivo POM. Consulte o Adicionar ACS AEM Commons ao seu projeto AEM Maven para identificar a dependência.

Clonar a ramificação master do repositório do ACS AEM Commons no computador local.

Crie a versão ACS AEM Commons SNAPSHOT usando o seguinte comando:

$mvn clean install

O pacote criado localmente está localizado em all/target, há dois arquivos .zip, um que termina com -cloud é destinado ao AEM as a Cloud Service e o outro é para o AEM 6.X.

No módulo all do projeto WKND do AEM, crie a estrutura de diretório all/src/main/content/jcr_root/apps/wknd-vendor-packages/container/install. O diretório /all/src/main/content existe, você só precisa criar os diretórios jcr_root/apps/wknd-vendor-packages/container/install.

Copie o arquivo de pacote (.zip) criado localmente no diretório /all/src/main/content/jcr_root/apps/mysite-vendor-packages/container/install.

Crie e implante o projeto WKND do AEM usando o seguinte comando:

$ mvn clean install -PautoInstallPackage

Verifique o pacote ACS AEM Commons instalado:

• Gerenciador de Pacotes do CRX @ http://localhost:4502/crx/packmgr/index.jsp

  

• O console OSGi @ http://localhost:4502/system/console/bundles

  

Confirme as alterações acima no repositório do projeto WKND do AEM. Em seguida, verifique as alterações no ambiente RDE ou AEM executando o pipeline do Cloud Manager.