UpgradeOnline v1.0.3

Descripción y requisitos Sitaxis de la llamada Shell Sintaxis del fichero de configuración Ejemplo update.txt Descarga del programa (Freware)

El fichero contiene en cada línea una instrucción, si esta instrucción contiene vários parámetros se separarán con el carácter | (AltGr+1).

Las instrucciones siempre se ejecutan en el orden en que están especificadas en el fichero de configuración de actualización.

Para poner comentarios dentro del fichero de configuraciones debemos hacerlo anteponiendo el carácter # a la línea.

En ciertos parámetros de algunas instrucciones deberemos especificar rutas del sistema, para ello podemos utilizar las variables $AppPath, $WinPath y $WinSysPath.

El procedimiento normal es que el programa descargue todos los contenidos necesarios para realizar la actualización en archivos temporales y al finalizar la descarga inicia el proceso de actualización. Si delante de cualquier comando, con la escepción de ADD y UPDATE se añade el símbolo ! el comando se ejecuta antes de iniciar el proceso de descarga.

La primera línea sin comentario del fichero de configuración siempre debe ser:
Versión de upgrade online|URL donde se encuentra disponible esta versión de UpgradeOnline

Ejemplo:
1.0.2|http://www.muve.net/UpgradeOnline.exe

La segunda línea sin comentario del fichero de configuración siempre debe ser:
NAME|Título o nombre de la aplicación sobre la que contiene información el fichero

Ejemplo:
NAME|NombrePrograma v1.3.0

A partir de este punto, las instrucciones que puede contener el fichero de configuraciones de actualización son: VERSION, ADD, UPDATE, DELETE, MSG, EXECUTE, KILL, REGISTER, UNREGISTER, SLEEP o END. Vamos a explicarlos por separado a continuación.

VERSION
Descripción: Define el inicio de las actuaciones a realizar para actualizar, si la versión de la aplicación que se quiere actualizar coincide con la regla especificada por esta instrucción. Esta línea debe aparecer siempre antes de cualquier otra instrucción ADD, UPDATE, DELETE, MSG, EXECUTE, KILL, REGISTER, UNREGISTER, SLEEP o END.

Nota: Si hay varios comandos VERSION se ejecutarán todos y en el orden de aparición en el archivo de actualización. Si se encuentra un comando END no se parsearan los comandos siguientes.

Formato: VERSION|<,>,<=,>= o =|Versión a actualizar con las instrucciones que siguen

Ejemplo: VERSION|<|1.2.4

Este ejemplo provocaría que las instrucciones que aparecieran a continuación de esta línea se ejecutaran para las versiones de la aplicación anteriores a la 1.2.4

ADD
Descripción: Añade un fichero en el directorio y con el nombre especificado, descargándolo de la URL indicada. Si el directorio no existe se crea. Si el fichero existe se hace una copia .bak y se sobreescribe con el especificado.

Formato: ADD|Ruta local|URL de donde descargar el fichero

Ejemplo: ADD|$AppPath\datos\Datos.dat|http://www.muve.net/datos130.dat

Este ejemplo provocaría que se añadiera el fichero Datos.dat dentro del directorio datos de la aplicación. El contenido de este fichero seria el mismo que el del fichero de la URL http://www.muve.net/datos130.dat.

UPDATE
Descripción: Modifica un fichero en el directorio y con el nombre especificado, descargándolo de la URL indicada. Si el directorio no existe se crea. Si el fichero no existe se crea.

Formato: UPDATE|Ruta local|URL de donde descargar el fichero

Ejemplo: UPDATE|$AppPath\datos\Datos.dat|http://www.muve.net/datos130.dat

Este ejemplo provocaría que se modificara el fichero Datos.dat dentro del directorio datos de la aplicación. El contenido de este fichero seria el mismo que el del fichero de la URL http://www.muve.net/datos130.dat.

DELETE
Descripción: Elimina un fichero. Si el fichero no existe no hace nada.

Formato: DELETE|Ruta local

Ejemplo: DELETE|$AppPath\datos\Datos.dat

Este ejemplo provocaría que se eliminara el fichero Datos.dat almacenado dentro del directorio datos de la aplicación.

MSG
Descripción: Muestra un mensaje de alerta.

Formato: MSG|Mensaje|Icono: EXCLAMATION, INFORMATION, CRITICAL o NOTHING

Ejemplo: MSG|Debes descargar la nueva versión disponible en la web e instalarla.|INFORMATION

Este ejemplo Mostraria una alerta con el icono de información por defecto de Windows y el texto 'Debes descargar la nueva versión disponible en la web e instalarla.'.

EXECUTE
Descripción: Ejecuta una aplicación. Es interesante la possibilidad de poder hacer un ADD de un ejecutable y a continuación ejecutarlo para realizar procedimientos que no contemple UpgradeOnline.

Formato: EXECUTE|Ruta de la Aplicación|WAIT o NOWAIT|Modo de ejecución: HIDE, NORMAL, NORMALFOCUS, MIN, MINFOCUS, MAX

Ejemplo: EXECUTE|$WinPath\notepad.exe|WAIT|MAX

Este ejemplo provocaría la ejecución del bloc de notas de Windows maximizado parando la instalación hasta que el usuario lo cerrase.

END
Descripción: Finaliza la ejecución del fichero de actualización aunque a continuación haya más comandos a ejecutar.

Formato: END

Ejemplo: END

Este ejemplo provocaría el fin de la ejecución de la actualización en el punto que se encontrase.

SLEEP
Descripción: Para la ejecución de UpgradeOnline durante el número de milisegundos indicado.

Formato: SLEEP|Milisegundos de espera

Ejemplo: SLEEP|2000

Este ejemplo provocaría que el proceso de actualización se detubiera durante 2 segundos.

REGISTER
Descripción: Registra una libreria o componente ActiveX en el sistema.

Formato: REGISTER|Ruta de la libreria o componente ActiveX

Ejemplo: REGISTER|$WinSysPath\Library.dll

Este ejemplo registraría la libreria Library.dll en el sistema.

UNREGISTER
Descripción: Desregistra una libreria o componente ActiveX en el sistema.

Formato: UNREGISTER|Ruta de la libreria o componente ActiveX

Ejemplo: UNREGISTER|$WinSysPath\Library.dll

Este ejemplo desregistraría la libreria Library.dll en el sistema.

KILL
Descripción: Detiene la ejecución de la aplicación indicada como parámetro en el sistema.

Formato: KILL|Nombre del ejecutable de la aplicación

Ejemplo: KILL|notepad.exe

Este ejemplo detendría la ejecución del Bloc de notas de Windows en el sistema.