Desarrollo de aplicaciones Android

Puedes usar la API de XenMobile en tus aplicaciones móviles para permitir que interactúen con Citrix Endpoint Management. Este artículo describe cómo integrar el SDK de aplicaciones MDX en la biblioteca de tu aplicación y los pasos necesarios para probar, certificar y publicar tus aplicaciones.

Cómo usar el SDK de aplicaciones MDX

Aquí tienes algunos ejemplos de cómo podrías usar las API.

• Establecer restricciones en las aplicaciones

Puedes controlar si tu aplicación permite el acceso a ciertas funciones o acciones basándote en si las llamadas a la API indican que la aplicación está gestionada o encapsulada. Por ejemplo, si una aplicación no está gestionada o encapsulada, podrías permitir al usuario acceder a todas las funciones y acciones. Si una aplicación está encapsulada pero no gestionada, podrías restringir ciertas funciones o acciones. Si una aplicación está encapsulada y gestionada, podrías imponer restricciones adicionales a la aplicación.

Realizar acciones basadas en la configuración de políticas de Citrix Endpoint Management

Supongamos que quieres mostrar una notificación a los usuarios si un administrador de Citrix Endpoint Management establece la política de Requerir WiFi en Activado, lo que significa que la aplicación puede ejecutarse en una red inalámbrica. Puedes usar la API para buscar la configuración de la política y luego basar los cambios de tu código en el valor de la política.

• Realizar acciones basadas en políticas personalizadas

  Puedes usar las API para leer políticas personalizadas en tus aplicaciones. Por ejemplo, supongamos que quieres permitir a los administradores de Citrix Endpoint Management mostrar una notificación en la aplicación. Para ello, puedes crear una política personalizada que esté vacía por defecto o que contenga un mensaje del sistema proporcionado por un administrador en la consola de Citrix Endpoint Management. Cuando tu aplicación está gestionada, puede detectar cuándo el administrador de Citrix Endpoint Management cambia el valor de la política. Si el valor de la política contiene un mensaje, tu aplicación muestra la notificación.

Para las definiciones de la API, consulta API para Android.

Integración del SDK en la biblioteca de tu aplicación usando Android Studio y Gradle

Para agregar el SDK de aplicaciones MDX a tus aplicaciones Android, importa o copia las bibliotecas Java de la aplicación MDX en tu aplicación, como se describe en esta sección. Los pasos se basan en Android Studio y el sistema de compilación Gradle. Seguir los pasos agrega la biblioteca del SDK de aplicaciones MDX a tu aplicación para que sus clases y métodos sean accesibles para la aplicación.

1. Si aún no has instalado el MDX Toolkit más reciente, hazlo ahora.

   1. Inicia sesión en la página de descargas de Citrix Endpoint Management.

   2. Expande XenMobile® Apps and MDX Toolkit.

   3. Localiza la versión del MDX Toolkit que quieres instalar y luego haz clic en su enlace para iniciar la descarga.

   4. Abre MDXToolkit.mpkg con la herramienta Finder de macOS en macOS 10.9.4 o posterior y Xcode 5.1 o posterior.

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

   Los archivos del SDK de aplicaciones MDX están en Applications/Citrix/MDXToolkit/data/MDXSDK_Android.

2. Después de instalar el MDX Toolkit, instala Android Studio desde el sitio web para desarrolladores de Android y luego haz lo siguiente:

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

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

   3. Edita el archivo “build.gradle” del proyecto para agregar una regla que busque la carpeta libs como repositorio e incluya worxsdk.aar de la carpeta libs como dependencia.

   4. Compila tu 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')
<!--NeedCopy-->

La biblioteca OpenSSL podría causar conflictos con bibliotecas similares en aplicaciones Android. Citrix® recomienda que uses las versiones de Citrix de las bibliotecas para evitar conflictos.

Publicación de una aplicación Android

Después de agregar el SDK de aplicaciones MDX a una aplicación Android, realiza los siguientes pasos para encapsular, probar, certificar y publicar la aplicación. Al encapsular aplicaciones usando la interfaz de línea de comandos, incluye una de las siguientes opciones:

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

La opción predeterminada es –appType Enterprise. Usa las siguientes directrices para seleccionar el appType:

• Enterprise: Las aplicaciones requieren la instalación de Secure Hub en el dispositivo del usuario. Además, también debes 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 gestionado cuando detecta Secure Hub en el dispositivo del usuario y si publicas una aplicación coincidente. Cuando se ejecutan como una aplicación gestionada, las aplicaciones General se comportan igual que las aplicaciones Enterprise. Cuando se ejecutan como una aplicación no gestionada, las políticas de Citrix no se aplican.
• Premium: Las aplicaciones ISV pueden ejecutarse sin Secure Hub instalado en el dispositivo del usuario (inicialmente). La aplicación puede pasar a ser una aplicación gestionada si detecta Secure Hub en el dispositivo del usuario y si publicas una aplicación coincidente. Cuando la aplicación se ejecuta sin gestionar, MDX aplica algunas políticas, como las políticas de contención (permitir el acceso a la red, la captura de pantalla o el bloqueo de la cámara).

Si necesitas subir el archivo .apk encapsulado a una tienda de aplicaciones o a un servidor web, y ya conoces la URL, agrega la opción -storeURL. También puedes agregar la URL más tarde, como se indica más adelante en estos pasos.

El MDX Toolkit genera un archivo .apk modificado y un archivo .mdx. Usarás esos archivos en los siguientes pasos. Usa el MDX Toolkit para encapsular el archivo .apk de la aplicación. Para obtener detalles, consulta “Encapsulación de aplicaciones móviles Android” en la documentación del MDX Toolkit. Ese artículo incluye todos los comandos de encapsulación, incluidos los específicos para aplicaciones ISV.

Importante:

La opción de encapsular aplicaciones ISV usando la interfaz de usuario del MDX Toolkit ya no está disponible. Debes encapsular las aplicaciones ISV usando la línea de comandos.

Para probar tu aplicación

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

2. Usa la consola de Citrix Endpoint Management para agregar el archivo .mdx a Citrix Endpoint Management y entregarlo a un dispositivo Android para realizar pruebas. Para obtener detalles, consulta Para agregar una aplicación MDX a Citrix Endpoint Management. En ese dispositivo, prueba la funcionalidad MDX de tu aplicación.

   Si agregaste políticas personalizadas, asegúrate de verificar que esas políticas aparecen en la consola de Citrix Endpoint Management y funcionan como se espera. Si cambiaste default_sdk_policies.xml, prueba esos cambios. Para obtener detalles sobre cómo agregar políticas y cambiar los valores predeterminados de las políticas, consulta Valores predeterminados de las políticas y políticas personalizadas.

3. Soluciona cualquier problema encontrado en tu aplicación, regenera el archivo .apk de la aplicación y encapsula la aplicación de nuevo con el MDX Toolkit.

4. Envía el archivo .apk original (no el generado por el MDX Toolkit) a Citrix para su validación y certificación.

5. Después de que Citrix certifique tu aplicación, envía el archivo .apk generado por el MDX Toolkit a Google Play Store para su aprobación.

6. Después de que Google apruebe tu aplicación, ejecuta el MDX Toolkit para actualizar la URL de descarga de la aplicación en el archivo .mdx. Un comando de ejemplo que cambia la URL es el siguiente:

   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”

Proporciona el archivo .mdx final a un administrador de Citrix Endpoint Management, quien lo agregará a Citrix Endpoint Management y lo publicará para los usuarios. O, para que tu aplicación esté disponible para una distribución más amplia, puedes listar tu aplicación verificada por MDX en Citrix Ready Marketplace. Para obtener detalles, consulta Programa verificado de Citrix Ready.

Consideraciones para la actualización de aplicaciones

El software de Citrix Endpoint Management cambia significativamente entre versiones. Para aprovechar las últimas características y correcciones de errores, debes usar la última versión de MDX Toolkit para empaquetar tu aplicación. Asegúrate de empaquetar tu archivo .ipa o .apk original, no el archivo modificado que fue generado previamente por MDX Toolkit.

Asegúrate de usar la versión correspondiente del SDK de la aplicación MDX.