Atualizações

Procurar#

Definições > Acerca de > Procurar atualizações pergunta ao GitHub pela versão mais recente do projeto. Com Procurar atualizações automaticamente ativo, o Komorebi também procura no máximo uma vez por dia. Uma verificação é um pedido HTTPS a api.github.com, com o User-Agent Komorebi/<versão> e mais nada sobre si ou o seu correio. Quando existe uma versão mais recente, Definições > Acerca de indica-o, e uma barra discreta por cima da lista de mensagens diz "A versão X está disponível."

Transferir e instalar#

Nada é transferido até premir Transferir e instalar. O Komorebi transfere então três ficheiros da versão a partir de github.com para uma pasta nova komorebi-update-* na sua pasta temporária:

• o instalador, komorebi-<versão>-setup.exe, com uma barra de progresso quando o servidor indica o tamanho;
• komorebi-<versão>-setup.exe.sha256, o seu hash SHA-256;
• komorebi-<versão>-setup.exe.sig, uma assinatura Ed25519.

Como a transferência é verificada#

O instalador só é executado se as duas verificações passarem:

1. O SHA-256 coincide com o .sha256 publicado.
2. A assinatura Ed25519 é válida para a chave pública incluída no Komorebi. A assinatura abrange a versão e o hash em conjunto, por isso um instalador mais antigo não pode ser servido como mais recente.

A chave privada que faz estas assinaturas fica com o responsável pelo projeto, fora do repositório. Quando as duas verificações passam, o instalador corre sem perguntas: fecha o Komorebi, atualiza-o no mesmo sítio e volta a iniciá-lo.

Verificar uma versão por si#

Para verificar um instalador que transferiu no browser, compare o seu SHA-256 com o ficheiro .sha256 da versão, como em Primeiros passos. Com o código-fonte, o exemplo sign_update do projeto também verifica a assinatura Ed25519:

cargo run --example sign_update -- verify komorebi-0.7.0-setup.exe 0.7.0