Desarrollo de aplicaciones Android

27 de febrero de 2018

Puede usar la API de XenMobile en las aplicaciones móviles para permitir que interactúen con XenMobile. En este artículo se describe cómo integrar el MDX App SDK en la biblioteca de aplicaciones y los pasos necesarios para realizar pruebas, certificar y publicar las aplicaciones.

Cómo usar el MDX App SDK

Estos son algunos ejemplos de cómo se pueden usar las API.

Establecer restricciones en aplicaciones

Se puede controlar si la aplicación permite el acceso a ciertas funciones o acciones en función de si las llamadas de API indican que la aplicación está administrada o empaquetada. Por ejemplo, si una aplicación no está administrada ni empaquetada, se puede permitir que un usuario acceda a todas las funciones y las acciones. Si una aplicación está empaquetada, pero no administrada, se puede restringir algunas funciones o acciones. Si una aplicación está empaquetada y administrada, se puede poner restricciones adicionales a la aplicación.

Realizar acciones según la configuración de directivas XenMobile

Supongamos que quiere mostrar una notificación a los usuarios si un administrador de XenMobile establece la directiva “Requerir Wi-Fi” en “Sí”, lo que significa que la aplicación tiene permiso para ejecutarse en una red inalámbrica. Puede usar la API para buscar la configuración de directiva y, a continuación, basar los cambios de código en el valor de la directiva.

  • Realizar acciones según la configuración de directivas personalizadas

    Puede usar las API para leer directivas personalizadas en las aplicaciones. Por ejemplo, supongamos que quiere permitir que los administradores de XenMobile muestren una notificación en la aplicación. Para ello, puede crear una directiva personalizada que esté vacía de forma predeterminada o contiene un mensaje del sistema que deba proporcionar un administrador desde la consola de XenMobile. Si la aplicación está administrada, podrá detectar el cambio del valor de la directiva que realice el administrador de XenMobile. Si el valor de la directiva contiene un mensaje, la aplicación puede mostrar la notificación.

Para obtener definiciones de las API, consulte API de XenMobile para Android.

Integración del SDK en la biblioteca de aplicaciones mediante Android Studio y Gradle

Para agregar el MDX App SDK a una aplicación Android, debe importar o copiar las bibliotecas MDX App Java a esa aplicación como se describe en esta sección. Los pasos se basan en Android Studio y el sistema de compilación de Gradle. Siguiendo estos pasos, se agrega la biblioteca MDX App SDK a la aplicación, de modo que esta pueda acceder a las clases y los métodos que esa biblioteca ofrece.

  1. Si no ha instalado ya el MDX Toolkit más reciente, hágalo ahora.

    1. Inicie sesión en la página de descargas de XenMobile.

    2. Expanda XenMobile Apps and MDX Toolkit.

    3. Busque la versión del MDX Toolkit que quiera instalar y, a continuación, haga clic en el enlace para comenzar la descarga.

    4. Abra MDXToolkit.mpkg con la herramienta Finder de macOS en macOS 10.9.4, o una versión posterior, y Xcode 5.1, o una versión posterior.

    La ruta de instalación es /Applications/Citrix/MDXToolkit.

    Los archivos del MDX App SDK se encuentran en Applications/Citrix/MDXToolkit/data/MDXSDK_Android.

  2. Después de instalar el MDX Toolkit, instale Android Studio desde el sitio Web de desarrolladores de Android y, a continuación, haga lo siguiente:

    1. En el directorio del proyecto, cree una carpeta llamada libs.

    2. Agregue el archivo worxsdk.aar a la carpeta libs.

    3. Modifique el proyecto “build.gradle” para agregar una regla que busque en la carpeta libs como si fuera un repositorio y para incluir worxsdk.aar desde la carpeta libs como si fuera una dependencia.

    4. Compile el archivo APK.

Un ejemplo de worxsdk.aar:

    // Top-level build file where you can add configuration options common to all sub-projects/modules.
    buildscript {
        repositories {
            jcenter()
        }
        dependencies {
            classpath 'com.android.tools.build:gradle:1.1.0'
            // NOTE: Do not place your application dependencies here; they belong
            // in the individual module build.gradle files
        }
    }
    allprojects {
        repositories {
            jcenter()
            flatDir {
                dirs 'libs'
            }
        }
    }
    dependencies {
        compile(name:'worxsdk', ext:'aar')

La biblioteca de OpenSSL pueden provocar conflictos con bibliotecas similares en las aplicaciones Android. Citrix recomienda usar las versiones de las bibliotecas de Citrix para evitar conflictos.

Publicación de una aplicación Android

Después de agregar el MDX App SDK a una aplicación Android, lleve a cabo los siguientes pasos para empaquetar, probar, certificar y publicar la aplicación. Cuando empaquete aplicaciones desde la interfaz de línea de comandos, incluya una de las siguientes opciones:

  • –appType Enterprise
  • -appType Premium
  • -appType General

El valor predeterminado es –appType Enterprise. Utilice las siguientes instrucciones para seleccionar appType (tipo de aplicación):

  • Enterprise: Requieren la instalación de Secure Hub en el dispositivo del usuario. Además, también debe publicar la aplicación en StoreFront e instalarla a través de Secure Hub.
  • General: Las aplicaciones ISV pueden ejecutarse sin Secure Hub (inicialmente). La aplicación puede pasar al modo administrado cuando detecte Secure Hub en el dispositivo de usuario y si se publica una aplicación correspondiente. Cuando se ejecute como una aplicación administrada, la aplicación General se comporta de la misma manera que las aplicaciones de empresa (Enterprise). Cuando se ejecuta como una aplicación no administrada, no se aplican las directivas de Citrix.
  • Premium: Las aplicaciones ISV pueden ejecutarse sin Secure Hub instalado en el dispositivo de usuario (inicialmente). La aplicación puede pasar al modo administrado si detecta Secure Hub en el dispositivo de usuario y si se publica una aplicación correspondiente. Cuando la aplicación se ejecute como no administrada, MDX aplica algunas directivas, como las directivas de contención (permiten el acceso de red, la captura de pantalla o bloquean la cámara).

Si necesita cargar el archivo .apk empaquetado a una tienda de aplicaciones o servidor Web y ya dispone de la URL, agregue la opción -storeURL. También puede agregar la dirección URL más tarde, como se indica en los pasos siguientes.

El MDX Toolkit presenta como resultado un archivo .apk modificado y un archivo .mdx. Se usarán esos archivos en los pasos siguientes. Use el MDX Toolkit para empaquetar el archivo .apk de la aplicación. Para obtener más información, consulte “Empaquetado de aplicaciones móviles Android” en la documentación del MDX Toolkit. Este artículo contiene todos los comandos de empaquetado, incluidos aquellos específicos de aplicaciones ISV.

Importante:

La opción para empaquetar aplicaciones ISV desde la interfaz de usuario del MDX Toolkit ya no está disponible. Debe empaquetar las aplicaciones ISV desde la línea de comandos.

Para probar la aplicación

  1. Instale el archivo .apk modificado en un dispositivo Android para verificar todas las funciones de la aplicación.

  2. Use la consola de XenMobile para agregar el archivo .mdx a XenMobile y entregarlo a un dispositivo Android para realizar pruebas. Para obtener más información, consulte Para agregar una aplicación MDX a XenMobile. En ese dispositivo, pruebe la funcionalidad MDX de la aplicación.

    Si agregó directivas personalizadas, debe comprobar que aparecen en la consola de XenMobile y funcionan según lo previsto. Si modificó default_sdk_policies.xml, pruebe los cambios. Para obtener más información sobre cómo agregar directivas y cambiar los valores predeterminados de las directivas, consulte Valores predeterminados de directivas y directivas personalizadas.

  3. Solucione los problemas que haya en la aplicación, vuelva a generar el archivo .apk y vuelva a empaquetar la aplicación con el MDX Toolkit.

  4. Envíe el archivo APK original (no el que resulte de usar el MDX Toolkit) a Citrix para la validación y la certificación.

  5. Una vez que Citrix haya certificado la aplicación, envíe el archivo .apk generado por el MDX Toolkit a Google Play Store para la aprobación.

  6. Después de que Google apruebe su aplicación, ejecute el MDX Toolkit para actualizar la URL de descarga de la aplicación en el archivo .mdx. Este es un comando de ejemplo que cambia la dirección URL:

    java -jar /Applications/Citrix/MDXToolkit/ManagedAppUtility.jar \
    setinfo \
    -in ~/Desktop/SampleApps/Sample.mdx \
    -out ~/Desktop/SampleApps/wrapped/Sample.mdx \
    -storeURL \
    “https://play.google.com/store/apps/details?id=com.zenprise”
    
  7. Facilite el archivo .mdx final a un administrador de XenMobile, quien lo agregará a XenMobile y lo publicará a los usuarios. O bien, para que la aplicación esté disponible para una distribución más amplia, puede incluir su aplicación MDX verificada en Citrix Ready Marketplace. Para obtener más información, consulte Citrix Ready Worx Verified Program.

Consideraciones sobre la actualización de aplicaciones

El software de XenMobile cambia considerablemente de una versión a otra. Para sacar partido de las ventajas que ofrecen las últimas características y correcciones de errores, debe utilizar la versión más reciente del MDX Toolkit para empaquetar la aplicación. Empaquete su archivo .ipa o .apk original, no el archivo modificado que haya generado previamente el MDX Toolkit.

Debe utilizar la versión correspondiente del MDX App SDK.