Versões e lançamentos
A versão é texto livre e nunca é ordenada. packaging.revision sobe a cada reempacotamento, e o catálogo numera os lançamentos. Não reutilize versão e revisão com outros bytes.
Versões
version é o texto do autor, de 1 a 32 caracteres. Ela 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 reempacotamento da mesma versão, começando em 1, para que uma instalação por arquivo ainda reconheça uma compilação mais nova dessa versão quando não há catálogo envolvido.
Lançamentos
O catálogo de um repositório numera cada lançamento da chave de um pacote e nunca ordena os textos de versão. Uma atualização é um lançamento maior da mesma chave, no mesmo repositório.
| O quê | Quem 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 salvo ou um replay 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 maior que o instalado, e uma instalação por arquivo substitui, depois de perguntar, um packaging.revision menor da mesma versão. A versão anterior fica guardada em .backup, então a substituição pode 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údo recusa isso.