Aplicación de Android
AEM sin encabezado as a Cloud Service
Las aplicaciones de ejemplo son una buena manera de explorar las capacidades sin encabezado de Adobe Experience Manager AEM (). Esta aplicación para Android muestra cómo realizar consultas en el contenido mediante las API de GraphQL AEM de la. AEM Cliente sin encabezado para JavaScriptse usa para ejecutar las consultas de GraphQL y asignar datos a objetos Java para poder activar la aplicación.
Ver el código fuente en GitHub
Requisitos previos
Las siguientes herramientas deben instalarse localmente:
AEM requisitos de
La aplicación de Android AEM funciona con las siguientes opciones de implementación de. Todas las implementaciones requieren que esté instalado WKND Site v3.0.0+.
La aplicación de Android AEM está diseñada para conectarse a un entorno Publish AEM, pero puede obtener contenido de la fuente de Autor de la aplicación o si se proporciona autenticación en la configuración de la aplicación de Android.
Cómo usar
-
Clonar el repositorio
adobe/aem-guides-wknd-graphql:$ git clone git@github.com:adobe/aem-guides-wknd-graphql.git -
Abra Android Studio y abra la carpeta
android-app -
AEM Modifique el archivo
config.propertiesenapp/src/main/assets/config.propertiesy actualicecontentApi.endpointpara que coincida con el entorno de destino de la aplicación de la:contentApi.endpoint=https://publish-p123-e456.adobeaemcloud.comAutenticación básica
AEM
contentApi.userycontentApi.passwordautentican a un usuario local de la aplicación con acceso al contenido de WKND GraphQL.contentApi.endpoint=https://author-p123-e456.adobeaemcloud.com contentApi.user=my-special-android-app-user contentApi.password=password123 -
Descargar un dispositivo virtual Android (API mínima 28).
-
Cree e implemente la aplicación mediante el emulador de Android.
AEM Conexión a entornos de
AEM Si se requiere la conexión a un entorno de autor de authorization. AEMHeadlessClientBuilder proporciona la capacidad de usar autenticación basada en token. Para usar el generador de cliente de actualización de autenticación basada en token en AdventureLoader.java y AdventuresLoader.java:
/* Comment out basicAuth
if (user != null && password != null) {
builder.basicAuth(user, password);
}
*/
// use token-authentication where `token` is a String representing the token
builder.tokenAuth(token)
El código
A continuación se muestra un breve resumen de los archivos y el código importantes utilizados para activar la aplicación. El código completo se encuentra en GitHub.
Consultas persistentes
AEM Siguiendo las prácticas recomendadas de las consultas sin encabezado, la aplicación de iOS AEM utiliza consultas persistentes de GraphQL para consultar datos de aventuras, de forma predeterminada, de la manera más sencilla. La aplicación utiliza dos consultas persistentes:
- AEM
wknd/adventures-allpersistió en la consulta, lo que devuelve todas las aventuras en la que se ha realizado un seguimiento con un conjunto abreviado de propiedades. Esta consulta persistente genera la lista de aventuras de la vista inicial.
# Retrieves a list of all adventures
{
adventureList {
items {
_path
slug
title
price
tripLength
primaryImage {
... on ImageRef {
_dynamicUrl
_path
}
}
}
}
}
wknd/adventure-by-slugpersistió en la consulta, lo que devuelve una sola aventura deslug(una propiedad personalizada que identifica de forma exclusiva una aventura) con un conjunto completo de propiedades. Esta consulta persistente activa las vistas de detalles de aventura.
# Retrieves an adventure Content Fragment based on it's slug
# Example query variables:
# {"slug": "bali-surf-camp"}
# Technically returns an adventure list but since the the slug
# property is set to be unique in the CF Model, only a single CF is expected
query($slug: String!) {
adventureList(filter: {
slug: {
_expressions: [ { value: $slug } ]
}
}) {
items {
_path
title
slug
activity
adventureType
price
tripLength
groupSize
difficulty
price
primaryImage {
... on ImageRef {
_dynamicUrl
_path
}
}
description {
json
plaintext
}
itinerary {
json
plaintext
}
}
_references {
...on AdventureModel {
_path
slug
title
price
__typename
}
}
}
}
Ejecutar consulta persistente de GraphQL
AEM las consultas persistentes se ejecutan a través de la GET AEM HTTP y, por lo tanto, el cliente sin encabezado para Java se usa para ejecutar las consultas de GraphQL AEM persistentes en la aplicación y cargar el contenido de la aventura en la aplicación.
AEM Cada consulta persistente tiene una clase de "cargador" correspondiente, que llama asincrónicamente al punto final de GET HTTP de la y devuelve los datos de aventura utilizando el modelo de datos definido personalizado.
-
loader/AdventuresLoader.javaObtiene la lista de aventuras en la pantalla principal de la aplicación mediante la consulta persistente
wknd-shared/adventures-all. -
loader/AdventureLoader.javaObtiene una sola aventura seleccionándola a través del parámetro
slug, usando la consulta persistentewknd-shared/adventure-by-slug.
//AdventuresLoader.java
public static final String PERSISTED_QUERY_NAME = "/wknd-shared/adventures-all";
...
AEMHeadlessClientBuilder builder = AEMHeadlessClient.builder().endpoint(config.getContentApiEndpoint());
// Optional authentication for basic auth
String user = config.getContentApiUser();
String password = config.getContentApiPassword();
if (user != null && password != null) {
builder.basicAuth(user, password);
}
AEMHeadlessClient client = builder.build();
// run a persistent query and get a response
GraphQlResponse response = client.runPersistedQuery(PERSISTED_QUERY_NAME);
Modelos de datos de respuesta de GraphQL
Adventure.java es un POJO de Java que se inicializa con los datos JSON de la petición GraphQL y modela una aventura para usarla en las vistas de la aplicación Android.
Vistas
La aplicación de Android utiliza dos vistas para presentar los datos de la aventura en la experiencia móvil.
-
AdventureListFragment.javaInvoca
AdventuresLoadery muestra las aventuras devueltas en una lista. -
AdventureDetailFragment.javaInvoca a
AdventureLoadermediante el parámetroslugpasado a través de la selección de aventuras en la vistaAdventureListFragmenty muestra los detalles de una sola aventura.
Imágenes remotas
loader/RemoteImagesCache.java es una clase de utilidad que ayuda a preparar imágenes remotas en una caché para que se puedan utilizar con elementos de la interfaz de usuario de Android. El contenido de aventura hace referencia a imágenes en AEM Assets a través de una dirección URL y esta clase se utiliza para mostrar ese contenido.
