Instalador personalizado de Velneo vClient
Última actualización
¿Te fue útil?
Última actualización
¿Te fue útil?
Velneo ofrece un servicio de generación de un 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.
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 o en el HOME de tu Velneo vServer Cloud desde el que lo hayas generado, al que puedes acceder vía para descargarlos.
Para acceder al servicio, puedes seguir el enlace siguiente:
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:
Si queremos crear un nuevo instalador pulsamos esta opción y nos mostrará un formulario con la información necesaria. Ver el punto .
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 .
Si ya disponemos de un instalador creado y lo que queremos es generar una nueva versión, usaremos esta opción.
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.
Si pulsamos la opción Crear nuevo Instalador, debemos cumplimentar la información siguiente:
Es el nombre del instalador que estamos creando y debe tener el formato conocido como DNS inversa, por ejemplo, com.tuweb.app.
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.
Aquí puedes seleccionar si quieres crear el instalador para Windows 64, Android o ambos.
Este dato es obligatorio.
Nombre de nuestra aplicación. Este nombre será mostrado en distintas pantallas del asistente de instalación. Este dato es obligatorio.
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.
Este dato es obligatorio.
Nombre de nuestra empresa. Se mostrará durante en asistente de instalación. Este campo es obligatorio.
Este dato es obligatorio.
Si queremos que en el asistente del instalador que se genera se muestre nuestra página web, podremos indicarla aquí.
Este dato es opcional.
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.
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:
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.
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.
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 "?") .
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.
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.
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 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.
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.
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.
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.
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á.
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:
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.
Tenemos dos vías para distribuir nuestra aplicación:
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.
Para firmar aplicaciones Windows necesitamos dos cosas:
Una aplicación de Microsoft.
Un certificado emitido por una empresa certificadora root.
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:
Para firmarlo con SHA256 hacemos:
En este momento ya tendríamos nuestro instalador firmado y cuando se instala no emite alerta de "Editor desconocido".
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.
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 .
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 , 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).
Una vez tengamos nuestro instalador te mostramos cómo distribuirlo en y en .
Necesitas crear la firma (se almacena en un key store). Para ello debes usar la herramienta que viene con Java. Una vez instalada debes usar un comando similar a este:
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 . 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:
Ahora ya tenemos nuestro instalador firmado con nuestra firma y podemos proceder a .
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 y hacer el pago único que nos exige Google. A partir de ahí seguiremos los pasos para subir nuestra aplicación en formato aab.
La aplicación de Microsoft se llama y forma parte del Windows SDK que se puede descargar en .
El certificado podemos adquirirlo por ejemplo en . 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).
Puedes encontrar mucha más información sobre la firma de aplicaciones en Windows en las .
