Capítulo 7 - Consumo de AEM Content Services desde una aplicación móvil

El capítulo 7 del tutorial utiliza una aplicación móvil nativa de Android para consumir contenido de AEM Content Services.

La aplicación móvil de Android

Este tutorial utiliza un aplicación móvil nativa y sencilla de Android para consumir y mostrar el contenido de Evento expuesto por AEM Content Services.

El uso de Android no es muy importante, y la aplicación móvil consumidora podría escribirse en cualquier marco para cualquier plataforma móvil, por ejemplo iOS.

Android se utiliza para tutoriales debido a la capacidad de ejecutar un emulador de Android en Windows, macOs y Linux, su popularidad y que puede escribirse como Java, un idioma que los desarrolladores AEM entienden bien.

La aplicación móvil Android del tutorial es not​pensado para instruir sobre cómo crear aplicaciones móviles de Android o transmitir las prácticas recomendadas de desarrollo de Android, pero más bien para ilustrar cómo se puede consumir AEM servicios de contenido desde una aplicación móvil.

Cómo AEM Content Services impulsa la experiencia de la aplicación móvil

Asignación de aplicaciones móviles a servicios de contenido

  1. La variable logo tal como se define en la Events API página Componente de imagen.
  2. La variable línea de etiqueta tal como se define en la variable Events API página Componente de texto.
  3. Esta Lista de eventos se deriva de la serialización de los fragmentos de contenido de evento, expuestos a través de la variable Componente Lista de fragmentos de contenido.

Demostración de la aplicación móvil

Configuración de la aplicación móvil para uso de host no local

Si AEM Publish no se está ejecutando en http://localhost:4503 el host y el puerto se pueden actualizar en la aplicación móvil Settings para señalar a la propiedad host/puerto de AEM Publish.

Ejecución local de la aplicación móvil

  1. Descargue e instale el Android Studio para instalar el emulador de Android.
  2. Descargar Android APK file GitHub > Assets > wknd-mobile.x.x.xapk
  3. Apertura Android Studio
    • Al iniciar Android Studio por primera vez, se le pedirá que instale la variable Android SDK presentará. Acepte los valores predeterminados y finalice la instalación.
  4. Abra Android Studio y seleccione Perfil o depuración de APK
  5. Seleccione el archivo APK (wknd-mobile.x.x.x.apk) descargado en el paso 2 y haga clic en OK
    • Si se le solicita que Crear una nueva carpeta o Usar existente, seleccione Usar existente.
  6. En el primer inicio de Android Studio, haga clic con el botón derecho en la wknd-mobile.x.x.x en la lista Proyectos y seleccione Abrir configuración del módulo.
    • En Módulos > wknd-mobile.x.x.x > Pestaña Dependencias, seleccione Plataforma de la API 29 de Android. Pulse Aceptar para cerrar y guardar los cambios.
    • Si no lo hace, verá el error "Seleccione el SDK de Android" al intentar iniciar el emulador.
  7. Abra el Administrador de AVD seleccionando Herramientas > Administrador de AVD o tocando el Administrador de AVD en la barra superior.
  8. En el Administrador de AVD ventana, haga clic en + Crear dispositivo virtual… si todavía no tiene el dispositivo registrado.
    1. En la parte izquierda, seleccione la opción Teléfono categoría.
    2. Seleccione un Píxel 2.
    3. Haga clic en el Siguiente botón.
    4. Select Q con Nivel de API 29.
      • Tras el primer inicio de AVD Manager, se le pedirá que descargue la API con versiones. Haga clic en el vínculo Descargar junto a la versión "Q" y complete la descarga y la instalación.
    5. Haga clic en el Siguiente botón.
    6. Haga clic en el Finalizar botón.
  9. Cierre las Administrador de AVD ventana.
  10. En la barra de menús superior, seleccione wknd-mobile.x.x.x de la variable Ejecutar/Editar configuraciones desplegable .
  11. Toque . Ejecutar situado junto a la Ejecutar/Editar configuración
  12. En la ventana emergente , seleccione la Pixel 2 API 29 dispositivo virtual y toque OK
  13. Si la variable WKND Mobile la aplicación no se carga inmediatamente, encuentra y toca en el WKND de la pantalla de inicio de Android en el emulador.
    • Si el emulador se inicia pero la pantalla del emulador sigue siendo negra, pulse el botón power en la ventana de herramientas del emulador junto a la ventana del emulador.
    • Para desplazarse dentro del dispositivo virtual, mantenga presionada la tecla y haga clic y arrastre.
    • Para actualizar el contenido desde AEM, desplácese hacia abajo desde la parte superior hasta que aparezca el icono Actualizar y libere.

El código de la aplicación móvil

Esta sección resalta el código de la aplicación móvil de Android que interactúa más y depende de AEM Content Services y de su salida JSON.

Al cargar, la aplicación móvil realiza HTTP GET a /content/wknd-mobile/en/api/events.model.json que es el punto final de AEM Content Services configurado para proporcionar el contenido que conduce la aplicación móvil.

Porque la plantilla editable de la API de eventos (/content/wknd-mobile/en/api/events.model.json) está bloqueado, la aplicación móvil se puede codificar para buscar información específica en ubicaciones específicas en la respuesta JSON.

Flujo de código de alto nivel

  1. Apertura del WKND Mobile La aplicación invoca a HTTP GET solicitud para AEM Publish en /content/wknd-mobile/en/api/events.model.json para recopilar el contenido que rellenará la interfaz de usuario de la aplicación móvil.
  2. Al recibir el contenido de AEM, cada uno de los tres elementos de vista de la aplicación móvil, la variable logotipo, línea de etiquetas y lista de eventos, se inicializan con el contenido de AEM.
    • Para enlazar el contenido de AEM al elemento de vista de la aplicación móvil, el JSON que representa cada componente de AEM, es un objeto asignado a un POJO de Java, que a su vez está enlazado al elemento Vista de Android.
      • Componente de imagen JSON → Logotipo POJO → Logo ImageView
      • Componente de texto JSON → POJO TagLine → Texto ImageView
      • Lista de fragmentos de contenido JSON → Eventos POJO → Eventos RecyclerView
    • El código de la aplicación móvil puede asignar el JSON a los POJO debido a las ubicaciones conocidas dentro de la buena respuesta JSON. Recuerde que las claves JSON de "imagen", "texto" y "contentfragmentlist" están dictadas por los nombres de nodo de los componentes AEM respaldo. Si cambian estos nombres de nodo, la aplicación móvil se romperá, ya que no sabrá cómo crear el contenido necesario a partir de los datos JSON.

Invocación del punto final de los servicios de contenido de AEM

A continuación se muestra una destilación del código en la aplicación móvil MainActivity responsable de invocar AEM Content Services para recopilar el contenido que impulsa la experiencia de aplicación móvil.

protected void onCreate(Bundle savedInstanceState) {
    ...
    // Create the custom objects that will map the JSON -> POJO -> View elements
    final List<ViewBinder> viewBinders = new ArrayList<>();

    viewBinders.add(new LogoViewBinder(this, getAemHost(), (ImageView) findViewById(R.id.logo)));
    viewBinders.add(new TagLineViewBinder(this, (TextView) findViewById(R.id.tagLine)));
    viewBinders.add(new EventsViewBinder(this, getAemHost(), (RecyclerView) findViewById(R.id.eventsList)));
    ...
    initApp(viewBinders);
}

private void initApp(final List<ViewBinder> viewBinders) {
    final String aemUrl = getAemUrl(); // -> http://localhost:4503/content/wknd-mobile/en/api/events.mobile.json
    JsonObjectRequest request = new JsonObjectRequest(aemUrl, null,
        new Response.Listener<JSONObject>() {
            @Override
            public void onResponse(JSONObject response) {
                for (final ViewBinder viewBinder : viewBinders) {
                    viewBinder.bind(response);
                }
            }
        },
        ...
    );
}

onCreate(..) es el vínculo de inicialización de la aplicación móvil y registra los 3 ViewBinders responsable de analizar el JSON y enlazar los valores a la variable View elementos.

initApp(...) a continuación, se llama a , lo que hace que la solicitud de GET HTTP se dirija al punto final de los servicios de contenido de AEM en AEM Publish para recopilar el contenido. Al recibir una respuesta JSON válida, la respuesta JSON se pasa a cada ViewBinder que es responsable de analizar el JSON y vincularlo al móvil View elementos.

Análisis de la respuesta de JSON

A continuación, veremos el LogoViewBinder, que es sencillo, pero destaca varias consideraciones importantes.

public class LogoViewBinder implements ViewBinder {
    ...
    public void bind(JSONObject jsonResponse) throws JSONException, IOException {
        final JSONObject components = jsonResponse.getJSONObject(":items").getJSONObject("root").getJSONObject(":items");

        if (components.has("image")) {
            final Image image = objectMapper.readValue(components.getJSONObject("image").toString(), Image.class);

            final String imageUrl = aemHost + image.getSrc();
            Glide.with(context).load(imageUrl).into(logo);
        } else {
            Log.d("WKND", "Missing Logo");
        }
    }
}

La primera línea de bind(...) baja por la respuesta JSON a través de las claves :items → raíz → :items que representa el contenedor de diseño de AEM al que se agregaron los componentes.

A partir de aquí se realiza una comprobación para una clave denominada image, que representa el componente Imagen (de nuevo, es importante que este nombre de nodo → clave JSON sea estable). Si este objeto existe, lee y asigna al POJO de imagen personalizado vía el Jackson ObjectMapper biblioteca. La imagen POJO es explorada a continuación.

Finalmente, el logotipo src se carga en ImageView de Android usando la variable Glide biblioteca de ayuda.

Tenga en cuenta que debemos proporcionar el esquema de AEM, host y puerto (mediante aemHost) a la instancia de AEM Publish, ya que AEM Content Services solo proporcionará la ruta JCR (es decir, /content/dam/wknd-mobile/images/wknd-logo.png) al contenido al que se hace referencia.

La imagen POJO

Aunque es opcional, el uso de la variable Jackson ObjectMapper o funciones similares proporcionadas por otras bibliotecas como Gson, ayudan a asignar estructuras JSON complejas a los POJO de Java sin el tedio de tratar directamente con los propios objetos JSON nativos. En este simple caso, asignamos la variable src de la variable image objeto JSON, para src en el POJO de imagen directamente a través del @JSONProperty anotación.

package com.adobe.aem.guides.wknd.mobile.android.models;

import com.fasterxml.jackson.annotation.JsonProperty;

public class Image {
    @JsonProperty(value = "src")
    private String src;

    public String getSrc() {
        return src;
    }
}

El POJO de eventos, que requiere la selección de muchos más puntos de datos del objeto JSON, se beneficia de esta técnica más que la imagen simple, que todo lo que queremos es la src.

Explorar la experiencia de la aplicación móvil

Ahora que conoce cómo AEM Content Services puede impulsar la experiencia nativa de Mobile, utilice lo que ha aprendido para realizar los siguientes pasos y ver los cambios reflejados en la aplicación móvil.

Después de cada paso, actualice la aplicación móvil y confirme la actualización a la experiencia móvil.

  1. Crear y publicar new Event Fragmento de contenido
  2. Cancelar la publicación de existente Event Fragmento de contenido
  3. Publicar una actualización en Línea de etiquetas

Felicitaciones

¡Ha completado el tutorial AEM sin encabezado!

Para obtener más información sobre AEM Content Services y AEM as a Headless CMS, visite la documentación y otros materiales de habilitación de Adobe:

En esta página