26 marzo 2015

Omnis Developer Partner Program (ODPP)

Algo más que un plan de soporte y actualizaciones

Pertenecer al ODPP (Omnis Developer Partner Program) es seguramente la opción más beneficiosa y rentable para cualquier desarrollador Omnis Studio, ya sea a título individual o formando parte de un equipo de varios desarrolladores.

Pero (tal vez) hemos pasado por alto algunos de los beneficios que se obtienen al pertenecer al prestigioso club ODPP, de hecho todo lo concerniente a “Aula Omnis”, nace del ODPP, ya que su contenido, se debe en gran manera al hecho de que la mayoría de sus miembros pertenecen o han perteneció a dicho club.

Repasemos algunos de sus beneficios:

  • Licencias Profesional de "Omnis Studio SDK” gratuitas.
  • Actualizaciones mayores de versión y revisiones del SDK gratuitas.
  • Revisiones (actualizaciones menores) gratuitas sobre licencias ya implementadas (runtime) de Omnis Studio.
  • Significativos descuentos a la hora de adquirir nuevas licencias de implementación. (runtime)
  • Completo soporte técnico personalizado en castellano, italiano, alemán e ingles, éste último disponible por teléfono, correo electrónico y fax.
  • Importantes descuentos en productos, servicios y formación.
  • Cursos introductorios de formación en castellano totalmente gratuitos.
  • Acceso en línea “eBug” con el que informar fallos y conocer el estado de sus comunicados.
  • Inclusión en los programas beta de Omnis Studio, probando y opinando sobre futuras mejoras.
  • Acceso a un área de descarga exclusivo, desde donde podrá obtener las últimas versiones de componentes, bibliotecas y otros archivos no disponibles hasta anunciarse su lanzamiento.

Deseamos animar a todos los lectores de éste “blog” a inscribirse en el ODPP y si es el caso que usted estuvo inscrito en el pasado, pero no en la actualidad, decirle que se está realizando un gran esfuerzo por ofrecer las ventajas del ODPP a la comunidad de habla castellana, por lo que será un buen momento para que reconsidere su postura e ingresar de nuevo en éste prestigioso club que conforma el ODPP.

NOTA: Actualizaciones mayores de versión, es decir las que contienen nuevas y significativas funcionalidades o características, serán a menudo indicadas mediante el cambio del primer guarismo de la versión (por ejemplo de Omnis Studio 4.3 a Omnis Studio 5.0). El ODPP incluye las concernientes al “SDK” además de importantes descuentos sobre todo tipo de licencias, así como las actualizaciones secundarias que suelen obedecer a corrección de fallos, mejoras menos significativas y nuevas características.

16 marzo 2015

Nuevo en Aula Omnis

SOPORTE TÉCNICO Y CURSOS

 GRATUITOS EN CASTELLANO

 

WWW.OMNISSTUDIO.ES 

 

13 marzo 2015

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”.
 

11 marzo 2015

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.

10 marzo 2015

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).

09 marzo 2015

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”.

06 marzo 2015

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.


05 marzo 2015

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).

02 marzo 2015

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”.