Versões e canais
Publicar um pacote cria uma versão: um instantâneo do seu nome, resumo e conteúdo nesse momento, com a sua data, as plataformas em que funciona e notas da versão opcionais. Uma versão publicada nunca muda; editar o pacote prepara a seguinte.
Dois canais
Seção intitulada “Dois canais”| Canal | Número | Exemplo | Para |
|---|---|---|---|
| Estável | MAJOR.MINOR.PATCH |
1.2.0 |
Todas as plataformas: a atualização que lhes é proposta. |
| Desenvolvimento | MAJOR.MINOR.PATCH-dev.N |
1.3.0-dev.2 |
Testes: uma pré-versão da próxima versão estável. |
As versões de desenvolvimento são sempre apresentadas à parte: um distintivo laranja, o seu próprio cartão Em desenvolvimento e o botão Transferir a versão de desenvolvimento na página do pacote.
Escolher o número
Seção intitulada “Escolher o número”Nunca escreve um número de versão: escolhe um incremento, e a janela mostra o número que dele resulta (Publica a versão 1.1.0.).
Estável: o incremento aplica-se à versão estável mais alta.
| Incremento | Quando | A partir de 1.2.3 |
|---|---|---|
| Correção | Correções: um erro numa descrição, uma linha de script corrigida | 1.2.4 |
| Menor | Acréscimos: novos modelos, um novo perfil | 1.3.0 |
| Maior | Alterações incompatíveis: itens removidos ou reorganizados | 2.0.0 |
A primeiríssima versão estável é Maior 1.0.0, ou Desenvolvimento inicial 0.1.0 se o
pacote ainda não estiver pronto para produção.
Desenvolvimento: o incremento indica a versão estável para a qual está a trabalhar, e o número é
esse alvo seguido de -dev.N, em que N é incrementado para esse alvo.
Exemplo de sequência
Seção intitulada “Exemplo de sequência”| Ação | Versão |
|---|---|
| Primeira publicação, Estável, Maior | 1.0.0 |
| Novo modelo adicionado, Desenvolvimento, Menor | 1.1.0-dev.1 |
| Script corrigido, Desenvolvimento, Menor | 1.1.0-dev.2 |
| Pronto para todos, Estável, Menor | 1.1.0 |
| Erro corrigido, Estável, Correção | 1.1.1 |
| Perfis reorganizados, Desenvolvimento, Maior | 2.0.0-dev.1 |
As versões são ordenadas como no Semantic Versioning: uma versão de desenvolvimento antecede a
versão estável a que conduz, 1.0.0 < 1.1.0-dev.1 < 1.1.0-dev.2 < 1.1.0.
Versões mais recente e de desenvolvimento
Seção intitulada “Versões mais recente e de desenvolvimento”- A versão mais recente de um pacote (distintivo Mais recente) é a sua versão estável mais alta.
- A sua versão de desenvolvimento é a sua versão de desenvolvimento mais alta, quando está acima
da mais recente. Depois de publicar
1.1.0,1.1.0-dev.2deixa de ser apresentada como a versão de desenvolvimento.
O cabeçalho do editor mostra ambas, e Alterações não publicadas quando o conteúdo difere delas.
Quando um canal pode ser publicado
Seção intitulada “Quando um canal pode ser publicado”- Estável pode ser publicado quando o nome, o resumo ou o conteúdo mudaram desde a versão estável mais alta (mesmo que uma versão de desenvolvimento já contenha o mesmo conteúdo).
- Desenvolvimento pode ser publicado quando algo mudou desde a última versão de qualquer canal.
Um canal sem nada para publicar não pode ser escolhido (Nada mudou para este canal desde a sua última versão.). Quando nenhum pode, a página Versões indica Nada mudou desde a última versão.
O que as plataformas fazem com as versões
Seção intitulada “O que as plataformas fazem com as versões”- Uma plataforma instala um pacote e mantém-no atualizado com as suas versões estáveis.
- As versões de desenvolvimento destinam-se a plataformas de teste: instale-as de propósito, transferindo o ficheiro de desenvolvimento ou escolhendo-o numa plataforma ligada. Consulte Versões e canal dev no guia da plataforma.
- Cada item do conteúdo mantém a sua identidade de uma versão para a seguinte, pelo que uma atualização altera os itens que a plataforma já tem em vez de os duplicar, e remove os itens que removeu.
- Instalar uma versão inferior à instalada é uma reversão: a plataforma pede confirmação antes de voltar atrás.