winsparkle

Um

Winsparkle ist eine Plug-and---Software-Software-Update-Bibliothek für Windows-Anwendungen. Es ist stark vom Sparkle -Framework für OS X inspiriert, das von Andy Matuschak und anderen bis hinsichtlich des gleichen Updates -Formats (Appcasts) und einer sehr ähnlichen Benutzeroberfläche geschrieben wurde.

Weitere Informationen zu Winsparkle finden Sie unter https://winsparkle.org.

Dokumentation: Wiki und The Winsparkle.h Header.

Verwenden von vorgebauten Binärdateien

Der einfachste Weg, Winsparkle zu verwenden WinSparkle besteht darin, entweder den vorgebauten WinSparkle.dll herunterzuladen. Vorbereitete Binärdateien sind für Plattformen X86, X64 und ARM64 erhältlich.

Bindungen

Winsparkle verfügt über eine C -API, mit der zusätzlich zu C/C ++ von vielen modernen Sprachen verwendet werden können. Darüber hinaus gibt es mehrere Bindungen für populäre Sprachen:

• Wie man mit C#/. Netz verwendet
• Python
• Gehen
• Mit Winsparkle gebündelte Pascalbindung

Gebäude aus Quellen

Wenn Sie es vorziehen, Winsparkle selbst zu bauen, können Sie dies tun. Sie müssen aus einer Git -Kasse zusammenstellen. Einige der Abhängigkeiten sind als Git -Submodul enthalten.

Überprüfen Sie die Quellen aus und initialisieren Sie die Submodules:

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

Um die Bibliothek zu kompilieren, öffnen Sie einfach WinSparkle.sln (oder die, die Ihrer Compiler -Version entspricht) und erstellen Sie sie.

Im Moment werden Projekte für Visual C ++ (2010 und UP) bereitgestellt, sodass Sie dies benötigen (Express/Community Edition genügt). Grundsätzlich gibt es nichts im Code, der verhindert, dass er von anderen Compilern zusammengestellt wird.

Es gibt auch nicht unterstützte CMake -Build -Dateien im CMAKE -Verzeichnis.

DSA -Signaturen

Winsparkle verwendet genau den gleichen Mechanismus für die Unterzeichnung und Signaturüberprüfung wie das Sparkle -Projekt. Die Werkzeuge und Verifizierungsmethoden sind vollständig kompatibel.

Sie können eine kompatible Möglichkeit verwenden, um Ihr Update zu unterschreiben. Um dies zu erreichen, müssen Sie SHA1 (in Binärform) Ihrer Aktualisierungsdatei mit DSA Private Key unter Verwendung von SHA1 Digest signieren.

Winsparkle bietet Tools zum Generieren von Schlüsseln und zum Signieren des Updates mit OpenSSL.

Sie benötigen openssl.exe unter Windows zur Verwendung dieser Tools (verfügbar als vorkompiliertes binär).

Alternativ können Sie Tasten generieren und Ihre Updates auch auf MacOS oder Linux unter Verwendung von Tools mit Sparkle Project unterschreiben.

Bereiten Sie die Unterzeichnung mit DSA -Signaturen vor:

• Machen Sie sich zuerst ein Paar DSA -Schlüssel. Dies muss nur einmal erledigt werden. Winsparkle enthält ein Tool zur Hilfe: bingenerate_keys.bat
• Sichern Sie Ihren privaten Schlüssel (DSA_PRIV.PEM) und halten Sie ihn sicher. Sie möchten nicht, dass jemand anderes es bekommt, und wenn Sie es verlieren, können Sie möglicherweise keine neuen Updates ausstellen.
• Fügen Sie Ihren öffentlichen Schlüssel (dsa_pub.pem) Ihrem Projekt entweder als Windows -Ressource oder auf eine andere geeignete Art und Weise hinzu und geben Sie es mit Winsparkle -API an.

Unterschreiben Sie Ihr Update

Wenn Ihr Update fertig ist (z. B. Updater.exe ), unterschreiben Sie es und geben Sie die Unterschrift in Ihre Appcast -Datei an:

• binsign_update.bat Updater.exe dsa_priv.pem
• Fügen Sie die Standardausgabe des vorherigen Befehls als sparkle:dsaSignature -Attribut des enclosure Ihrer Appcast -Datei. Alternativ sparkle:dsaSignature kann ein untergeordneter Knoten des enclosure sein.

Wo kann ich einige Beispiele bekommen?

Laden Sie das Quellenarchiv herunter und schauen Sie sich die Beispiele/ den Ordner an.

Verwenden der neuesten Entwicklungsversionen

Wenn Sie am Bleeding Edge bleiben und die neueste, noch nicht veröffentlichte Version von Winsparkle verwenden möchten, können Sie seine Quellen aus dem öffentlichen Repository erhalten. Winsparkle verwendet Git und die Quellen werden auf Github unter https://github.com/vslavik/winsparkle gehostet

Winsparkle verwendet Submodule für einige Abhängigkeiten, sodass Sie sie initialisieren müssen, nachdem Sie den Baum austreten:

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

Dann winsparkle wie oben beschrieben kompilieren; Es sind keine zusätzlichen Schritte erforderlich.