Criando e gerenciando versões

A funcionalidade Lançamentos do GitHub ajuda-o a empacotar e fornecer versões estáveis do seu software aos utilizadores. Pense nela como um anúncio formal de uma nova versão.

É essencial para projetos que precisam de distribuir binários compilados, documentação ou instantâneos específicos do código-fonte.

Cada lançamento do GitHub está diretamente associado a uma etiqueta do Git. Uma etiqueta marca um ponto específico do histórico do seu repositório, normalmente um número de versão como v1.0.0.

• As etiquetas fornecem uma referência permanente e imutável para uma confirmação.
• Os lançamentos acrescentam metadados detalhados (como notas do lançamento e recursos) a essa etiqueta.

Antes de criar um lançamento, certifique-se de que enviou a etiqueta pretendida para o GitHub!

As notas do lançamento são descrições que explicam o que há de novo, o que foi melhorado ou corrigido numa versão específica. São essenciais para comunicar alterações aos seus utilizadores.

• Utilize uma linguagem clara e concisa.
• Realce as principais funcionalidades e correções de erros.
• É possível utilizar a formatação Markdown para obter texto formatado.

Os recursos do lançamento são ficheiros que pode anexar a um lançamento, disponibilizando-os para transferência. Podem incluir:

• Binários compilados (por exemplo, .exe, .dmg)
• Código-fonte comprimido (.zip, .tar.gz)
• Ficheiros de documentação ou instaladores

Fornecem, num só lugar, tudo o que os utilizadores precisam para essa versão específica.

Para criar um lançamento:

1. Aceda ao seu repositório no GitHub.
2. Clique em 'Lançamentos' (normalmente encontra-se na barra lateral direita ou no separador 'Código').
3. Clique no botão 'Criar um novo lançamento'.

É aberto um formulário onde poderá definir os detalhes do lançamento.

Na página de criação do lançamento:

• Escolherá uma etiqueta do Git existente ou criará uma nova.
• Indicará um título do lançamento (por exemplo, 'Versão 1.0.0 - Lançamento inicial').
• Escreverá as suas notas detalhadas do lançamento.

Pode marcá-lo como uma 'versão de pré-lançamento' (para testes) ou publicá-lo diretamente.

O GitHub pode ajudar a gerar notas de lançamento automaticamente!

Ao clicar em 'Gerar notas de lançamento', o GitHub analisará as confirmações e os pedidos de integração incorporados desde a última etiqueta de lançamento e sugerirá um resumo. Poderá então editá-lo e aperfeiçoá-lo.

Quando as notas do lançamento estiverem prontas, poderá carregar recursos.

Basta arrastar e largar os ficheiros na área designada ou clicar para procurar. O GitHub irá carregá-los e estes aparecerão como ficheiros transferíveis na página do lançamento.

Todos cometem erros! Pode sempre editar ou eliminar um lançamento.

• Na página 'Lançamentos', encontre o lançamento que pretende modificar.
• Clique no ícone de lápis para editar ou no ícone de caixote do lixo para eliminar.

A edição permite alterar as notas, o título ou os recursos. A eliminação remove o lançamento do GitHub, mas a etiqueta Git subjacente permanece.

Quais das seguintes opções são componentes ou características essenciais de um lançamento do GitHub?

Aprendeu a criar e gerir lançamentos do GitHub!

• Os lançamentos fornecem instantâneos formais e versionados do seu projeto.
• Baseiam-se em etiquetas do Git e incluem notas do lançamento e recursos opcionais.
• Pode criar, editar e eliminar lançamentos através da interface do GitHub.

Isso ajuda os utilizadores a encontrar e transferir facilmente versões estáveis do seu software.