Versões e lançamentos
A sua versão é texto livre e nunca é ordenada. packaging.revision sobe a cada novo empacotamento, e o catálogo numera os lançamentos. Nunca reutilize uma versão e uma revisão com bytes diferentes.
Versões
version é o texto do autor, de 1 a 32 caracteres. Nunca é ordenada, e duas versões não são comparadas como números: “10.2.0”, “Alpha 5” e “IVb” são todas válidas.
packaging.revision marca um novo empacotamento da mesma versão e sobe a partir de 1, para que uma instalação a partir do ficheiro continue a reconhecer uma compilação mais recente dessa versão quando não há catálogo envolvido.
Lançamentos
O catálogo de um repositório numera cada lançamento de uma chave de pacote e nunca ordena as cadeias de versão. Uma atualização é um lançamento mais alto da mesma chave, no mesmo repositório.
| O quê | Quem o define | Regra |
|---|---|---|
version | O autor | Texto livre. Nunca é reutilizado com bytes diferentes. |
packaging.revision | Quem empacota | Sobe a cada pacote da mesma versão. |
release | O repositório | Sobe a cada publicação da chave. Imutável: um jogo guardado ou uma repetição mantém o lançamento com que foi feito. |
Atualizações
A Biblioteca mostra uma atualização quando o catálogo tem um lançamento mais alto do que o instalado, e uma instalação a partir do ficheiro substitui, depois de perguntar, uma packaging.revision mais baixa da mesma versão. Uma versão anterior fica guardada em .backup, para que uma substituição possa ser desfeita.
Quem publica nunca reutiliza uma versão e uma revisão com bytes diferentes: o script de publicação da biblioteca de conteúdos recusa-o.