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.

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

Eliminar elementos no requeridos

Cada aplicación Android 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 Google Play, ya que cuando el usuario descarga/instala la aplicación, puede ver los permisos a los 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 “AndroidManifest.xml” de su proyecto, y seleccione la pestaña “Permissions”.
   
• Dese aquí podrá agregar o quitar permisos para su aplicación.
   
• Por defecto, están activados todos los permisos posibles para una aplicación Omnis.
   
• Elimine los permisos no necesarios para su aplicación, mediante la selección del mismo y la pulsación el botón “Remove”.

PERMISOS OBLIGATORIOS:

• INTERNET

Todos los demás podrán ser eliminados de su aplicación, si es el caso que no los necesita, tales permisos opcionales, son los siguientes:
 

• CAMERA - necesario si se hará uso de lector de código de barras (kJSDeviceActionGetBarcode).
   
• READ_CONTACTS – necesario si se activa kJSDeviceActionGetContacts para acceder a la lista de contactos.
   
• ACCESS_FINE_LOCATION - proporciona un ajuste fino (se usa el sensor GPS) sobre los datos de ubicación kJSDeviceActionGetGps.
   
• ACCESS_COARSE_LOCATION - proporciona un ajuste parcial (se usa la red) sobre los datos de ubicación kJSDeviceActionGetGps.
   
• WRITE_EXTERNAL_STORAGE - necesario si se desea obtener imágenes desde la cámara (kJSDeviceActionTakePhoto).
   
• READ_EXTERNAL_STORAGE - necesario si se desea obtener imágenes desde la cámara o de entre las ya guardadas en el dispositivo (kJSDeviceActionTakePhoto o kJSDeviceActionGetImage).

Sólo en versiones posteriores a Android 4.3
 

• CALL_PHONE – permite hacer llamadas telefónicas desde la aplicación (kJSDeviceActionMakeCall).
   
• VIBRATE - permite hacer que el dispositivo vibre (kJSDeviceActionVibrate).

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

Añadir pantallas de transición personalizadas

El “wrapper” para Android muestra una pantalla de bienvenida mientras se está cargando (o actualizando) el “form”. La imagen mostrada se denomina “splashscreen” y está localizada en el grupo de carpetas “res/drawable-...dpi”. La extensión del fichero deberá ser .png y tener el formato 9-Patch (.9.png).

Una imagen “9-patch” es un png con marcadores especiales que controlan cómo deberá escalarse la imagen. Esto evitará la deformación no deseada de la imagen. Es el formato que nosotros recomendamos usar para pantallas de inicio en Android. Podrá hallar más información en http://developer.android.com/tools/help/draw9patch.html.

Observe que el proyecto sólo contiene imágenes “splash” en dos de las carpetas “dpi”. Esto será suficiente (especialmente si se usan imágenes “9-patch”) ya que el dispositivo hará uso de la imagen que mejor se ajuste a su “dpi”. Se eligió ésta opción porque ofrece el mejor rendimiento para la aplicación/proyecto.

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

Añadir iconos personalizados

Dado que los dispositivos Android disponen de una gran variedad de tamaños para sus pantallas, se hace necesario la creación de diferentes resoluciones para sus iconos. El sistema operativo usará el icono más apropiado para el dispositivo en uso.

• Despliegue el directorio “res” del proyecto y observe el grupo de carpetas “drawable-...dpi”.

• Cada una de estas carpetas contiene un fichero “icon.png”, con el tamaño adecuado para los dispositivos clasificados como parte de ese grupo dpi.

• Edite o sustituya estos ficheros, asegurándose de que sean del mismo tamaño y nombre que el original.

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

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

Para cambiar el nombre que muestra su aplicación:

• Abra el fichero del proyecto denominado “res/values/strings.xml”, y seleccione la entrada “app_name”.
   
• Cambie el contenido del campo “Value” por el que desee.

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

Cambiar el nombre del paquete (Package Name)

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 vistas por el dispositivo como si se tratase de una sola, por lo que éste, es un paso muy importante. Recomendamos el uso de la sintaxis de nombre de dominio inverso. Por ejemplo: com.miempresa.omnis.miaplicacion.

• Haga clic derecho, sobre el nivel superior del proyecto en Eclipse y seleccione la opción “Android Tools ≥ Rename Application Package”.

• Cambie el valor de “Package Name” por el que desee.

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

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:

• AppTitle - Permite o no, que se muestre la barra de título (Android < 3.0) o la barra de acción (Android 3.0 +). 1 para cierto, 0 para falso.

• AppStandardMenu - Permite o no al usuario, mostrar el menú de aplicación mientras está en uso. 1 para cierto, 0 para falso.

 

• AppTimeout – En caso de que la aplicación sea enviada a un segundo plano, específica el número de mili-segundos de espera antes de matarla, liberando así, la conexión con el servidor. Si se especifica un número negativo, significa que no habrá tiempo de espera (aunque el sistema podría matar la aplicación, si los recursos usados por la misma son requeridos).

Tenga en cuenta que si se está haciendo uso de algunas funciones del dispositivo (como por ejemplo, la cámara, el SMS, etc.), la aplicación va a será enviada a un segundo plano. De modo que deberá tener cuidado y no establecer un valor demasiado bajo, a fin de que la aplicación no sea cancelada mientras (por ejemplo) el usuario está tomando una foto.

• 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 ≤direccionip≥:≤puerto≥. 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 Android (el "wrapper") (Parte 1 de 11)

Renombrar el proyecto

Una vez importado el “wrapper” a Eclipse, es probable que desee asignarle un nombre nuevo y más acorde su aplicación 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 proyecto en Eclipse y seleccione la opción “Refactor > Rename”. 

• En la ventana de diálogo que se abrirá, introduzca el nuevo nombre del proyecto, asegurándose de marcar la opción “Update references” y pulse “OK”.