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 Velneo vClient Personalizado para Windows (64 bits) y Android.
Mediante un formulario de solicitud web se indican los textos e imágenes que se usarán y tras las solicitud se recibirá en un correo la descarga del instalador personalizado.
Para acceder al servicio, puedes seguir el enlace siguiente:
Nota
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).
Aviso
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á únicamente la nueva versión. En el segundo caso nos mostrará el punto .
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.
Importante
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.
Importante
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 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 queremos forzar un nombre de usuario concreto, lo indicaremos en este parámetro. En caso contrario, lo dejaremos vacío.
Si queremos crear un acceso directo para un usuario concreto, y que no tenga que especificar contraseña, entonces deberíamos especificar éste y los dos parámetros anteriores. En caso contrario, también lo dejaremos vacío.
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.
Logo 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.
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.
Aviso
En el caso de Android el tiempo puede ser algo mayor, hasta varias horas.
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.
Aviso
Es importante no manipular manualmente esos ficheros para garantizar la estabilidad del sistema.
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).
Aviso
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 nuestro apk:
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.
No manipules esas carpetas de forma manual. Usar para ello la página de .
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 apk.
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 .
