winsparkle

Sobre

O Winsparkle é uma biblioteca de atualização de software plug-and-sget para aplicativos do Windows. É fortemente inspirado na estrutura Sparkle para o OS X, escrito por Andy Matuschak e outros, a ponto de compartilhar o mesmo formato de atualizações (Appcasts) e ter uma interface de usuário muito semelhante.

Consulte https://winsparkle.org para obter mais informações sobre o Winsparkle.

Documentação: Wiki e o cabeçalho Winsparkle.H.

Usando binários pré -construídos

A maneira mais fácil de usar o Winsparkle é baixar o binário pré -construído WinSparkle.dll de lançamentos ou usar o pacote WinSparkle Nuget. Os binários pré -construídos estão disponíveis para plataformas X86, X64 e ARM64.

Ligações

O Winsparkle possui uma API C que facilita o uso de muitos idiomas modernos, além de C/C ++. Além disso, existem várias ligações para idiomas populares:

• Como usar com C#/. NET
• Python
• Ir
• Pascal Ligathing Pacacelled com Winsparkle

Edifício de fontes

Se você preferir construir o Winsparkle, você pode fazê -lo. Você terá que compilar a partir de uma finalização do git; Algumas das dependências são incluídas como submódulos Git.

Verifique as fontes e inicialize os submódulos:

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

Para compilar a biblioteca, basta abrir WinSparkle.sln (ou o correspondente à sua versão do compilador) e criá -lo.

No momento, são fornecidos projetos para o Visual C ++ (2010 e acima), portanto, você precisará disso (é suficiente (Express/Community Edition). Em princípio, não há nada no código que impeça que ele seja compilado por outros compiladores.

Também existem arquivos de construção cmake não suportados no diretório CMake.

Assinaturas DSA

O Winsparkle usa exatamente o mesmo mecanismo para assinar e verificação de assinatura que o projeto Sparkle. Suas ferramentas e métodos de verificação são totalmente compatíveis.

Você pode usar qualquer maneira compatível para assinar sua atualização. Para conseguir isso, você precisa assinar SHA1 (em forma binária) do seu arquivo de atualização com a chave privada DSA, usando o SHA1 Digest.

O Winsparkle fornece ferramentas para gerar chaves e assinar a atualização usando o OpenSSL.

Você precisa openssl.exe disponível no Windows para usar essas ferramentas (disponíveis como binário pré -compilado).

Como alternativa, você pode gerar teclas e assinar suas atualizações mesmo no macOS ou Linux, usando as ferramentas fornecidas pelo Sparkle Project.

Prepare a assinatura com assinaturas DSA:

• Primeiro, faça um par de teclas DSA. Isso precisa ser feito apenas uma vez. Winsparkle inclui uma ferramenta para ajudar: bingenerate_keys.bat
• Faça backup de sua chave privada (dsa_priv.pem) e mantenha -a segura. Você não quer que mais ninguém o obtenha e, se você o perder, talvez não seja capaz de emitir novas atualizações.
• Adicione sua chave pública (dsa_pub.pem) ao seu projeto como recurso do Windows ou qualquer outra maneira adequada e forneça -o usando a API Winsparkle.

Assine sua atualização

Quando sua atualização estiver pronta (por exemplo, Updater.exe ), assine -o e inclua assinatura no seu arquivo Appcast:

• Sinal: binsign_update.bat Updater.exe dsa_priv.pem
• Adicione a saída padrão do comando anterior como sparkle:dsaSignature Attribute do nó enclosure do seu arquivo de aplicativo. Alternativamente, sparkle:dsaSignature pode ser um nó infantil de enclosure .

Onde posso conseguir alguns exemplos?

Faça o download do arquivo de fontes e dê uma olhada nos exemplos/ pasta.

Usando as últimas versões de desenvolvimento

Se você deseja ficar na borda sangrando e usar a versão mais recente e ainda não lançada do Winsparkle, você pode obter suas fontes do repositório público. Winsparkle usa o git e as fontes são hospedadas no github em https://github.com/vslavik/winsparkle

Winsparkle usa submódulos para algumas dependências, então você deve inicializá -las depois de verificar a árvore:

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

Em seguida, compile Winsparkle, como descrito acima; Não são necessárias etapas extras.