Aplicaciones para Android (requerimientos, instalación y configuración de Eclipse)

Requerimientos Android

Para construir y desplegar aplicaciones para Android, necesitará lo siguiente:

• Windows, OS X o Linux
• Eclipse con ADT Plugin
• Android SDK
• $0 - $25

En cuanto a los requisitos del sistema operativo, según los diferentes modos de uso, necesitará:

• Para el modo “On-line”: Android 2.2+ (API 8)
• Para el modo “Off-line”: Android 2.3+ (API 9)
• Para soporte de bases de datos locales: Android 2.2+ (API 8)

Configuración del entorno Android

1) Instalar herramientas de desarrollo Android

El entorno de desarrollo Android comprende Eclipse, el ADT Plugin para Eclipse y el Android SDK.

Google ahora ofrece un paquete ADT, que contiene Eclipse, el plugin ADT y el SDK para Android, todo ya configurado y listo para su uso.

• Descargue el paquete ADT desde: http://developer.android.com/sdk.
• Se trata de un archivo zip, que deberá extraer y colocar en el lugar que desee.
• A continuación lanzaremos la herramienta, mediante el ejecutable Eclipse que podremos encontrar bajo la carpeta de instalación ADT.

2) Importar el proyecto

• Primero descargue la última versión del “wrapper” Android. desde la página web Omnis.

Para importar el proyecto Omnis, deberá abrir Eclipse y hacer lo siguiente:

• Seleccione la opción “Import” del menú “File”.
• Una vez abierto el asistente, seleccione “General ≥ Existing Projects Into Workspace”.
• Desde la siguiente ventana escoja “select archive file” y el archivo “wrapper” zip que descargó anteriormente, después pulse “Finish”.

3) Uso del proyecto

Al usar proyectos “wrapper” Android, intentaremos siempre hacer uso del último SDK disponible. Sin embargo, deberá tenerse en cuenta que se actualizan muy a menudo, por lo que podría suceder que no disponga de una versión en particular instalada del SDK.

• Pulse botón-derecho sobre el nodo raíz del proyecto y seleccione “Properties”.
• Bajo la sección “Android” de las propiedades, asegúrese de tener marcado “Project Build Target”. Si dispone de varios SDK instalados, seleccione el más reciente. 

Si no dispone de un SDK reciente, le recomendamos que lo instale y lo marque como el “Build Target” a utilizar. El último “wrapper” para Android requiere cómo mínimo el API 18, pero le sugerimos que utilice siempre el más reciente. Para instalar otras versiones del SDK, use el “Android SDK Manager” accesible desde la barra de herramientas de Eclipse, icono:

Personalización de aplicaciones Android

Una vez importado el “wrapper” en Eclipse, deberá personalizarlo para su aplicación particular. Este proceso comprende los pasos siguientes:

1. Renombrar el proyecto
2. Editar el fichero “config.xml”
3. Cambiar el nombre del paquete
4. Cambiar el nombre visible de la aplicación (App Name)
5. Añadir iconos personalizados
6. Añadir pantallas de transición personalizadas
7. Eliminar elementos no requeridos
8. Localizar su aplicación
9. Agregar SCAFs (sólo para aplicaciones “off-line”)
10. Agregar bases de datos para funcionamiento “off-line”
11. Editar la ventana “Acerca de..”  

¡paso a paso! iremos viendo todo ésto en sucesivas entregas...

Aplicaciones para iOS (despliegue) (Parte 4 de 4)

A través de la tienda Apple (App Store)

DESCARGO DE RESPONSABILIDAD: Antes de llevar acabo el proceso que se describe a continuación, usted deberá leer los requisitos y las directrices de Apple sobre la publicación de aplicaciones. TigerLogic no se responsabiliza en cuanto a los contenidos de su aplicación.

Este proceso requiere de un “App Store Provisioning Profile”. Si no dispone de uno, consulte la sección “Configuración del entorno iOS” de la entrada "Aplicaciones para iOS (requerimientos, instalación y configuración de xCode)" en éste mismo blog.

El primer paso será crear un repositorio para sus aplicaciones en “iTunes Connect”.

• Conéctese a “iTunes Connect” (https://itunesconnect.apple.com) y seleccione “Manage Your Apps”.

• Pulse el botón “Add New App”, y siga los pasos del asistente para crear su repositorio. Tendrá que aportar datos descriptivos de su tienda, imágenes, etc. El asistente le proporcionará todas las instrucciones que necesite.

• Al terminar, habrá obtenido un repositorio de aplicaciones en estado de “Prepare For Upload”.

• Si está satisfecho con las descripciones, imágenes y etc. aportados, pulse “View Details” para ver su nuevo repositorio de aplicaciones y a continuación, pulse “Ready to Upload Binary” finalmente, siga los pasos del breve asistente que se abrirá a continuación.

• Su repositorio de aplicaciones deberá estar en estado de “Waiting For Upload”. Si es así, podrá subir su aplicación desde xCode.

• Abra el “Organizer” de xCode (Pulse: Cmd-Shift-2) y sitúese en la sección “Archives”.

• Seleccione el archivo que construyó en la sección anterior (Construcción de una aplicación iOS) y a continuación, pulse el botón “Validate”.

• Siga los pasos del asistente, indicando su repositorio de aplicaciones y su “App Store Provisioning Profile” cuando se le solicite.

• Se realizarán una serie de controles sobre su aplicación, tratando de localizar cualquier cuestión que pueda causar su rechazo.

• Si se encuentra algún problema, asegúrese de corregirlo (si es así deberá crear un nuevo archivo y re-validarlo) antes de seguir adelante. 

• Si todo ha ido bien, abra el “Organizer” y seleccione de nuevo “Archive”, pero esta vez pulse el botón “Distribute”.

• Al igual que antes, siga los pasos del asistente, indicando su repositorio de aplicaciones y su “App Store Provisioning Profile” cuando se le solicite.

• Al final de este proceso, su aplicación se habrá subido y presentado, pasando a estar a la espera de ser revisada por Apple. Podrá comprobar el progreso de esta revisión en “iTunes Connect”. Conviene que después de subir su aplicación compruebe como se ve en su tienda, puede que no se vea como usted esperaba. (por ejemplo, tal vez quiera revisar alguna captura de pantalla)

Si la evaluación termina con éxito (lo cual puede llegar a tardar varias semanas), se convertirá en disponible desde la App Store y abierta a millones de potenciales usuarios.

Aplicaciones para iOS (despliegue) (Parte 3 de 4)

Desde un servicio web propio

Con sólo un poco más de trabajo que el descrito en el proceso anterior, podrá dar a sus usuarios un toque de profesionalidad, automatizado el proceso de instalación desde su sitio web.

Este proceso requiere de un “Ad-Hoc Provisioning Profiles”. Si no dispone de uno, consulte la sección “Configuración del entorno iOS” de la entrada "Aplicaciones para iOS (requerimientos, instalación y configuración de xCode)" en éste mismo blog.

• Abra el “Organizer” de xCode (Pulse: Cmd-Shift-2) y sitúese en la sección “Archives”.

• Seleccione el archivo que construyó en la sección anterior (Construcción de una aplicación iOS) y a continuación, pulse el botón “Distribute”. 

• Sobre la ventana que se abrirá, seleccione “Save for Enterprise or Ad-Hoc Deployment” y después pulse “Next”.

• Seleccione el “Distribution Provisioning Profile” que desee usar para firmar la aplicación y pulse “Next”.

• Desde el cuadro de diálogo “Save As”, marque la casilla “Save for Enterprise Distribution”.

Esto ampliará el diálogo con varios campos nuevos que deberá rellenar del modo siguiente:

• Application URL - Esta es la URL donde se podrá encontrar la aplicación dentro del servidor. Se tratará de un archivo .ipa por lo que tendrá el formato: http://www.miservidor.com/Aplicaciones_iOS/miAplicacion.ipa.

• Title - Es el nombre que se mostrará para la aplicación mientras se descarga e instalación en el dispositivo. Una vez instalada, sólo se verá al nombre definido en su proyecto XCode.

• Small Image URL - Esta es la URL de una imagen PNG con tamaño 57x57 ubicada en un servidor web, será el icono que se muestre de fondo mientras la aplicación se descarga e instala en el dispositivo. Una vez instalada, la aplicación mostrará el icono ya definido en su proyecto XCode.

El fichero imagen “Icon2.png”, (ya usado en su proyecto) puede ser el adecuado.

• Tome nota de las ubicaciones indicadas para sus ficheros .ipa y .png, después pulse “Save”.

• Esto creará en el lugar indicado, dos ficheros, uno con extensión .ipa y otro con extensión .plist. Cópielos sobre el servidor web y en el espacio indicado en “Application URL”.

Si con el paso del tiempo olvida cuales fueron los lugares indicados (URL’s), podrá consultar el fichero .plist, ya que contiene su configuración.

• Copie también al servidor el fichero de imagen y en el espacio indicado en “Small Image URL”.

• Cree un enlace para su página web, con el siguiente formato:

itms-services://?action=download-manifest&url=≤URL hacia su fichero .plist≥

• Es posible que deba configurar el servidor web para transmitir adecuadamente este tipo de archivos. Podrá hacerlo mediante ajustar los “MIME Types” para que reconozca los ficheros “.ipa” como “application/octet-stream” y los “.plist” como “text/xml”.

Ahora, si un dispositivo iOS sigue este enlace (y siempre que el dispositivo haya sido incluido en su “provisioning profile”), su aplicación se descargará e instalará.

Aplicaciones para iOS (despliegue) (Parte 2 de 4)

Despliegue manual

Este proceso requiere de un “Ad-Hoc Provisioning Profiles”. Si no dispone de uno, consulte la sección “Configuración del entorno iOS” de la entrada "Aplicaciones para iOS (requerimientos, instalación y configuración de xCode)" en éste mismo blog.

• Abra el “Organizer” de xCode (Pulse: Cmd-Shift-2) y sitúese en la sección “Archives”.

• Seleccione el archivo que construyó en la sección anterior (Construcción de una aplicación iOS) y a continuación, pulse el botón “Distribute”. 

• Sobre la ventana que se abrirá, seleccione “Save for Enterprise or Ad-Hoc Deployment” y después pulse “Next”.

• Seleccione el “Distribution Provisioning Profile” que desee usar para firmar la aplicación y pulse “Next”.

• Seleccione el lugar de destino en el cuadro de diálogo “Save As” y pulse “Save”.

Esto creará un archivo .ipa en el lugar indicado.

Lo que ha obtenido es una aplicación iOS firmada y lista para ser instalada en los dispositivos de los usuarios. Podrán hacerlo importando el archivo .ipa a iTunes, sincronizando después sus dispositivos.

Aplicaciones para iOS (despliegue) (Parte 1 de 4)

Despliegue de aplicaciones iOS

Una vez construida la aplicación, estará lista para su instalación en los diferentes dispositivos. A continuación describimos tres diferentes opciones en cuanto a cómo hacerla disponible a sus potenciales usuarios:

1. Despliegue manual


2. Desde un servicio web propio


3. A través de la tienda Apple (App Store)

Despliegue manual: Consiste simplemente en distribuir su archivo “App Ad-Hoc” a los usuarios de forma manual. Después deberán instalarlo en sus dispositivos por medio de de iTunes.

Desde un servicio web propio: Consiste en alojar su “App Ad-Hoc” en un servidor web, a fin de que sus usuarios puedan instalar la aplicación en sus dispositivos mediante un enlace.

A través de la tienda Apple (App Store): Para que su aplicación pueda figurar en la tienda Apple o “App Store”, el proceso es un poco más complicado, pero los beneficios hacen que merezca la pena. El proceso requerirá que su aplicación sea verificada manualmente por parte de Apple, esto hace que su implantación pueda dilatarse en el tiempo, tal vez hasta un par de semanas y sin garantía alguna de que será aceptada.

Aplicaciones para iOS (el "wrapper") (Parte 9 de 9)

Agregar bases de datos para funcionamiento “Off-line”.

Es posible añadir una base de datos SQLite preparada para su uso con la aplicación (naturalmente sólo si es construida mediante el “Target” para SQLite). La cual podrá ser usada desde los “form’s” mediante conexiones $sqlobject, e incorporada del siguiente modo:

• Arrastre el fichero .db de SQLite desde el sistema de archivos, a la carpeta “Resources” de su proyecto xCode.

• Asegúrese de seleccionar la opción “Copy items into destination group's folder”.
• Asegúrese también de marcar la casilla para que quede agregado al “SQLite target”.

• Edite el archivo “config.xml” de su proyecto e indique en su propiedad “≤ServerLocalDatabaseName≥” el nombre de la base de datos (incluyendo la extensión .db).

Tenga en cuenta que usted está creando una aplicación para un dispositivo móvil, por lo que no deberá pensar en una gran cantidad de datos a almacenar. Si necesita acceder a grandes bases de datos, seguramente deberá conectarse a un servidor Omnis y utilizar la funcionalidad de sincronización para actualizar datos con el dispositivo. Puede encontrar toda la información relacionada con Sync Server en la web de Omnis.

Construcción de una aplicación iOS

Una vez personalizado el proyecto para su aplicación, la creación de una versión distribuible es un proceso muy simple.

• Seleccione el código fuente apropiado (dependiendo de si su aplicación soportará o no bases de datos locales) de la lista desplegable y que se encuentra en la parte superior de la ventana xCode. También seleccione el dispositivo iOS que necesite.

• Seleccione “Archive” en el menú “Product” de xCode.

• De éste modo guardará el fichero de su proyecto en su estado actual. Con el podrá poner su aplicación a disposición de los usuarios, ya sea manualmente o a través de la tienda Apple “App Store”. Dicho proceso se describe con detalle en la sección siguiente “Despliegue de aplicaciones iOS”, ya que el proceso es diferente en función del modo de distribución elegido.

Aplicaciones para iOS (el "wrapper") (Parte 8 de 9)

Agregar SCAFs (sólo para aplicaciones “off-line”)

Si su aplicación debe incluir soporte para modo “off-line”, deberá decidir si incluirá o no los ficheros “SCAF” ya pre-instalados en la aplicación. Si lo hace, la aplicación será más grande, pero podrá ejecutarse en modo sin conexión desde el mismo principio, es decir, sin necesidad de conexión con el servidor Omnis para su actualización.

Para incluir los ficheros “SCAF” en la aplicación, deberemos hacer lo siguiente:

• Busque la carpeta html/sc localizable bajo el raíz de la instalación Omnis Studio.

• En caso de Windows, será bajo el directorio AppData, por ejemplo en: C:\Users\≤usuario≥\AppData\Local\TigerLogic\OS6.X\

• Localice el “App SCAF” de su aplicación. (Un archivo con extensión .db dentro del directorio “sc” y con el mismo nombre que tiene su librería)

• Localice también el “Omnis SCAF”. (Un archivo omnis.db situado en sc/omnis/)

• Importe ambos archivos SCAF a su proyecto en xCode, situándolos dentro del directorio “OmnisJSWrapper/Resources”.

• La forma más sencilla de hacerlo es arrastrándolos desde el Finder a su proyecto xCode. Asegúrese de seleccionar la opción “Copy Files” y de marcar las casillas “add to all of the targets”.