Saltar para o conteúdo principal
O Orkestral entrega novas versões através do seu sistema operacional de duas maneiras diferentes. No Windows e no Linux, o app se atualiza silenciosamente em segundo plano e instala a nova versão quando você reinicia. No macOS, o app verifica se há uma nova versão e a oferece a você, mas você a instala manualmente. Esta página explica os dois caminhos, o que acontece nos bastidores e o que você precisa fazer.
As atualizações são best-effort por design. Se você estiver offline, atingir um limite de taxa ou a verificação falhar por qualquer motivo, o Orkestral permanece em silêncio e continua funcionando. Um problema de atualização nunca bloqueia o seu trabalho nem quebra a inicialização.

​
Dois caminhos de atualização

Sua experiência de atualização depende da sua plataforma. O motivo é a assinatura de código: a instalação contínua no macOS precisa de um Apple Developer ID, então, até que isso esteja em vigor, o Mac usa uma verificação manual enquanto o Windows e o Linux recebem o atualizador completo em segundo plano.

Windows e Linux

Atualizações contínuas em segundo plano. O app baixa a nova versão enquanto você trabalha e a instala na próxima reinicialização. Você só confirma a reinicialização.

macOS

Atualizações manuais. O app avisa que existe uma versão mais nova e aponta o caminho para o download. Você mesmo substitui o app.

​
Como funcionam as atualizações contínuas (Windows e Linux)

Em um build empacotado de Windows ou Linux, o Orkestral configura um atualizador automático na inicialização. A partir daí, ele gerencia tudo para você.
1

O app verifica na inicialização

Logo após o Orkestral iniciar, ele pergunta ao feed de releases se há uma versão mais nova disponível. Essa verificação roda apenas no app instalado (empacotado), nunca em desenvolvimento.
2

Ele baixa em segundo plano

Se existir uma versão mais nova, o atualizador a baixa automaticamente enquanto você continua trabalhando. Não há diálogo de progresso para acompanhar e nada para clicar. O download roda silenciosamente.
3

Ele verifica novamente a cada quatro horas

Enquanto o app permanecer aberto, o Orkestral verifica novamente se há versões mais novas a cada quatro horas. Se um novo build surgir durante uma sessão de longa duração, ele é capturado sem reiniciar o loop de verificação.
4

Você vê um banner de reinicialização

Assim que uma versão termina de baixar, o Orkestral exibe um banner avisando que a atualização está pronta. O banner traz o número da nova versão para que você saiba o que está prestes a instalar.
5

Você reinicia para instalar

Clique na ação de reinicialização no banner. O Orkestral fecha, aplica a atualização baixada e reabre na nova versão. Se você ignorar o banner, a atualização será instalada automaticamente na próxima vez que você fechar o app.
Dois comportamentos estão sempre ativos no atualizador em segundo plano: ele baixa automaticamente novas versões e as instala automaticamente ao fechar. Então, mesmo que você nunca clique no banner, você acaba na nova versão na próxima vez que fechar o Orkestral normalmente.

​
O que você controla

Não. No Windows e no Linux, o download é automático e roda em segundo plano. Você só decide quando reiniciar.
A atualização ainda será instalada na próxima vez que você fechar o Orkestral, porque a instalação automática ao fechar está ativada. Reiniciar pelo banner é simplesmente o caminho mais rápido.
Não. O download acontece silenciosamente e nada é instalado até você reiniciar ou fechar. Sua sessão nunca é cortada no meio de uma tarefa por uma atualização.
Os erros são capturados e ignorados. O atualizador registra um aviso internamente e o app continua normalmente. Você simplesmente não receberá a atualização até que uma verificação posterior tenha sucesso.

​
Como funcionam as atualizações manuais (macOS)

No macOS, o Orkestral não instala atualizações para você. Em vez disso, ele verifica se uma versão mais nova foi publicada e, se houver, a oferece. Você então a baixa e instala por conta própria.
1

O Orkestral verifica a release mais recente

O app consulta a release publicada mais recente e compara sua versão com a versão que você está executando. Builds de rascunho e pré-lançamento são ignorados, então você só vê releases estáveis.
2

Ele compara as versões

O Orkestral compara os números major.minor.patch. A atualização só é oferecida quando a versão publicada é estritamente mais nova que a sua. Um prefixo v na tag (por exemplo v1.2.3) é tratado automaticamente.
3

Ele escolhe o download certo

Quando existe uma atualização, o Orkestral seleciona o .dmg que corresponde à arquitetura do seu Mac (Apple Silicon arm64 ou Intel x64). Se nenhum arquivo específico da arquitetura for encontrado, ele recorre a qualquer .dmg disponível e, se não houver imagem de disco alguma, recorre à página da release.
4

Você baixa e instala

Abra o download oferecido. Monte o .dmg e arraste o Orkestral para a sua pasta Aplicativos, substituindo a versão antiga. As notas de versão e a data de publicação são exibidas para que você saiba o que mudou.
No macOS, você substitui o app manualmente. Feche o Orkestral antes de arrastar o novo build para Aplicativos e depois reabra-o de lá. Esse caminho manual existe porque a instalação contínua no macOS exige a assinatura de código da Apple.

​
O que é verificado

Ambos os caminhos leem do feed público de releases do projeto no GitHub. A verificação manual do macOS olha para a release mais recente e retorna um pequeno conjunto de campos.
  • Versão atual: o build que você está executando neste momento.
  • Versão mais recente: a tag de release estável mais nova, com qualquer prefixo v removido.
  • Tem atualização: verdadeiro apenas quando a versão mais recente é estritamente mais nova que a atual.

​
Regras de comparação de versões

O Orkestral compara as versões numericamente, segmento por segmento, entre major, minor e patch.
Uma tag como v1.2.3 ou 1.2.3-beta é dividida em suas partes numéricas major, minor e patch. Um v inicial é removido e qualquer sufixo após o número do patch é descartado para a comparação.
Apenas quando a versão publicada é estritamente maior que a sua. Versões iguais nunca são oferecidas e uma versão publicada mais baixa nunca é tratada como atualização.
Eles não são builds finalizados e estáveis. Ignorá-los significa que você só será apontado para releases destinadas a todos.

​
Solução de problemas

Pode ser que você já esteja na versão mais recente, ou a verificação pode ter falhado silenciosamente porque você estava offline ou com limite de taxa atingido. Tente novamente mais tarde. A verificação também roda apenas no app instalado, então um build de desenvolvimento não mostrará atualizações.
As atualizações em segundo plano são exclusivas do Windows e do Linux, e apenas no app empacotado. No macOS, espere o prompt manual. Em desenvolvimento não há atualizador algum.
O banner aparece somente depois que uma nova versão termina de baixar. Se não houver release mais nova, ou se o download ainda não tiver concluído, nenhum banner aparece. A atualização ainda será instalada na próxima vez que você fechar.
Baixe o .dmg oferecido, feche o Orkestral, arraste-o para Aplicativos para substituir o app antigo e depois reabra. Essa é a atualização manual completa no macOS.

​
O que fazer em seguida

Mantenha o app aberto

No Windows e no Linux, deixar o Orkestral aberto permite que ele verifique novamente a cada quatro horas e baixe builds mais novos sem que você precise mover um dedo.

Reinicie quando estiver pronto

Quando o banner de reinicialização aparecer, reinicie em uma pausa natural. A atualização é aplicada instantaneamente e você reabre na versão mais recente.