Uso del nuevo archivo de configuración del servidor de aplicaciones

Desde Omnis Studio 6.1 se incluye un nuevo archivo de configuración en formato JSON denominado "config.json" y situado en la carpeta "studio".

Es utlizado para configurar el servidor de aplicaciones Omnis, incluyendo propiedades de arranque, modo de uso y otras concernientes al uso de servicios web (Web Services). También incluye una sección específica para activar la caché de clases Java y otros elementos.

Habitualmente la configuración del servidor Omnis Server puede hacerse mediante seleccionar la opción "Server Configuration" del menú "File" desde el propio Omnis Server, pero, ahora también podrá hacerse mediante la edición del fichero "config.json" usando para elo cualquier editor de texto compatible, pero el archivo debe ajustarse al formato JSON.

La primera parte del archivo "config.json" contiene la siguiente distribución:

{
    "server": {
    "port": 5988,
    "stacks": 20,
    "timeslice": 1,
    "webServiceURL": "",
    "webServiceConnection": "",
    "webServiceLogging": "full",
    "webServiceLogMaxRecords": 100,
    "webServiceStrictWSDL": true,
    "RESTfulURL": "",
    "RESTfulConnection": "",
    "start": false,
    "retryBind": false,
    "showBindRetryMessage": true,
    "bindAttempts": 10
    }
}

donde...
 

• port, stacks, timeslice 
Permiten definir el modo en que se ejecutará el servidor Omnis.

• webService...
Definen los servicios web basados en SOAP/WSDL.

• RESTful...
Definen los servicios web basados en REST.

• start
Si es "true" significa que el servidor Omnis será activado automáticamente al arrancar.

• retryBind
La propiedad "retryBind" deberá establecerse a "false" si no se desea que el servidor Omnis vuelva a intentar la conexión al puerto especificado, tras un primer intento. Por defecto o si el parámetro es omitido "retryBind" es "true".

• showBindRetryMessage
Si "retryBind" es "true", "showBindRetryMessage" determinará si se mostrará o no, un mensaje de estado durante el tiempo que se esté re-intentando la conexión.

• bindAttempts
Si "retryBind" es "true", "bindAttempts" anula el número predeterminado de intentos de conexión, obligando al servidor Omnis a realizar un intento cada segundo.

 

Texto HTML en botones

Una nueva característica soportada por los controles JavaScript "Button" y "TransButton" nos permiten aportar textos con etiquetas HTML a los botones.

Para ello deberemos fijar su nueva propiedad "$textishtml" a "true", ésto afectará al modo en que será tratado el texto indicado para el botón (propiedad $text), el cual podrá ahora contener etiquetas HTML, ésto significa que podremos hacer uso de cualquier etiqueta HTML para aportar estilo al texto. Por ejemplo, podríamos insertar un salto de línea mediante la etiqueta "≤br≥".

La activación de la propiedad "$textishtml", no impide el uso del resto de atributos ya presentes para los controles de botón mencionados, por lo que no habrá problema alguno en seguir usando los elementos habituales para la asignación de estilo, tipo de letra y color.

Tenga en cuenta que modo-diseño no podremos observar el resultado de aplicar la etiqueta HTML (sólo veremos el código HTML) y si usamos atributos dentro del código HTML deberán ir situados entre comillas simples.

Probando nuestros "remote forms"

Si estamos usando Firefox durante el desarrollo de aplicaciones con Omnis, podemos usarlo para probar los diferentes diseños y tamaños de pantalla pensados para su uso en dispositivos móviles y tabletas mediante su utilidad "Vista de diseño adaptable", indicar que se trata de una característica del navegador Firefox y que Omnis puede aprovechar, pero que no parece estar disponible (por el momento) en otros navegadores.

Pero quiero hablar de ello en éste "blog", ya que nos puede ahorrar mucho tiempo a los desarrolladores Omnis, durante la fase de diseño de nuestras aplicaciones, ya que nos evitará tener que probar o testar la aplicación en múltiples dispositivos. Sin embargo, le recomiendo que finalmente también pruebe su aplicación sobre el o los dispositivos que usted desee estén soportados por su aplicación.

Para que Omnis pueda hacer uso de dicha funcionalidad del navegador, deberá establecer su propiedad "gResponsiveDesign" a "true", podrá encontrarla dentro del archivo "ssz.js" ubicado bajo el directorio "html/scripts" dentro del raíz Omnis. Tenga en cuenta que deberá reiniciar Omnis para que el cambio tenga efecto.

Finalmente y para activa el modo en Firefox, diríjase al menú "Herramientas" opción "Desarrollador web" y seleccione "Vista de diseño adaptable".

Una vez hecho ésto, podremos probar nuestros "remote form" seleccionando los diferentes tamaños de pantalla y orientaciones bajo el menú desplegable de la ventana del navegador Firefox, nuestro "remote form" cambiará según lo especificado en su propiedad $screensize. Cuando hayamos concluido con las pruebas, deberemos volver a cambiar la configuración de "gResponsiveDesign" del fichero "ssz.js" para dejarlo en modo "false".

Aplicaciones para BlackBerry (despliegue)

Construcción de aplicaciones BlackBerry

Una vez personalizado el proyecto, la creación de una versión distribuible es un proceso muy sencillo.

• Abra el fichero “bar-descriptor.xml” del proyecto y seleccione la pestaña “General”, después haga clic sobre el enlace “Export release build”.

Ahora bastará con pulsar “Finish” sobre el asistente, esto ocasionará que se exporte una archivo de aplicación ya firmado dentro de su “workspace” o “espacio de trabajo”. (concretamente será bajo la carpeta especificada en la ventana de diálogo bajo el campo “Export to folder:”)

Su aplicación final será un archivo con extensión .bar. Ahora sólo tendrá que elegir un modo de hacerlo llegar hasta los potenciales usuarios...

Aplicaciones para BlackBerry (el "wrapper") (Parte 8 de 8)

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

Si su aplicación incluye soporte “off-line”, deberá decidir si incluirá o no los ficheros SCAFs dentro de la propia aplicación. Tenga en cuenta, que si así lo hace, la aplicación será de mayor tamaño, aunque, sin embargo, podrá ser ejecutada en el modo “off-line”, es decir, sin necesidad de una primera conexión con el servidor para su actualización.

Si opta por incluir los ficheros SCAF en su aplicación, deberá hacer lo siguiente:

• Localice la carpeta “html/sc” bajo el directorio de instalación Omnis Studio.
• En un sistema Windows, la encontrará bajo el directorio “AppData”. Ejemplo: C:\Users\AppData\Local\TigerLogic\OS6.X\
• Localice su “App SCAF” (Un archivo con extensión .db bajo el directorio sc, con el mismo nombre que el asignado a su librería Omnis).
• Localice también su “Omnis SCAF” (El fichero omnis.db situado en sc/omnis/).
• Importe ambos ficheros SCAF a su proyecto BlackBerry, situándolos bajo el directorio “assets/Serverless”.
• La forma más fácil de hacer esto es arrastrarlos desde el explorador de archivos al proyecto abierto sobre el SDK. Asegúrese de tener seleccionada la opción “Copy Files”.

 

Aplicaciones para BlackBerry (el "wrapper") (Parte 7 de 8)

Localizar su aplicación

Si desea traducir los textos utilizados por la aplicación o “wrapper”, o si desea hacer uso de diferentes pantallas de inicio/iconos para según que idiomas, podrá hacerlo siguiendo los pasos que se describen a continuación. Si el dispositivo del usuario es ajustado para ser usado con alguno de los idiomas soportados, la aplicación automáticamente hará uso de los textos traducidos y/o iconos alternativos que se hayan especificado.

Añadiendo soporte multilingüe

• Abra el fichero “bar-descriptor.xml” del proyecto y seleccione la pestaña “Localization”.
• Aquí deberá figurar la lista con los idiomas para los que desee proporcionar traducciones.
• Podrá Agregar/Quitar idiomas mediante los botones “Add/Remove”.
• Modifique esta lista para poblarla con los lenguajes a los que desee aportar las diferentes traducciones.
• Si el idioma que desea aportar, no estuviese incluido en la lista, podrá agregarlo especificando un código de idioma sobre el campo “Other”, situado en la parte inferior.

 

Iconos y/o nombres de aplicación alternativos

• Seleccione uno de los lenguajes de la lista “Language”.
• A su derecha hallará el acceso a la sección  “Entry-Point Text and Images”.
• Rellene esta sección con los textos e imágenes para el idioma seleccionado.
• Cualquier valor introducido aquí anulará su predeterminado y según lo indicado por el usuario al configurar la opción de idioma del dispositivo. Si no se indica un texto o icono alternativo se tomar el predeterminado.

 

Traducción de cadenas de texto

El “wrapper” utiliza cadenas de texto en muchos lugares diferentes. Por ejemplo, en el menú de la aplicación. Estos también pueden ser traducidos.

• Una vez agregadas las diferentes lenguas, deberá “Build” (construir) y “Clean” (limpiar) su proyecto.
• Haga clic-derecho sobre el proyecto y seleccione la opción “Build Project”, después, pulse de nuevo clic-derecho y seleccione “Clean Project”.
• Esto deberá generar varios archivos con formato ..._XX.ts sobre el directorio “translations” del proyecto.
• Localice y edite el archivo .ts correspondiente al idioma que desee traducir.
• Podrá comprobar que se trata de un archivo XML compuesto de varias etiquetas ≤message≥ - cada una con su correspondiente ≤source≥ y ≤translation≥.
• En caso de haberse añadido nuevas lenguas, cada etiqueta ≤translation≥ incluirá un atributo type="unfinished". Mientras esté presente no se hará uso de la traducción.

• La etiqueta ≤source≥ contiene la cadena por defecto, y la etiqueta ≤translate≥ es la que deberá ser editada para contener la cadena traducida para ese idioma.
• Ejemplo: ≤source≥Application Auto Updater≤/source≥ ≤translation≥Mise à jour automatique≤/translation≥
• Si la etiqueta ≤translation≥ contiene el atributo type="unfinished", elimínelo, pues de lo contrario no se hará uso de la traducción.

Aplicaciones para BlackBerry (el "wrapper") (Parte 6 de 8)

Eliminar elementos no requeridos

Cada aplicación BlackBerry debe solicitar permisos para acceder a diversas áreas del dispositivo. (Contactos, Cámara, Localización, etc.) Es una mala práctica incluir permisos innecesarios en su aplicación, especialmente si se está distribuyendo a través de BlackBerry World, ya que cuando el usuario descarga o instala la aplicación, deberá aceptar los permisos a los que su aplicación solicita acceso. El uso de permisos innecesarios pueden darle al usuario la impresión de que su aplicación es maliciosa.

• Abra el fichero “bar-descriptor.xml” de su proyecto y seleccione la pestaña “Application”. 

• La sección “Permissions” de esta página le permitirá seleccionar los realmente requeridos por la aplicación, mediante el uso de casillas de verificación. 

• Por defecto, están marcados todos los permisos posibles para una aplicación Omnis. 

• Marque sólo los que su aplicación va a necesitar realmente y desactive todos los demás.

PERMISOS OBLIGATORIOS:

• Internet

El resto de permisos pueden ser eliminados para su aplicación, si es el caso que no los necesita. Sus nombres y descripciones son explicados por sí mismos cuando su aplicación los solicite.

Los permisos opcionales, (dependiendo de los requeridos por su aplicación) son los siguientes:

• Camera - necesario si se hará uso de lector de código de barras (kJSDeviceActionGetBarcode). 

• Contacts - necesario si se activa kJSDeviceActionGetContacts para acceder a la lista de contactos. 

• GPS Location - proporciona un ajuste fino (se usa el sensor GPS) sobre los datos de ubicación kJSDeviceActionGetGps. 

• Location - proporciona un ajuste parcial (se usa la red) sobre los datos de ubicación kJSDeviceActionGetGps. 

• Shared Files - necesario si se desea obtener imágenes desde la cámara o de entre las ya guardadas en el dispositivo (kJSDeviceActionTakePhoto o kJSDeviceActionGetImage).

Aplicaciones para BlackBerry (el "wrapper") (Parte 5 de 8)

Añadir iconos y pantallas de transición personalizadas

Los requisitos para el uso de imágenes son los siguientes:

• Icono de la aplicación: 

• 114x114 PNG

• Pantallas de transición: 

• 768x1280 PNG (Orientación vertical, dispositivos táctiles – como el modelo Z10)
• 1280x768 PNG (Orientación horizontal, dispositivos táctiles)
• 720x720 PNG (Dispositivos con teclado – como el modelo Q10)

 
Una vez creados los archivos con las imágenes:

• Importe de cada uno de ellos sobre la carpeta “assets/images” del proyecto. 

• Podrá hacer esto simplemente arrastrando los archivos desde el sistema operativo hacia la carpeta del SDK (asegúrese de tener marcada la opción “Copy Files”.

• Abra el fichero “bar-descriptor.xml” del proyecto y seleccione la pestaña “Application”.

En la sección “Icon”, pulse el botón “Add”.

• Sobre la ventana de diálogo que se abrirá, pulse el botón “Workspace” y busque el archivo que contiene el icono para su proyecto.

• Una vez seleccionado, pulse “OK” para añadirlo.

• Ahora y situado sobre la lista de iconos, seleccione el icono predeterminado y pulse el botón “Remove”. 

• Elimine los iconos predeterminados de la carpeta “assets/images”. Ahora que está utilizando los suyos propios no los necesitará. 

• Realice el mismo proceso con las imágenes de la sección “Splash Screens”.

Aplicaciones para BlackBerry (el "wrapper") (Parte 4 de 8)

Cambiar el nombre visible de la aplicación (App Name)

Para cambiar el nombre que muestra su aplicación:

• Abra el fichero “bar-descriptor.xml” del proyecto y seleccione la pestaña “Application”. 

• Modifique el nombre de la aplicación que podrá ver en el campo “Name”. 

• Si lo desea también puede introducir un texto descriptivo sobre su aplicación en el campo “Description”.

Aplicaciones para BlackBerry (el "wrapper") (Parte 3 de 8)

Cambiar el nombre del paquete

El “Package Name” identifica a su aplicación, y debe ser único entre todas las aplicaciones del dispositivo. Dos aplicaciones con el mismo nombre serían vistos por el dispositivo como si se tratase de una sola, por lo que este es un paso importante. Recomendamos el uso de la sintaxis de nombre de dominio inverso. Por ejemplo com.miempresa.omnis.miaplicacion.

• Abra el fichero “bar-descriptor.xml” del proyecto y seleccione la pestaña “General”. 

• El “Package Name” se muestra en la parte superior de la ventana - modifíquelo por el que desee.

Aplicaciones para BlackBerry (el "wrapper") (Parte 2 de 8)

Editar el fichero “config.xml”

El fichero config.xml contiene la configuración de conexión que utilizará su aplicación para conectarse con el servidor Omnis, además de otras opciones que determinarán su comportamiento.

Busque el archivo “config.xml” situado en la carpeta “assets”, y modifique su contenido según lo necesite para su aplicación, tal y como se describe a continuación:

• MenuIncludeSettings - Muestra o no, el botón “Configuración” o “Settings” en el menú de la aplicación, permitiendo al usuario cambiar la configuración de conexión. 1 para cierto, 0 para falso. 

• MenuIncludeOffline - Permite o no, que el usuario pueda alternar entre los modos “on-line” y “off-line” desde el menú de la aplicación. 1 para cierto, 0 para falso. 

• MenuIncludeAbout - Muestra o no, un botón “Acerca de” en el menú de la aplicación, permitiendo al usuario abrir la pantalla de información indicada. 1 para cierto, 0 para falso.

• SettingsFloatControls - Permite o no, que el “form” pueda cambiar su tamaño/posición, de acuerdo con su propiedad $edgefloat y en relación con la diferencia entre el tamaño de la pantalla del dispositivo y lo consignado en $screensize. 1 para cierto, 0 para falso. Funcionará sólo si el parámetro “SettingsScaleForm” contiene un valor 0. 

• SettingsScaleForm - De ser cierto (1), el “form” será escalado hacia arriba o hacia abajo, hasta ajustarse al tamaño de pantalla del dispositivo del cliente. 1 para cierto, 0 para falso. 

• SettingsAllowHScroll y SettingsAllowVScroll - Si es cierto, se permitirá el desplazamiento horizontal o vertical del “form”. 1 para cierto, 0 para falso. 

• SettingsMaintainAspectRatio - Si el parámetro “SettingsScaleForm” contiene el valor 1, el “form” se escalará de acuerdo a su aspecto original. 1 para cierto, 0 para falso. 

• SettingsOnlineMode - Determina si la aplicación se abrirá en modo “On-line” (1) o en modo “Off-line” (0). 

• TestModeEnabled - Determina si el modo de pruebas (opción Ctrl-M para testar “forms” en dispositivos) estará habilitado para su aplicación. 1 para cierto, 0 para falso. 

• TestModeServerAndPort - Es la ≤direccionip≥:≤puerto≥ usada con la versión Omnis Studio Developer en modo de pruebas. 

• ServerOmnisWebUrl - URL del servidor Omnis o servidor Web. En caso de un servidor Omnis su formato debería ser: http://≤direccionip≥:≤puertoomnis≥ y si se trata de un servidor web, debería ser la raíz de su servidor Web: http://miservidor.com. 

• ServerOnlineFormName - Ruta hacia el fichero .htm correspondiente al “form” inicial, alojado en el servidor “ServerOmnisWebUrl”. Si se esta desarrollando la aplicación, es decir usando el “Omnis Studio Developer”, su formato será /jschtml/miform. Si se está utilizando un servidor web, será el resto de la URL necesaria para llegar hasta el fichero, por ejemplo, /omnisapps/miform. (¡Sin añadir la extensión .htm!)

ServerOmnisWebUrl y ServerOnlineFormName, son necesarios si se usarán “form’s” en modo “On-line”. El resto de parámetros “Server...” se necesitarán sólo si la aplicación también podrá ejecutarse en modo “Off-line”.

• ServerOmnisPlugin - Si se está usando un plugin para establecer la comunicación entre el servidor web y el servidor Omnis, éste parámetro deberá indicar la ruta donde éste se encuentra, partiendo de “ServerOmnisWebUrl”. Por ejemplo /cgi-bin/omnisapi.dll 

• ServerOmnisServer - Indica el camino hacia el Servidor Omnis, su formato es :. Sólo es necesario si se está usando un servidor web con el “Omnis Web Server Plugin” instalado. Si el servidor Omnis, se está ejecutando en la misma máquina que el servidor web, sólo necesitará indicar el puerto en uso. Ejemplo 194.168.1.49:5912 

• ServerOfflineFormName - Nombre del “form” para uso en modo “off-line”. (¡No añada .htm!), Por ejemplo rfOffline 

• ServerAppScafName - Nombre de la aplicación “SCAF”. Deberá coincidir con el nombre de su librería. Por ejemplo: milibreria. (Nota: el nombre es sensible al uso de letras mayúsculas y minúsculas, por lo que le recomendamos usar sólo minúsculas).

Aplicaciones para BlackBerry (el "wrapper") (Parte 1 de 8)

Renombrar el proyecto

Una vez importado el “wrapper” al SDK, es probable que desee asignarle un nuevo nombre, más acorde su aplicación en particular.

La modificación del nombre del proyecto no ejerce efecto alguno sobre la aplicación resultante, pero si le permitirá registrar sus proyectos del modo más apropiado, especialmente si pretende crear diferentes aplicaciones ya que deberá usar proyectos independientes para cada una de ellas.

• Pulse botón-derecho sobre el SDK y seleccione la opción “Rename”. 

• En la ventana de diálogo que se abrirá, introduzca el nuevo nombre del proyecto y pulse “OK”.

Aplicaciones para BlackBerry (requerimientos, instalación y configuración del SDK)

Requerimientos BlackBerry

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

• Windows, OS X o Linux
• El SDK nativo para BlackBerry 10
• $0

 

Configuración del entorno BlackBerry

1) Instalación del SDK nativo BlackBerry 10

Empiece, descargando e instalando el SDK desde la dirección de internet: http://developer.blackberry.com/native/download/.

2) Configuración del “Code Signing Requirements” (requisitos de firma)

Para poder obtener una versión operativa de su aplicación, primero deberá registrarse como desarrollador BlackBerry y obtener su clave de firma para el código. Necesitará hacer uso de la clave para inscribir su SDK con la una firma de código autorizada, y obtener así el certificado que utilizará con su aplicación.

• Entre en http://www.blackberry.com/go/codesigning y rellene el formulario para solicitar claves de firma para BlackBerry 10. Anote el PIN que se le entregará.

Tendrá que esperar unas 2 horas, para recibir los archivos vía correo electrónico.

• Abra el asistente “BlackBerry Deployment Wizard” del SDK. Podrá encontrarlo bajo la opción “BlackBerry” del grupo “Preferences”.

Si está usando un Mac, encontrará las “Preferences” bajo el menú “Momentics”. Si está en Windows o Linux están bajo el menú “Window”

• Ahora sólo necesitará preocuparse por el punto “Signing Registration”.

• Desde este punto, seleccione la opción “Complete the registration process using the 2 CSJ files...”

• En la siguiente página, rellene los campos mediante seleccionar los archivos CSJ, facilitando una contraseña e introduciendo el pin que creó al registrarse para la obtención de los archivos CSJ.

• Una vez hecho esto, se creará un certificado mediante su clave, quedando registrada su firma de código autorizada “code signing authority”.

• Al finalizar se le pedirá que guarde una copia de seguridad (Back Up) de sus claves y certificados. Por favor, asegúrese de hacerlo, ya que esto es lo que le identifica como desarrollador autorizado.

3) Importando el proyecto

• En primer lugar, descargue la última versión del “wrapper” BlackBerry desde el sitio web de Omnis.

Para importar el proyecto deberá abrir el SDK de BlackBerry y hacer lo siguiente:

• Seleccione la opción “Import” del menú “File”.

• Desde el asistente que aparece, seleccione “General ≥ Existing Projects Into Workspace”.

• Desde la ventana siguiente, escoja “select archive file”, localice el archivo zip que descargo con el “wrapper” y pulse “Finish”.

Personalización de aplicaciones BlackBerry

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

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 y pantallas de transición personalizadas
6. Eliminar elementos no requeridos
7. Localizar su aplicación
8. Agregar SCAFs (sólo para aplicaciones “off-line”)

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

Aplicaciones para Android (despliegue) (Parte 3 de 3)

Despliegue de aplicaciones mediante Google Play

ADVERTENCIA: Antes de seguir adelante, deberá leer los requisitos y directrices sobre el despliegue de aplicaciones en Google. TigerLogic no se responsabiliza del contenido o comportamiento de su aplicación.

Para desplegar aplicaciones en Google Play, deberá primero registrarse como desarrollador en: https://play.google.com/apps/publish/signup/. (Deberá disponer de una cuenta Google con la que iniciar la sesión)

Una vez registrado como desarrollador en Google Play:

• Inicie sesión en su https://play.google.com/apps/publish.
• Abra la página “All Applications” y pulse el botón “Add new application”.

Esto iniciará el asistente que le guiará a través del proceso para subir su .apk y la preparación del anuncio en tienda. El orden de ambas acciones es indistinto, pero necesitará completar las dos.

• El asistente le guiará a través de todo lo necesario para que su aplicación este disponible en tienda. Se le mostrará una descripción de cada uno de los campos que a rellenar, así como el tamaño de las imágenes que necesitará subir.
• Podrá guardar sus datos en cualquier momento, de modo que no debe sentirse presionado para tener todo listo antes de empezar este proceso.
• Asegúrese de completar cada una de las secciones que aparecen en la barra lateral para la edición de su aplicación:

Una vez subida la aplicación y proporcionado todas las imágenes e información requerida por Google, su solicitud será marcada como “Ready to publish” (lista para publicar).

Si es el caso que está listo para publicar su aplicación; selecciónela, despliegue el menú “Ready to publish” (preparado para publicar) y escoja “Publish this app” (publicar esta aplicación).
 

A continuación su aplicación será publicada en Google Play (puede transcurrir “varias horas” antes de aparecer en Google Play), lista para poder ser instalada por millones de potenciales usuarios.

Aplicaciones para Android (despliegue) (Parte 2 de 3)

Despliegue manual

El primer paso será hacer disponible el archivo .apk. a los usuarios finales. Le corresponderá a usted decidir cómo hacerlo. Por ejemplo, podría enviar el archivo .apk al dispositivo o disponerlo para su descarga en un sitio web.

Una vez que el usuario tenga el archivo .apk en su dispositivo, deberá:

• Abrir las opciones de “Configuración” del dispositivo y bajo “Seguridad” habilitar la opción para permitir la instalación de aplicaciones de “Fuentes desconocidas”. En los dispositivos Android más recientes, dicha opción puede que se encuentre bajo la entrada “Aplicaciones” del grupo “Configuración”.

• Localice el archivo .apk en su dispositivo y simplemente haga clic sobre él para completar la instalación de la aplicación.

Aplicaciones para Android (despliegue) (Parte 1 de 3)

Despliegue de aplicaciones Android

Una vez que construida su aplicación, estará preparada para su instalación en los diferentes dispositivos. La siguiente nota técnica muestra como realizar esa tarea mediante dos diferentes opciones:

1. Despliegue manual
2. Mediante Google Play

El despliegue manual consiste simplemente en entregar el archivo .apk a los usuarios del modo que se prefiera.

Para hacerlo mediante Google Play o tienda de aplicaciones para Android, es un poco más complicado, pero los beneficios hacen que merezca la pena. Aún así, es de tener en cuenta que no existe un proceso previo de verificación manual de su aplicación por parte de Google, (como sucede en el caso de iOS) por lo que el proceso de implementación es mucho más rápido, que en otras tiendas como iOS o BlackBerry. Tan sólo se requiere de una cuota de inscripción única de $25.

Aplicaciones para Android (el "wrapper") (Parte 11 de 11)

Construcción de una aplicación Android

Una vez personalizado el proyecto para su aplicación, será muy fácil crear la versión de explotación o lanzamiento.

• Abra el fichero “AndroidManifest.xml” de su proyecto, seleccione la pestaña “Manifest” y haga clic sobre el vínculo “Use the Export Wizard”. 

 

 

• Ahora deberá seguir los pasos del asistente, a fin de construir una aplicación firmada a partir de su proyecto Android. 

• La primera vez que lo haga, deberá seleccionar la opción que le permite crear un nuevo “keystore” (almacén de claves) y su clave. En ocasiones posteriores (o versiones de su aplicación) podrá hacer uso del almacén de claves ya existente. Esto es lo que le identifica a usted como desarrollador, de modo que es de suma importancia que mantenga una copia de seguridad de su clave una vez creada. Las posteriores actualizaciones de su aplicación tendrán que ser firmadas con la misma clave. No obstante, podrá hacer uso de la misma clave para múltiples aplicaciones, si así lo desea.

• Si tiene la intención de distribuir su aplicación a través de Google Play, al crear su clave debe asegurarse de fijar su “Validity” con un valor que le permita ir mas allá del 22 de octubre 2033.

Para más información sobre el uso de las formas con Google, consulte la guía: http://developer.android.com/tools/publishing/app-signing.html. Al final, el asistente le proporcionará un archivo .apk firmado. Su aplicación lista para lanzamiento o entrega a los potenciales usuarios.

Aplicaciones para Android (el "wrapper") (Parte 10 de 11)

Agregar bases de datos para funcionamiento “off-line”

Es posible añadir una base de datos SQLite pre-poblada como parte de su aplicación. Podrá ser utilizada desde los diferentes “forms’s” mediante el conector $sqlobject.

• Arrastre el archivo SQLite .db desde el sistema de archivos, sobre la carpeta “assets” de su proyecto en Eclipse. Asegúrese de seleccionar la opción “Copy Files”.

• Edite el archivo “config.xml” de su proyecto y modifique la propiedad ≤ServerLocalDatabaseName≥ para incluir el nombre de su base de datos local (incluyendo la extensión .db)

Tenga en cuenta que está creando una aplicación para un dispositivo móvil, por lo que no deberá pensar en usar bases de datos locales muy grandes. Para mantener sus datos seguros, la base de datos es compilada formando parte del “apk”. Tenga en cuenta que si va a subir su aplicación a la Play Store, el .apk final para Android, deberá ocupar menos de 50 MB, por lo que deberá pensar en una base de datos local pequeña.

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.

Editar la ventana “Acerca de...”

Si el parámetro correspondiente ha sido habilitado en el “config.xml”, una opción “About” o “Acerca de…” será mostrada sobre el menú de su aplicación. Permitiendo la apertura de una nueva pantalla con una página html configurable.

Para habilitar (o des-habilitar) la opción de menú “About”, edite el archivo “config.xml” del proyecto y cambie el valor de ≤MenuIncludeAbout≥ a 1 (o a 0 para desactivarlo).

Abra la carpeta “assets/about” de su proyecto. Podrá observar que contiene un archivo denominado “about.htm”, se trata de la página html que se cargará al abrirse la pantalla “Acerca de”. Podrá editar este fichero del modo que prefiera, agregando incluso todos los recursos que sean necesarios en la carpeta “about”. 

 

Aplicaciones para Android (el "wrapper") (Parte 9 de 11)

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

Si su aplicación va a permitir su uso en modo “off-line”, tendrá que decidir si incluirá o no los ficheros SCAFs dentro de la aplicación. Tenga en cuenta, que si lo hace su tamaño crecerá, aunque, (eso si) permitirá su ejecución inmediata, es decir, sin necesidad de conexión a un servidor para su descarga o primera actualización.

Para incluir los ficheros SCAFs en su aplicación, deberá hacer lo siguiente:
 

• Localice la carpeta “html/sc” en el directorio de instalación Omnis.

• En un sistema Windows, la encontrará bajo el directorio “AppData”. Por ejemplo en: C:\Users\\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 sobre el directorio “assets” de su proyecto.

• La forma más fácil de hacer esto es arrastrarlos desde el explorador de archivos sobre el proyecto en Eclipse. Asegúrese de tener seleccionada la opción “Copy Files”.

Aplicaciones para Android (el "wrapper") (Parte 8 de 11)

Localizar su aplicación

Si desea traducir el texto utilizado por la aplicación o “wrapper”, podrá hacerlo siguiendo las instrucciones que describimos a continuación. Cuando el dispositivo del usuario esté configurado para su uso con uno de los idiomas soportados, la aplicación cargará las cadenas de texto introducidas para el idioma en cuestión.

• Busque la carpeta “res/values” del proyecto. Esta contiene el archivo “strings.xml”, que a su vez contiene todas las cadenas de texto predeterminadas para su uso con la aplicación. 

 

• En esta carpeta podrá crear versiones concretas para cada idioma/región (según su correspondiente archivo “strings.xml”), el cual será usado según las preferencias de idioma/región consignadas en el dispositivo. Para ello, será necesario crear nuevas carpetas “values”, con sus correspondientes “qualifiers” de lenguaje/región.

 

• Cree una nueva carpeta bajo el directorio “res”, nombrela como “values-≤LanguageCode≥” o “values-≤LanguageCode≥-r≤RegionCode≥” en el caso de incluir una región. Estos “qualifiers” no son sensibles al uso de letras mayúsculas y minúsculas. Ejemplo: values-en o values-en-rGB. 

 

• Copie el archivo “strings.xml” de la carpeta “values” por defecto, sobre la nueva carpeta.

• Edite el archivo “strings.xml” de la nueva carpeta y modifique sus valores de para traducirlos. Si no desea traducir todas las cadenas, puede optar por eliminarlos del archivo strings.xml de ese idioma en particular, ya que en el caso de no encontrarse dentro del archivo “strings.xml” traducido, se usará el predeterminado.