winsparkle

Tentang

Winsparkle adalah perpustakaan pembaruan perangkat lunak plug-and-forget untuk aplikasi Windows. Hal ini sangat terinspirasi oleh kerangka kerja Sparkle untuk OS X yang ditulis oleh Andy Matuschak dan lainnya, sampai berbagi format pembaruan yang sama (Appcasts) dan memiliki antarmuka pengguna yang sangat mirip.

Lihat https://winsparkle.org untuk informasi lebih lanjut tentang Winsparkle.

Dokumentasi: Wiki dan header Winsparkle.h.

Menggunakan binari prebuilt

Cara termudah untuk menggunakan Winsparkle adalah dengan mengunduh prebuilt WinSparkle.dll biner dari rilis atau menggunakan paket WinSparkle Nuget. Binari Prebuilt tersedia untuk platform x86, x64 dan ARM64.

Binding

Winsparkle memiliki A API yang membuatnya mudah digunakan dari banyak bahasa modern selain C/C ++. Selain itu, ada beberapa binding untuk bahasa populer:

• Cara menggunakan dengan c#/. Net
• Python
• Pergi
• Pascal Binding dibundel dengan Winsparkle

Membangun dari sumber

Jika Anda lebih suka membangun Winsparkle sendiri, Anda bisa melakukannya. Anda harus mengkompilasi dari checkout git; Beberapa dependensi dimasukkan sebagai submodul GIT.

Periksa sumber dan inisialisasi submodules:

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

Untuk mengkompilasi perpustakaan, cukup buka solusi WinSparkle.sln (atau yang sesuai dengan versi kompiler Anda) dan bangun.

Saat ini, Proyek untuk Visual C ++ (2010 dan lebih tinggi) disediakan, jadi Anda akan membutuhkannya (Express/Community Edition cukup). Pada prinsipnya, tidak ada dalam kode yang mencegahnya disusun oleh kompiler lain.

Ada juga file build cmake yang tidak didukung di direktori cmake.

Tanda tangan DSA

Winsparkle menggunakan mekanisme yang persis sama untuk penandatanganan dan verifikasi tanda tangan seperti proyek Sparkle. Alat dan metode verifikasi sepenuhnya kompatibel.

Anda dapat menggunakan cara apa pun yang kompatibel untuk menandatangani pembaruan Anda. Untuk mencapai hal ini, Anda perlu menandatangani SHA1 (dalam bentuk biner) dari file pembaruan Anda dengan DSA Private Key, menggunakan Sha1 Digest.

Winsparkle menyediakan alat untuk menghasilkan kunci dan menandatangani pembaruan menggunakan OpenSSL.

Anda perlu openssl.exe tersedia di Windows untuk menggunakan alat -alat itu (tersedia sebagai biner yang diolah).

Atau, Anda dapat menghasilkan kunci dan menandatangani pembaruan Anda bahkan pada macOS atau Linux, menggunakan alat yang disediakan oleh Sparkle Project.

Siapkan penandatanganan dengan tanda tangan DSA:

• Pertama, jadikan diri Anda satu kunci DSA. Ini perlu dilakukan hanya sekali. Winsparkle termasuk alat untuk membantu: bingenerate_keys.bat
• Cadangkan kunci pribadi Anda (dsa_priv.pem) dan jaga agar tetap aman. Anda tidak ingin orang lain mendapatkannya, dan jika Anda kehilangannya, Anda mungkin tidak dapat mengeluarkan pembaruan baru.
• Tambahkan kunci publik Anda (dsa_pub.pem) ke proyek Anda baik sebagai sumber daya Windows, atau cara lain yang sesuai dan menyediakannya menggunakan Winsparkle API.

Tanda tangani pembaruan Anda

Saat pembaruan Anda siap (misalnya Updater.exe ), menandatangani dan sertakan tanda tangan ke file appcast Anda:

• Tanda: binsign_update.bat Updater.exe dsa_priv.pem
• Tambahkan output standar dari perintah sebelumnya sebagai sparkle:dsaSignature dari Node enclosure dari File Appcast Anda. Atau sparkle:dsaSignature bisa menjadi enclosure anak -anak.

Di mana saya bisa mendapatkan beberapa contoh?

Unduh arsip sumber dan lihat contoh/ folder.

Menggunakan versi pengembangan terbaru

Jika Anda ingin tetap di tepi pendarahan dan menggunakan versi Winsparkle terbaru, belum dirilis, Anda bisa mendapatkan sumbernya dari repositori publik. Winsparkle menggunakan git dan dan sumber di -host di github di https://github.com/vslavik/winsparkle

Winsparkle menggunakan submodul untuk beberapa dependensi, jadi Anda harus menginisialisasi mereka setelah memeriksa pohon:

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

Kemudian mengkompilasi Winsparkle seperti dijelaskan di atas; Tidak ada langkah tambahan yang diperlukan.