Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

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 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 Escolha uma tag, digite o número de uma versão para a sua versão e pressione 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

  2. Optionally, to the top right of the description text box, select the Previous tag drop-down menu and click the tag that identifies the previous release. Screenshot showing how to select a tag to identify the previous release

  3. 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.

    Alternatively, you can automatically generate your release notes by clicking Generate release notes.

    Descrição das versões

  4. 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

  5. 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

  6. Opcionalmente, se GitHub Discussions estiver habilitado no repositório, selecione Criar uma discussão para esta versão e, em seguida, selecione o menu suspenso Categoria e clique em uma categoria para a discussão de da versão. Caixa de seleção para criar uma discussão de versão e menu suspenso para escolher uma categoria

  7. 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. No lado direito da página, ao lado da versão que deseja editar, clique em . 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. No lado direito da página, ao lado da versão que você deseja excluir, clique em . 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