Instalador personalizado de Velneo vClient

Velneo ofrece un servicio de generación de un Velneo vClient personalizado para Windows (64 bits) y Android.

Mediante un formulario de solicitud web se indican los textos, su configuración y las imágenes que se usarán.

El resultado para Android será un fichero apk y un fichero aab con la personalización indicada. Para Windows el resultado es un fichero ejecutable que instalará Velneo vClient y generará una ventana de conexión personalizada.

En versiones anteriores a Velneo 30, se generan dos apks, uno para arquitecturas de 32 bits y otro para 64 bits, y no se genera fichero aab.

Por cada instalador que crees recibirás un correo con el enlace para su su descarga. Si bien ese enlace es temporal podrás encontrar todos los instaladores que has creado en la página de Mis instaladores o en el HOME de tu Velneo vServer Cloud desde el que lo hayas generado, al que puedes acceder vía sftp para descargarlos.

Para acceder al servicio, puedes seguir el enlace siguiente:

https://velneo.es/mi-velneo/instaladores

Para usar este servicio, debes disponer de un Velneo vServer Cloud. Te recomendamos uses el de la cuenta asociada a tu suscripción.

En esta página tenemos todos nuestros instaladores creados y contaremos con las siguientes opciones:

Crear nuevo instalador

Si queremos crear un nuevo instalador pulsamos esta opción y nos mostrará un formulario con la información necesaria. Ver el punto Formulario nuevo Instalador.

Toda la información necesaria para generar los instaladores se guarda en el directorio del Velneo vServer en Cloud asociado al email logueado (directorio $HOME/installers). De hecho, una vez generados los binarios instaladores (.exe en el caso de windows y .apk en el caso de Android) podrás encontrarlos también en esa carpeta (organizadas por nombreInstalador/Version).

No manipules esas carpetas de forma manual. Usar para ello la página de Mis instaladores.

Nueva versión

Si ya disponemos de un instalador creado y lo que queremos es generar una nueva versión, usaremos esta opción.

Nos preguntará si queremos duplicar la última versión disponible de este instalador o crearla desde cero. En el primer caso, en el siguiente formulario nos solicitará la nueva versión de nuestra aplicación y la versión de Velneo a usar. En el segundo caso nos mostrará el punto Formulario nuevo Instalador.

Eliminar seleccionados

Desde esta opción podemos eliminar definitivamente (tanto la configuración como los binarios creados en nuestro $HOME de Velneo Cloud) de nuestra lista de instaladores. Este paso es irreversible, así que úsalo con cuidado.

Formulario nuevo instalador

Si pulsamos la opción Crear nuevo Instalador, debemos cumplimentar la información siguiente:

Nombre único del instalador

Es el nombre del instalador que estamos creando y debe tener el formato conocido como DNS inversa, por ejemplo, com.tuweb.app.

Si vas a crear el instalador para Android, este es el identificador único que tendrá tu aplicación dentro del universo Android, y está relacionado con la firma de aplicaciones Android, así que en ese caso es muy importante que utilices tu dominio si lo tienes y un nombre descriptivo de tu app (Usar: erp, gestion, facturas, etc. No usar: app, aplicacion, etc).

Versión

Indica qué versión de Velneo vClient se usará en este instalador. Podremos seleccionar, o bien la versión en curso, o bien la versión anterior.

Este dato es obligatorio.

Plataforma

Aquí puedes seleccionar si quieres crear el instalador para Windows 64, Android o ambos.

Este dato es obligatorio.

Nombre del producto

Nombre de nuestra aplicación. Este nombre será mostrado en distintas pantallas del asistente de instalación. Este dato es obligatorio.

Versión

La versión que va a tener este instalador. Debe tener el formato XX.XX.XX (el último grupo es opcional) y debe ser distinta y mayor que el resto de versiones de este instalador.

Si vas a crear el instalador para Android, este dato junto con el Nombre único del instalador es el que usará Google para saber si esta versión es algo nuevo o una actualización a una versión anterior ya publicada/instalada.

Este dato es obligatorio.

Nombre de la empresa

Nombre de nuestra empresa. Se mostrará durante en asistente de instalación. Este campo es obligatorio.

Este dato es obligatorio.

Web de la empresa

Si queremos que en el asistente del instalador que se genera se muestre nuestra página web, podremos indicarla aquí.

Este dato es opcional.

Host de la Vrl de conexión

Si queremos que el vClient se conecte con una vrl concreta, la indicaremos en este parámetro. En caso contrario, lo dejaremos vacío.

Si en este parámetro especificamos el carácter ? el usuario final podrá editar la VRL en la ventana de conexión y guardarla.

Preguntar por usuario y password

En este parámetro indicaremos cómo queremos que se haga la petición de usuario y contraseña en la ventana de conexión personalizada. Disponemos de las opciones siguientes:

Pedir usuario y contraseña sólo la primera vez

El usuario y/o la contraseña las pedirá la primera vez que ejecutemos Velneo vClient y los guardará. En las siguientes ejecuciones se conectará directamente al servidor indicado con las credenciales almacenadas.

Usuario fijo, solicitar contraseña siempre

El usuario será fijo y se pedirá la contraseña cada vez que se ejecute la ventana de conexión personalizada.

Si elegimos esta opción, es obligatorio entonces cumplimentar también parámetros host de la Vrl de conexión (o bien una Vrl o bien el carácter "?") y usuario.

Pedir usuario y contraseña siempre

Se pedirá siempre el usuario y la contraseña cuando se ejecute la ventana de conexión personalizada.

Si elegimos esta opción, es obligatorio entonces cumplimentar también el parámetro host de la Vrl de conexión (o bien una Vrl o bien el carácter "?") .

Usuario de la vrl de conexión

Si queremos crear un acceso directo para un usuario concreto, entonces deberíamos especificar éste los dos parámetros host de la Vrl de conexión (o bien una Vrl o bien el carácter "?") y, en la propiedad preguntar por usuario y password seleccionar el valor pedir usuario y contraseña sólo la primera vez o el valor usuario fijo, solicitar contraseña siempre.

Password de la vrl de conexión

Si queremos crear un acceso directo para un usuario concreto con una contraseña predefinida, entonces deberíamos especificar, además de este parámetro, y también los parámetros host de la Vrl de conexión (o bien una Vrl o bien el carácter "?") y usuario de la Vrl de conexión.

En caso contrario, lo dejaremos vacío.

A modo de resumen, aquí tienes una tabla con los distintos modos de host, usuario, contraseña casos de uso:

Modo	Configuración	Funcionalidad	Caso de uso
Sin VRL	Pide usuario y contraseña la primera vez	Modo multiservidor: Permite añadir VRL con nombre, usuario y contraseña. Permite modificar los datos en todo momento. Pide usuario y contraseña sólo en la primera conexión y la guarda.	1) Personalizado para mi producto para muchos clientes. 2) Corporativo para un cliente concreto.
Con VRL	Pide usuario y contraseña la primera vez	El dominio del servidor viene prefijado. Pide el usuario y la contraseña sólo en la primera conexión y la guarda. Permite modificar los datos en caso de fallo de conexión.	1) Para un servidor concreto de producción. 2) Para demos en un cliente concreto.
Con VRL	Usuario fijo, pide contraseña	El dominio del servidor viene prefijado. El usuario viene prefijado. Pide la contraseña en cada conexión.	1) Para servidores de demo. 2) Para una aplicación con login anónimo que pida el usuario al entrar. 3) Para un puesto con un usuario concreto.
Con VRL	Pide usuario y contraseña siempre	El dominio del servidor viene prefijado. Recuerda el usuario usado con éxito en la conexión anterior. Pide la contraseña en cada conexión.	Corporativo para un cliente en un puesto que usan múltiples usuarios.
Con VRL = ?	Pide usuario y contraseña la primera vez	El dominio ha de indicarse en la primera ejecución y se puede modificar. Pide el usuario y la contraseña sólo en la primera conexión y la guarda. Permite modificar los datos en caso de fallo de conexión.	Personalizado para mi producto para cualquier servidor con un usuario que se define en el primer login.
Con VRL = ?	Usuario fijo, pide contraseña	El dominio ha de indicarse en la primera ejecución y se puede modificar. El usuario viene prefijado. Pide la contraseña en cada conexión.	Personalizado para mi producto para cualquier servidor con un usuario anónimo o un puesto concreto.
Con VRL = ?	Pide usuario y contraseña siempre	El dominio ha de indicarse en la primera ejecución y se puede modificar. Recuerda el usuario usado con éxito en la conexión anterior. Pide la contraseña en cada conexión.	Personalizado para mi producto para cualquier servidor en un puesto que usan múltiples usuarios.

Licencia del producto

Sólo para Windows.

En este parámetro escribiremos el texto que tengamos de la licencia de uso del producto. Ha de ser un texto plano. Busca por Internet cualquier texto estándar de licencia de uso de software y pega allí su contenido.

Este parámetro es obligatorio.

Icono

Icono del instalador. Se recomienda usar una imagen de tipo png de 512x512 píxels y que no supere los 512 Kb de tamaño. Este parámetro es obligatorio.

Logo

Sólo para Windows.

Logotipo de nuestra aplicación. Se usará para mostrar en el asistente de instalación del instalador que se genera.

Este parámetro es obligatorio.

Color principal

La ventana del login personalizada que se generará con este instalador tendrá un color predominante. Si no especificamos ninguno, será el negro.

Los textos de la ventana del login son de color blanco, así que debemos asegurarnos de elegir un color de fondo sobre el que se puedan leer dichos textos.

Una vez cumplimentado todo, pulsaremos el botón solicitar. Si hay algo incorrecto, se permanecerá en la página y se llevará el foco a la propiedad que falta o esté incorrecta:

Si todo está correcto, veremos al final de la página el mensaje siguiente:

En unos minutos recibirás en tu email la url de descarga del instalador.

En el caso de Android el tiempo puede ser algo mayor, hasta varias horas.

Una vez tengamos nuestro instalador te mostramos cómo distribuirlo en Android y en Windows.

Firma de aplicaciones Android

Este servicio automáticamente firma tu instalador Android generando una firma asociada a este instalador (al nombre único). Cuando se crea el instalador por primera vez para la plataforma Android, se genera la firma asociada.

Esa firma se guarda en tu directorio $HOME de tu Velneo vServer Cloud, dentro de un directorio llamado certs.

Android utiliza el nombre único de instalador (conocido como package name) y la firma usada para firmar la aplicación como seña única de identidad para una aplicación dentro del universo Android. Esto implica que si la versión 1.1 la firmamos con una firma diferente de la que usamos para firmar la 1.0, Android las va a interpretar como aplicaciones diferentes y no como una actualización.

A partir de Velneo 30 se genera también una firma de subida, necesaria solo si vas a publicar tu aplicación en Google Play. En ese caso tendrás que descargar dicho certificado vía sftp para poderlo usar en el proceso de subida a Google Play.

Es importante no manipular manualmente esos ficheros para garantizar la estabilidad del sistema.

Si ya has subido un instalador a Google Play utilizando la firma autogenerada que te proporciona Velneo, no elimines la instalación ya que si alguna vez quieres crear una actualización para Google Play, Google no la va a tratar como tal, porque la firma ya no coincidirá.

¿Puedo usar mi propia firma?

Si quieres subir la aplicación a Google Play con tu propia firma, puedes hacerlo, procediendo antes a refirmar la aplicación. Necesitas instalar algunas herramientas. Veamos los pasos:

Necesitas crear la firma (se almacena en un key store). Para ello debes usar la herramienta keytool que viene con Java. Una vez instalada debes usar un comando similar a este:

keytool -genkey -v -keystore my-release-key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias my-alias

Keytool se encuentra en el directorio bin de tu JDK (Java Development Kit).

Es muy importante que guardes este almacén de firmas generado y su contraseña en lugar seguro. Si los pierdes no podrás hacer actualizaciones de tus aplicaciones en Google Play.

Ahora que ya tenemos nuestra firma, nos queda el paso de refirmar nuestro apk (que debemos haber descargado a local). Para ello tenemos que instalar la versión 24.0.3 o superior de Android SDK Build Tools. Las siguientes instrucciones están hechas con la versión 25.0.2. Sustituye esa versión por la tuya. Para refirmar debemos usar el siguiente comando:

android-sdk\build-tools\25.0.2\apksigner sign --ks my-release-key.jks miinstalador.apk

Ahora ya tenemos nuestro instalador firmado con nuestra firma y podemos proceder a distribuir nuestra aplicación.

Cómo distribuir aplicaciones Android

Tenemos dos vías para distribuir nuestra aplicación:

1. Vía instalación manual: subimos el apk a algún ftp o similar y enviamos el enlace a nuestros clientes. Esta es la forma más sencilla para nosotros, pero puede ser algo más complicada para el cliente final. El cliente debe habilitar en su Android la opción de "Permitir instalar desde orígenes desconocidos" y además perdemos la ventaja de las actualizaciones automáticas. Cada vez que haya una nueva revisión de nuestra app los usuarios tendrían que repetir la misma operación.

2. Vía Google Play: es la forma más elegante y más fácil para el usuario final. Además ya está habituado a este sistema. Para ello necesitamos una cuenta en Google y darnos de alta en Google Play Developer Console y hacer el pago único que nos exige Google. A partir de ahí seguiremos los pasos para subir nuestra aplicación en formato aab.

Firma de aplicaciones Windows

Para firmar aplicaciones Windows necesitamos dos cosas:

1. Una aplicación de Microsoft.

2. Un certificado emitido por una empresa certificadora root.

La aplicación de Microsoft se llama Signtool y forma parte del Windows SDK que se puede descargar en http://go.microsoft.com/fwlink/p/?linkid=84091.

El certificado podemos adquirirlo por ejemplo en Thawte. Tienes que tener en cuenta que si tienes previsto que tu instalación se instale en Windows 8.1 o anteriores, deberás firmar tu aplicación dos veces (con sha1 y sha256).

Una vez descargada nuestra firma en formato .pfx, procedemos con la o las firmas.

Para firmar nuestro instalador, que llamaremos instalador.exe, con SHA1 hacemos:

c:/Program Files (x86)/Windows Kits/10/bin/x64/signtool.exe sign /d "tuEmpresa" /f certificado.pfx /p "password" /t http://timestamp.verisign.com/scripts/timstamp.dll/v instalador.exe

Para firmarlo con SHA256 hacemos:

c:/Program Files (x86)/Windows Kits/10/bin/x64/signtool.exe sign /fd sha256 /d "tuEmpresa" /f certificado.pfx /p "password" /as /tr http://sha256timestamp.ws.symantec.com/sha256/timestamp /td sha256 /v instalador.exe

En este momento ya tendríamos nuestro instalador firmado y cuando se instala no emite alerta de "Editor desconocido".

Puedes encontrar mucha más información sobre la firma de aplicaciones en Windows en las páginas de Microsoft.

Cómo distribuir aplicaciones Windows

Las aplicaciones en windows son instaladores en su versión 64 bits. Esto implica que sólo son válidos para sistemas operativos de esa arquitectura.

Los puedes enviar por correo electrónico a tus clientes o subirlo a algún ftp y distribuirlo desde allí.

Cuando el cliente lo ejecuta le puede aparecer, depende del sistema operativo., una alerta de seguridad indicando que se trata de un "Editor desconocido". Si pulsamos el enlace "Más información" ya nos permite instalarlo. Para eliminar ese mensaje tendrías que firmar ese instalador con tu propia firma. Te mostramos como puedes firmar tu aplicación de Windows.