winsparkle

Acerca de

WinsParkle es una biblioteca de actualización de software plug-and forget para aplicaciones de Windows. Está fuertemente inspirado en el marco Sparkle para OS X escrito por Andy Matuschak y otros, hasta el punto de compartir el mismo formato de actualizaciones (AppCasts) y tener una interfaz de usuario muy similar.

Consulte https://winsparkle.org para obtener más información sobre Winsparkle.

Documentación: Wiki y el encabezado Winsparkle.h.

Uso de binarios prebuidados

La forma más fácil de usar WinsParkle es descargar el binario WinSparkle.dll prebuilt.dll de las versiones o usar el paquete WinSparkle Nuget. Los binarios preconstruidos están disponibles para plataformas X86, X64 y ARM64.

Ataduras

Winsparkle tiene una API C que facilita el uso de muchos idiomas modernos, además de C/C ++. Además de eso, existen varios enlaces para idiomas populares:

• Cómo usar con C#/. Net
• Pitón
• Ir
• Pascal Bunding Bundled con Winsparkle

Edificio de fuentes

Si prefiere construir WinsParkle usted mismo, puede hacerlo. Tendrás que compilar desde un pago GIT; Algunas de las dependencias se incluyen como submódulos Git.

Verifique las fuentes e inicialice los submódulos:

 $ git clone https://github.com/vslavik/winsparkle.git
$ cd winsparkle
$ git submodule init
$ git submodule update

Para compilar la biblioteca, simplemente abra WinSparkle.sln (o la que corresponde a su versión del compilador) y construya.

Por el momento, se proporcionan proyectos para Visual C ++ (2010 y UP), por lo que necesitará que (la edición express/Community sea suficiente). En principio, no hay nada en el código que evite que otros compiladores compilen.

También hay archivos de compilación CMake no compatibles en el directorio CMake.

Firmas de DSA

Winsparkle utiliza exactamente el mismo mecanismo para la firma y la verificación de la firma que el proyecto Sparkle. Sus herramientas y métodos de verificación son totalmente compatibles.

Puede usar cualquier forma compatible de firmar su actualización. Para lograr esto, debe firmar SHA1 (en forma binaria) de su archivo de actualización con la clave privada DSA, utilizando SHA1 Digest.

WinsParkle proporciona herramientas para generar claves y firmar la actualización usando OpenSSL.

Necesita openssl.exe disponible en Windows para usar esas herramientas (disponibles como binario precompilado).

Alternativamente, puede generar claves y firmar sus actualizaciones incluso en MacOS o Linux, utilizando herramientas proporcionadas por Sparkle Project.

Prepare la firma con las firmas DSA:

• Primero, hazte un par de claves DSA. Esto debe hacerse solo una vez. Winsparkle incluye una herramienta para ayudar: bingenerate_keys.bat
• Realice una copia de seguridad de su clave privada (DSA_PRIV.PEM) y mantenla a salvo. No desea que nadie más lo obtenga, y si lo pierde, es posible que no pueda emitir ninguna actualización nueva.
• Agregue su clave pública (dsa_pub.pem) a su proyecto, ya sea como recurso de Windows o de cualquier otra manera adecuada y proporcione la API WinsParkle.

Firme su actualización

Cuando su actualización esté lista (por ejemplo, Updater.exe ), firme e incluya firma en su archivo de AppScast:

• Firmar: binsign_update.bat Updater.exe dsa_priv.pem
• Agregue la salida estándar del comando anterior como sparkle:dsaSignature del nodo enclosure de su archivo AppCast. Alternativamente sparkle:dsaSignature puede ser un nodo infantil de enclosure .

¿Dónde puedo obtener algunos ejemplos?

Descargue el archivo de fuentes y eche un vistazo a los ejemplos/ carpeta.

Uso de las últimas versiones de desarrollo

Si desea quedarse en el borde de sangrado y usar la versión más reciente, aún no lanzada, de Winsparkle, puede obtener sus fuentes del repositorio público. WinsParkle usa Git y las fuentes están alojadas en GitHub en https://github.com/vslavik/winsparkle

WinsParkle usa submódulos para algunas dependencias, por lo que debe inicializarlos después de revisar el árbol:

 $ git clone https://github.com/vslavik/winsparkle.git
$ cd winsparkle
$ git submodule init
$ git submodule update

Luego compile Winsparkle como se describió anteriormente; No se requieren pasos adicionales.