MANUAL DE DESPLIEGUE DE APLICACIONES MÓVILES

Transcripción

1 MANUAL DE DESPLIEGUE DE APLICACIONES MÓVILES FRAMEWORK MOVA Versión 1.0 Área de Arquitecturas Unidad de Arquitectura Software de Aplicaciones

2 Hoja de Control del Documento Título Responsable Manual de despliegue de aplicaciones móviles Unidad de Arquitectura Software de Aplicaciones Versión 1.0 Fecha Versión 29/03/2017 Registro de Cambios Versión Causa del Cambio Fecha del Cambio 1.0 Versión inicial del documento 28/03/2017 1

3 Índice 1 INTRODUCCIÓN AUDIENCIA OBJETIVO CONOCIMIENTOS PREVIOS DESCRIPCIÓN TECNOLOGIAS CORDOVA NPM GULP PROCESO DE DESPLIEGUE Generar APK (Android) Generar IPA (ios) Generar los plugins APPLE Certificados, IDs y Perfiles Certificado de desarrollador Perfil de aprovisionamiento Certificado de distribución Identificador de la App Notificaciones Push GOOGLE Notificaciones Push AMAZON Notificaciones SNS PREGUNTAS FRECUENTES ENLACES RELACIONADOS

4 1 INTRODUCCIÓN MOVA es un framework para el desarrollo de aplicaciones móviles híbridas. 1.1 AUDIENCIA OBJETIVO Este documento va dirigido a los desarrolladores que vayan a utilizar MOVA para el desarrollo de aplicaciones móviles híbridas. 1.2 CONOCIMIENTOS PREVIOS Para un completo entendimiento del documento, el lector deberá tener conocimientos previos sobre las siguientes tecnologías: Cordova NodeJS Gulp NPM 2 DESCRIPCIÓN MOVA es un framework para el desarrollo de Apps híbridas. Estas Apps son generadas para cada plataforma mediante el procedimiento de despliegue que se explica en este manual. Partiendo de un proyecto MOVA se consiguen los proyectos nativos de cada plataforma. Estos proyectos son compilados produciendo las Apps para su plataforma. 3

5 3 TECNOLOGIAS A continuación se explica en detalle el uso de las distintas tecnologías con las que se despliega una App con MOVA. 3.1 CORDOVA Web: Apache Cordova, en adelante Cordova, es un framework para el desarrollo de aplicaciones móviles. Cordova ofrece Cordova CLI, que nos permite mediante línea de comandos realizar acciones tan importantes como generar los proyectos nativos de cada plataforma o instalar los plugins necesarios. Es recomendable visitar el apartado de documentación sobre Cordova CLI en su web y en definitiva toda la documentación en general. 3.2 NPM Web: NPM es un gestor de paquetes de NodeJS, que nos permite descargar librerías y enlazarlas. () 3.3 GULP Web: Gulp es una herramienta, en forma de script en NodeJS, que te ayuda a automatizar tareas comunes en el desarrollo de una aplicación. 4 PROCESO DE DESPLIEGUE Importante El entorno de despliegue puede estar montado en el mismo equipo que el entorno de desarrollo. Dependiendo del sistema operativo del entorno de despliegue se podrán generar todas o solo algunas plataformas. Por ejemplo, para generar una App para ios es necesario tener Xcode instalado y este software es exclusivo del sistema operativo OSX. Se considera como proceso de despliegue de una App con MOVA todos los procesos que un usuario debe seguir para, partiendo de un proyecto de una App con MOVA, poder generar el fichero nativo de la App para las distintas plataformas para las que puede estar disponible. 4

6 Se considera que el usuario dispone del entorno de despliegue preparado con las tecnologías necesarias instaladas. En los entornos Windows se utilizará la consola de Windows (CMD), en los entornos con OSX se utilizará el terminal. En adelante, para mayor sencillez nos referiremos a ambos programas como terminal. En el entorno Windows es necesario ejecutar el terminal en modo administrador, en el caso de OSX es necesario ejecutar los comandos con la orden sudo. 4.1 Generar APK (Android) APK, es como se conoce al fichero con extensión.apk que tiene empaquetada la App en su interior y que permite instalarla en los dispositivos Android. Cordova CLI puede generar un proyecto nativo Android y compilarlo para generar el APK. Un fichero APK puede generarse desde un entorno de desarrollo con Windows o con OSX como sistema operativo. El primer paso es posicionarnos en el directorio raíz de la ruta del proyecto MOVA desde el terminal. Podemos reconocer el directorio raíz como el directorio que contiene a su vez los directorios src, www y los ficheros config.xml y package.json. Si el proyecto MOVA no contiene el directorio platforms/android en su directorio raíz, es necesario ejecutar el siguiente comando para poder generar la plataforma Android: cordova platforms add android Crear plataforma Android El siguiente paso es compilar el proyecto MOVA mediante el siguiente comando: cordova build android Crear plataforma Android Este comando creará un proyecto nativo de Android dentro del directorio platforms. Con este paso ya tendríamos disponible el APK de la App de debug. Se puede encontrar en el directorio /platforms/android/build/outputs/apk/android-debug.apk. 4.2 Generar IPA (ios) IPA es como se conoce al fichero con extensión.ipa que tiene empaquetada la App en su interior y que permite instalarla en los dispositivos con ios. 5

7 El primer paso es posicionarnos en el directorio raíz de la ruta del proyecto MOVA desde el terminal. Podemos reconocer el directorio raíz como el directorio que contiene a su vez los directorios src, www y los ficheros config.xml y package.json. Si el proyecto MOVA no contiene el directorio platforms/ios en su directorio raíz, es necesario ejecutar el siguiente comando para poder generar la plataforma ios: cordova platforms add ios Crear plataforma Android El siguiente paso es compilar el proyecto MOVA mediante el siguiente comando: cordova build ios Crear plataforma Android Este comando creará un proyecto nativo de ios dentro del directorio platforms. Con este paso no hemos generado aun el IPA, para ello es necesario abrir el proyecto nativo mediante el IDE Xcode y generar el IPA mediante la opción de generación que necesitemos. 4.3 Generar los plugins Los plugins son una parte fundamental de Cordova. Los plugins en Cordova son un tipo de add-on que implementa mediante una interfaz JavaScript funcionalidad nativa de las distintas plataformas. Cordova dispone de una buena comunidad creadora de distintos plugins que ofrecen funcionalidad nativa que muy sencilla de implementar en nuestros proyectos. Para tener estos plugins disponibles en la App es necesario ejecutar el siguiente comando, siempre después de haber creado las plataformas y antes de realizar el build del proyecto: cordova plugin add [nombre-del-plugin] Crear plataforma Android Este comando debe repetirse para todos los plugins que necesitemos. Es recomendable la lectura del manual oficial de la web de Cordova: 5 APPLE 6

8 Apple dispone de una plataforma online de uso obligatorio para los desarrolladores de Apps para ios. Es obligatorio tener una cuenta de desarrollador de Apple. Una vez que disponemos de la cuenta de desarrollador podemos acceder a la plataforma desde Certificados, IDs y Perfiles La gestión de los certificados, IDs y perfiles de Apple se hacen desde la plataforma para desarroladores, en la sección Certificates, IDs & Profiles ^ Certificado de desarrollador El certificado de desarrollador es un documento con una clave que te permite firmar el código de tu App. Este certificado nos identifica como desarrolladores de la App. Este certificado se consigue pidiéndoselo a Apple de la siguiente manera. Abrimos la aplicación de acceso a llaveros de OSX. 7

9 Seguimos las instrucciones y elegimos la opción de guardar en disco. El siguiente paso es volver a la plataforma de desarrolladores y elegimos la opción de solicitar un certificado. Elegimos la opción de ios App development. La plataforma nos mostrará las instrucciones a seguir para crear el certificado, son las mismas que hemos seguido antes. 8

10 Finalmente nos ofrece un formulario para subir nuestro certificado a la plataforma. 9

11 Una vez realizado todo el proceso el certificado aparecerá como pendiente. Pasados unos segundos solo hay que actualizar la página y debería aparecer como creado. El siguiente paso, una vez creado, es descargarlo. Se puede descargar haciendo click en el botón de descargar. 10

12 Una vez descargado hacemos doble click sobre el fichero. Esto provocará que sea abierto mediante la propiedad de acceso a llaveros de OSX y lo añadirá con otros certificados del equipo. Ahora el equipo esta capacitado para firmar código. Esto no quiere decir que puedas instalar Apps que estes desarrollando en tus dispositivos de Apple. Para esto necesitas otra pieza llamada provisioning profile o perfil de aprovisionamiento Perfil de aprovisionamiento El perfil de aprovisionamiento es una especie de contenedor de documentos, entre ellos contendrá el certificado de desarrollador explicado en el apartado anterior. En concreto un perfil de aprovisionamiento contiene 3 tipos de documentos: Certificados de desarrollo: Identifican al desarrollador. Identificadores de dispositivo: Identifican a los dispositivos. Identificador de la App: Identifican la App. Debido a esto un perfil de aprovisionamiento contiene la información de quien puede utilizar una App concreta en desarrollo en una serie de dispositivos autorizados. Podemos generar este perfil de aprovisionamiento desde Xcode de forma automática mediante el organizar. Es necesario haber creado previamente el perfil de desarrollador. Basta con conectar el dispositivo e intentar añadirlo al organizar. Xcode se encargará de crear el perfil de aprovisionamiento por defecto. Si fuese necesario crear distintos perfiles de aprovisionamiento entonces habría que acceder a la plataforma de desarrollador e ir creándolos de uno en uno. Este paso nos va a mostrar un formulario para elegir el tipo de perfil de aprovisionamiento necesario. Y si no tenemos creado el identificador de la App, también será necesario crearlo a mano antes de crear el perfil de aprovisionamiento ya que es necesario cumplimentar este campo en el momento de su creación. La creación de un identificador de App se explica en un apartado posterior. Este proceso puede ser algo más complejo y va a depender bastante de las necesidades de cada equipo y cada App por lo que es recomendable la lectura de la ayuda oficial de Apple: El siguiente paso es instalar el perfil de aprovisionamiento en el dispositivo. Xcode lo hace de forma automática. Simplemente hay que conectar el dispositivo, seleccionarlo y ejecutar la App igual que se haría con el simulador Certificado de distribución 11

13 Este certificado es necesario para poder firmar la App para su distribución como creadores de la App. Los pasos a seguir son los mismos que en el apartado anterior donde se explica la creación de un certificado de desarrollador. La diferencia se encuentra en los pasos a seguir en la plataforma de desarrollador de Apple. El tipo de certificado necesario será del apartado de procucción, el llamado In-House and Ad Hoc que es el necesario para distribuir las Apps en el App Store de Apple. Los siguientes pasos son subir el certificado, esperar a que aparezca como creado, descargarlo e instalarlo mediante el programa acceso a llaveros de OSX. El último paso sería el de crear un perfil de aprovisionamiento de desarrollo, eligiendo la opción que necesitemos para la App, bien si se va a publicar en la App Store de Apple, bien si se va a publicar en un entorno controlado mediante una cuenta Enterprise de Apple ( Para más información es recomendable seguir la ayuda ofrecida por Apple en su plataforma de desarrollador ya que es habitual que aparezcan cambios en este proceso cada cierto tiempo Identificador de la App El identificador de la App es una información necesaria para poder identificar una App de forma inequívoca. Este identificador puede crearse desde la plataforma de desarrollador de Apple. A continuación se nos mostrará un formulario que requiere cierta información identificativa del equipo de desarrollo, de la App y los servicios que va a utilizar la App, como pueden ser los servicios de mensajería Push. 12

14 El identificador de la App no genera ningún fichero descargable, deberemos acceder a la plataforma de desarrolladores de Apple si queremos activar o desactivar algunos servicios de la App. 5.2 Notificaciones Push El servicio de notificaciones Push de Apple distingue dos entornos, desarrollo y distribución. Para cada entorno es necesario un certificado distinto. El proceso para crear los certificados es el mismo que el utilizado para crear un certificado de desarrollador. La diferencia en el proceso se encuentra a la hora de seleccionar el tipo de certificado. Apple Push Notification service SSL (Sandbox) para el entorno de desarrollo o Apple Push Notification Service SSL (Sandbox & Production) para el entorno de producción, cuando la App va a ser publicada. 13

15 Una vez este creado estos certificados en la plataforma para desarrolladores de Apple lo descargamos y lo instalamos en el equipo. Es importante recordar que esta funcionalidad debe ser activada por el desarrollador en el proyecto nativo mediante Xcode. 14

16 Xcode se encarga automáticamente de realizar las comprobaciones necesarias. 6 GOOGLE Google dispone de una plataforma online para desarrolladores y una consola para gestionar los distintos servicios que Google ofrece, como por ejemplo las notificaciones Push. Puede accederse a la consola de APIs de Google desde el siguiente enlace: Notificaciones Push El servicio de notificaciones Push de Google no distingue entre entornos y se configura desde la consola de APIs de Google. En Google este servicio se llama Google Cloud Messaging. Este servicio necesita ser habilitado desde la consola de APIs de Google. Actualmente esto se hace desde la plataforma Firebase adquirida por Google: Importante Actualmente Google está avisando de que el servicio GCM quedará sustituido por el servicio FCM de Firebase, aunque de momento funcionan ambos. Es importante, de cara a configurar este servicio en plataformas intermedias como por ejemplo Amazon, o al instalar los plugins necesarios, no confundir conceptos como el id del proyecto con el número del proyecto. Desde Firebase debemos crear un nuevo proyecto. 15

17 Después de la creación del proyecto accederemos a un portal dedicado a todas las opciones de nuestro proyecto. La opción que nos interesa es la de mensajería en la nube. A la que se accede desde el apartado de configuración del proyecto. 16

18 Como podemos ver ya tenemos creada una clave de servidor. Es recomendable acceder a la consola de las APIs de Google y confirmar que la clave de servidor se ha creado correctamente y que el proyecto existe en Firebase y en la consola de las APIs de Google con el mismo id de proyecto. 7 AMAZON Amazon ofrece una variedad de servicios en la nube que facilitan la implementación de funcionalidad para las aplicaciones móviles. 7.1 Notificaciones SNS El servicio de notificaciones SNS de Amazon facilita el uso de las notificaciones Push entre las distintas plataformas nativas. Permite trabajar de una forma única con los distintos servicios independientemente de su plataforma y provee de un SDK que se integra de forma sencilla en el código de servidor. Su funcionamiento se basa en la creación de aplicaciones, una aplicación para Amazon no es solo una App, es una plataforma nativa. Por ejemplo Android, el entorno de desarrollo de Apple o el entorno de producción de Apple, entre otros. Para crear una aplicación de uno de los entornos de Apple se muestra un formulario que debemos cumplimentar con los certificados de notificaciones Push de Apple. 17

19 En este caso es necesario generar un certificado.p12 desde el software de acceso a llaveros de OSX, asignar una contraseña que utilizaremos en este formulario y una vez subido el fichero cargar las credenciales del fichero. Para crear una aplicación del entorno Android Google Cloud Messaging (GCM) solamente necesitaremos la API Key de servidor. 18

20 Para más información es recomendable leer la documentación de Amazon SNS: 8 PREGUNTAS FRECUENTES Pregunta: Puedo generar un fichero IPA (App ios) en un PC con Windows? Respuesta: Para generar un IPA es necesario utilizar un ordenador con xcode instalado, xcode solo puede instalarse en los ordenadores de Apple de forma legal. Pregunta: Puedo generar un fichero APK (App Android) en un ordenador de Apple con OSX? Respuesta: Para generar un APK es necesario utilizar un ordenador con Android Studio instalado, este IDE puede instalrse en un ordenador Apple con OSX por lo que sí se puede generar un APK. Pregunta: Cuando intento usar Cordova CLI ocurren fallos constantemente Respuesta: Lo primero es comprobar el fallo y ver el motivo, si no lo tenemos muy claro muchas veces suelen ser problemas con los directorios de platforms o de plugins, puedes probar a borrar los directorios platforms y plugins para ejecutar de nuevo los comandos de Cordova para generar de nuevo los directorios. También debes comprobar, si estas detrás de un proxy, que esté bien configurado y que no tenga restringido el acceso las URLs de las dependencias de Cordova. No olvides crear primero las plataformas, luego los plugins y finalmente hacer un build. Si estas usando los scripts de MOVA del directorio tasks, puedes intentar ejecutar directamente los comandos de Cordova CLI uno a uno. Muchas veces el orden de los plugins importa y puede que el script de MOVA no lo haga bien para algún caso concreto. Pregunta: Sufro un error de memoria del HEAP insuficiente. 19

21 Respuesta: Este es un error sufrido por Android Studio y suele ser un error que también ocurre en el desarrollo con Eclipse, es necesario ampliar la memoria del HEAP. Puedes ver cómo hacer esto en el manual de preparación de entorno de MOVA. 20

22 9 ENLACES RELACIONADOS AngularJS Cordova Gulp NodeJS NPM