Simple Updater

Simple Updater es una biblioteca creada para ayudarlo a construir un actualizador en algunas líneas de código (para su lanzador de juegos u otros proyectos).
Esta biblioteca está construida en C# (.NET ≥ 4.6) y Java (JRE ≥ 1.8_80) .
¡Simplemente descargue la biblioteca, haga referencia a su proyecto y estará listo para comenzar!
¡Verifique la documencia a continuación para comenzar a usarlo! (Se proporciona un proyecto de ejemplo en la fuente para cada LAGAGE)

Características:

• Desarrollado tanto en C# como en Java
• ¡No hay bibliotecas adicionales! Todo es nativo.
• Integración fácil
• Mantenga el cliente actualizado con el servidor
• Eliminar archivos antiguos o no deseados que no coincidan con el servidor
• Ignorar la lista
• Configuración de WebClient
• Puede almacenar en caché el resultado del servidor durante x minutos/segundos (opcional: puede tener una respuesta de mucho tiempo si está deshabilitada con muchos archivos)
• Evento de activación para cada paso (verificación de archivos, descarga, ...)
• Código de estado
• Descargar progresión
• Descarga asíncrona
• Ejemplo de proyectos completamente comentados

¡Cualquier contribución es bienvenida!
Versión actual: 1.1

Tabla de contenido

• Presentación
• Tabla de contenido
• Instalación
  • Servidor web
  • Integración del cliente
    • DO#
    • JAVA
• Documentación del código
  • Crea el objeto de actualización simple
  • Función: verifique los archivos desde el servidor y elimine los archivos obsoletos
  • Función: Descargar archivos
  • Atributos del objeto SimpleUpdater
  • Eventos
  • Código de estado
• Proyecto de ejemplo
• Crédito
• Licencia

Instalación

Servidor web

Necesitará un servidor web para alojar archivos que el actualizador descargará.

1. Clon/descargar el proyecto
2. Cargar archivos que están en 'PHP - Archivos del servidor' a su servidor web
3. Verifique el index.php para la configuración
4. Cree una carpeta llamada 'archivos' en el mismo directorio que el archivo index.php
5. Coloque todos los archivos que desea descargar en esa carpeta 'Archivos'

Integración del cliente

DO#

1. Vaya a la página de lanzamiento y descargue la biblioteca de actualizadores simples .
2. Referencia en su proyecto (Tutorial de Microsoft)
3. Use el objeto SimpleUpdater (consulte la documentación a continuación)

JAVA

1. Vaya a la página de lanzamiento y descargue la biblioteca de actualizadores simples .
2. Agrégalo en su proyecto (un tutorial)
3. Use el objeto SimpleUpdater (consulte la documentación a continuación)

Documentación del código

Crea el objeto actualizador simple.

 // We will keep 'updater' on all the documentation
SimpleUpdater updater = new SimpleUpdater ( server_url , installation_path ) ;

Parámetros	Tipo	Descripción
servidor_url	string / String	La URL del servidor en el que se descargarán los archivos
instalación_path	string / String	La ruta donde se descargarán los archivos (tenga cuidado si no se establece correctamente, puede eliminar archivos incorrectos)

Función: verifique los archivos desde el servidor y elimine los archivos obsoletos (mantenga actualizado)

 updater . CheckFilesFromServerAndDeleteOutdated ( ) ;

Descripción: Esta función se comunicará con el servidor para obtener todos los archivos y buscar a través de todos los archivos y directorios locales que los archivos deben eliminarse, descargar o ignorar. Los archivos que deben eliminarse se eliminarán automáticamente.

Se debe llamar a esta función antes de descargar archivos.

Función: Descargar archivos

 updater . DownloadFiles ( ) ;

Descripción: Esto descargará todos los archivos que deben descargarse a la installation_path proporcionada con la creación del objeto SimpleUpdater .

Atributos del objeto SimpleUpdater

Nombre (C#)	Función (Java)	Tipo	Descripción
Servidor_url	getServerUrl()	string / String	La URL del servidor en el que se descargarán los archivos
Instalación_path	getInstallationPath()	string / String	La ruta donde se descargarán los archivos
Encabezado	CanDownload()	bool / Boolean	Compruebe si puede iniciar la descarga de archivos
Vitillo	CanCheck()	bool / Boolean	Compruebe si puede iniciar el proceso de verificación de los archivos locales
Número de la carga	getNumberOfBytesToDownlaod()	long	Obtenga el número de bytes que se descargarán
Código de estado	getStatusCode()	int	Obtener el código de estado

Eventos

Nombre	Argumentos	Descripción
En chickeckfinished	int nbrLocalFiles int nbrServerFiles int nbrFilesToDownload int nbrFilesDeleted long numberOfBytesToDownload	Evento activado cuando finaliza el proceso de verificación
Ondownloadfinishished	long TotalBytesDownloaded	Evento activado cuando termina la descarga
OndownloadProgresschanged	long TotalBytesDownloaded float percent	Evento activado cada vez que cambió el progreso de descarga
OnstatusChanged	int code	Evento activado cuando cambia el estado del actualizador

En la versión Java, debe crear una clase e implementar la clase SimpleUpdaterEvents . Cree una instancia de esta clase y agréguela a los oyentes de SimpleUpdater Object con updater.addListener(yourEventClassObject) .
Consulte el proyecto de ejemplo de Java para obtener más información.

Código de estado

Código	Descripción
0	Esperando la acción
1	Contactar al servidor para que los archivos se analicen
2	Buscar y eliminar archivos locales
3	Comprobar terminado Activado después de check_finished (...)
4	Descargar comenzó
5	Un archivo se ha descargado correctamente
6	Se produjo un error al descargar un archivo
7	Un error ocurrido intentará acceder al servidor
8	Descargar terminado Activado después de descargar_finished (...)

Proyectos de ejemplo

DO#

El proyecto de ejemplo se comenta completamente. Puede encontrarlo en C# - Ejemplo Proyecto Simple Updater .

JAVA

Este proyecto de ejemplo si se comenta completamente. Imprime depurar la consola. Puede encontrarlo en 'Java - Simple Updater Library' .

Crédito

• EN0 - Flavien Darche

Licencia

MIT License