Gerenciar versões em repositórios

Você pode criar versões para empacotar e entregar iterações de um projeto para os usuários.

Repository collaborators and people with write access to a repository can create, edit, and delete a release.

Sobre o gerenciamento da versão

Você pode criar novas versões com observações de versões, @menções de contribuidores e links para arquivos binários, bem como editar ou excluir versões existentes.

Você também pode publicar uma ação a partir de uma versão específica em GitHub Marketplace. Para obter mais informações, consulte "Publicar uma ação no GitHub Marketplace"

Você pode escolher se objetos Git Large File Storage (Git LFS) estão incluídos nos arquivos ZIP e tarballs que GitHub cria para cada versão. Para obter mais informações, consulte "

Gerenciando Git LFS objetos nos arquivos de seu repositório".

Criando uma versão

  1. No GitHub.com, navegue até a página principal do repositório.
  1. To the right of the list of files, click Releases. Seção de versões na barra lateral direita

  2. Clique em Draft a new release (Rascunhar uma nova versão).

    Releases draft button

  3. Click Choose a tag, type a version number for your release, and press Enter. Como alternativa, selecione um tag existente.

    Insira uma tag

  4. Se você estiver criando uma nova tag, clique em Criar nova tag.

    Confirme que você deseja criar uma nova tag

  1. Se você criou uma nova tag, use o menu suspenso para selecionar o branch que contém o projeto que você deseja liberar.

    Escolha um branch

  1. Digite um título e uma descrição para a sua versão.

    Se você @mencionar qualquer usuário de GitHub na descrição, a versão publicada incluirá uma seção de Colaboradores com uma lista de avatar de todos os usuários mencionados.

    Como alternativa, você pode gerar automaticamente as suas observações de versão, clicando em Gerar observações de versão automaticamente.

    Descrição das versões

  2. Opcionalmente, para incluir arquivos binários, como programas compilados em sua versão, arraste e solte ou selecione arquivos manualmente na caixa de binários. Fornecer um DMG com a versão

  3. Para notificar os usuários que a versão não está pronta para produção e pode ser instável, selecione This is a pre-release (Esta é uma versão prévia). Caixa de seleção para marcar uma versão como pré-versão

  4. Optionally, if GitHub Discussions are enabled in the repository, select Create a discussion for this release, then select the Category drop-down menu and click a category for the release discussion. Caixa de seleção para criar uma discussão de versão e menu suspenso para escolher uma categoria

  5. Se estiver pronto para tornar pública a sua versão, clique em Publish release (Publicar versão). Para trabalhar na versão posteriormente, clique em Save draft (Salvar rascunho). Botões Publish release (Publicar versão) e Draft release (Rascunhar versão)

    Você pode visualizar as suas versões publicadas ou rascunhos no feed de versões do seu repositório. Para obter mais informações, consulte "Visualizando versões e tags do seu repositório.

Versão publicada com contribuidores @mencionados

Para saber mais sobre GitHub CLI, consulte "Sobre GitHub CLI."

  1. Para criar uma versão, use o subcomando gh release create. Substitua tag pela tag desejada para a versão.
gh release create tag
  1. Siga as instruções interativas. Como alternativa, você pode especificar argumentos para pular essas instruções. Para obter mais informações sobre possíveis argumentos, consulte o manual de GitHub CLI. Por exemplo, este comando cria uma pré-versão com o título e observações especificadas.
gh release create v1.3.2 --title "v1.3.2 (beta)" --notes "this is a beta release" --prerelease

Se você @mencionar qualquer usuário de GitHub nas observações, a versão publicada em GitHub.com incluirá uma seção Colaboradores com uma lista de avatar de todos os usuários mencionados.

Editar uma versão

  1. No GitHub.com, navegue até a página principal do repositório.
  1. To the right of the list of files, click Releases. Seção de versões na barra lateral direita
  1. On the right side of the page, next to the release you want to edit, click . Editar uma versão
  1. Edite as informações da versão no formulário e, em seguida, clique em Atualizar versão. Se você adicionar ou remover quaisquer @menções de usuários do GitHub na descrição, esses usuários serão adicionados ou removidos da lista de avatares na seção Colaboradores da versão. Atualizar uma versão

As versões não podem ser editadas com GitHub CLI.

Excluir uma versão

  1. No GitHub.com, navegue até a página principal do repositório.
  1. To the right of the list of files, click Releases. Seção de versões na barra lateral direita
  1. On the right side of the page, next to the release you want to delete, click . Excluir uma versão
  1. Clique em Excluir esta versão. Confirmar exclusão da versão
  1. Para excluir uma versão, use o subcomando gh release delete. Substitua tag pela tag da versão a ser excluída. Use o sinalizador -y para ignorar a confirmação.
gh release delete tag -y

Esse documento ajudou você?

Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.