{"meta":{"title":"Gerenciar versões em repositórios","intro":"Você pode criar versões para empacotar e entregar iterações de um projeto para os usuários.","product":"Repositórios","breadcrumbs":[{"href":"/pt/repositories","title":"Repositórios"},{"href":"/pt/repositories/releasing-projects-on-github","title":"Lançar projetos"},{"href":"/pt/repositories/releasing-projects-on-github/managing-releases-in-a-repository","title":"Gerenciar lançamentos"}],"documentType":"article"},"body":"# Gerenciar versões em repositórios\n\nVocê pode criar versões para empacotar e entregar iterações de um projeto para os usuários.\n\n## Sobre o gerenciamento de lançamentos\n\nVocê pode criar novas versões com notas de lançamento, @mentions de colaboradores e links para arquivos binários, além de editar ou excluir as versões existentes. Você também pode criar, modificar e excluir versões usando a API de Versões. Para saber mais, confira [Pontos de extremidade da API REST para versões](/pt/rest/releases/releases) na documentação da API REST.\n\nVocê também pode publicar uma ação de uma versão específica em GitHub Marketplace. Para saber mais, confira [Publicar ações no GitHub Marketplace](/pt/actions/how-tos/create-and-publish-actions/publish-in-github-marketplace).\n\nVocê pode escolher se os objetos Armazenamento de Arquivos Grandes do Git (Git LFS) serão incluídos nos arquivos ZIP e arquivos tar que GitHub cria para cada lançamento. Para saber mais, confira [Gerenciando objetos LFS do Git em arquivos do seu repositório](/pt/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-git-lfs-objects-in-archives-of-your-repository).\n\n## Criando um release\n\n> \\[!TIP]\n> Se você habilitou releases imutáveis para seu repositório, é recomendável criar releases como rascunhos primeiro, anexar todos os elementos e, em seguida, publicar. Isso garante que todos os ativos estejam no lugar antes que a versão se torne imutável. Para saber mais, confira [Versões imutáveis](/pt/code-security/concepts/supply-chain-security/immutable-releases).\n\n\n\n1. Em GitHub, acesse a página principal do repositório.\n2. À direita da lista de arquivos, clique em **Versões**.\n\n \n3. Na parte superior da página, clique em **Rascunho de uma nova versão**.\n4. Para escolher uma tag para a versão, selecione o menu suspenso **Escolher uma marca**.\n * Para usar uma tag existente, clique na tag.\n * Para criar uma nova tag, digite um número de versão para sua versão e clique em **Criar tag**.\n5. Se você criou uma nova tag, selecione o menu suspenso **Destino** e clique no branch que contém o projeto que você deseja liberar.\n6. Opcionalmente, acima do campo de descrição, selecione o menu suspenso **Tag anterior** e clique na tag que identifica a versão anterior.\n\n \n7. No campo \"Título da versão\", digite um título para sua versão.\n8. No campo \"Descrever esta versão\", digite uma descrição para sua versão.\n Se você mencionar alguém com @mention na descrição, a versão publicada incluirá uma seção **Colaboradores** com uma lista dos avatares de todos os usuários mencionados.\n Como alternativa, você pode gerar automaticamente as notas de lançamento clicando em **Gerar notas de lançamento**.\n9. 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.\n10. Opcionalmente, para notificar os usuários de que a versão não está pronta para produção e pode ser instável, selecione **Este é um pré-lançamento**.\n11. Opcionalmente, selecione **Definir como versão mais recente**. Se você não selecionar essa opção, o rótulo de última versão será atribuído automaticamente com base no controle de versão semântico.\n12. Opcionalmente, se GitHub Discussions estiver habilitado para o repositório, crie uma discussão para o lançamento.\n * Selecione **Criar uma discussão para esta versão**.\n * Selecione o menu suspenso **Categoria**, depois clique numa categoria para a discussão de lançamento.\n13. Se estiver pronto para tornar sua versão pública, clique em **Publicar versão**. Para trabalhar na versão posteriormente, clique em **Salvar rascunho**.\n Depois, você poderá ver as versões publicadas ou de rascunho no feed de versões do repositório. Para saber mais, confira [Visualizando releases e tags do seu repositório](/pt/repositories/releasing-projects-on-github/viewing-your-repositorys-releases-and-tags).\n\n
\n\n\n\n> \\[!NOTE]\n> Para saber mais sobre GitHub CLI, confira [Sobre GitHub CLI](/pt/github-cli/github-cli/about-github-cli).\n\n1. Para criar uma versão, use o subcomando `gh release create`. Substitua `tag` pela tag desejada para o release.\n\n ```shell\n gh release create TAG\n ```\n\n2. 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 GitHub CLI manual](https://cli.github.com/manual/gh_release_create). Por exemplo, este comando cria uma pré-versão com o título e observações especificadas.\n\n \n\n```shell\ngh release create v1.3.2 --title \"v1.3.2 (beta)\" --notes \"this is a prévia pública release\" --prerelease\n```\n\n\n\nSe você @mention mencionar algum GitHub usuário nas notas, a versão publicada incluirá uma seção **Colaboradores** com uma lista de avatares de todos os usuários mencionados.\n\n
\n\n## Editar um lançamento\n\n> \\[!NOTE]\n> Se você tiver habilitado versões imutáveis para seu repositório, só poderá editar o título e as notas de versão depois que uma versão for publicada. Confira [Versões imutáveis](/pt/code-security/concepts/supply-chain-security/immutable-releases).\n\n\n\n\n\n1. Para editar uma versão, use o subcomando `gh release edit`. Substitua `TAG` pela tag que representa a versão que você deseja editar. Por exemplo, para editar o título de uma versão, use o seguinte código, substituindo `NEW-TITLE` pelo título atualizado:\n\n ```shell\n gh release edit TAG -t \"NEW-TITLE\"\n ```\n\n Para obter mais informações sobre possíveis argumentos, consulte [o GitHub CLI manual](https://cli.github.com/manual/gh_release_edit).\n\n
\n\n## Excluir uma versão\n\n\n\n\n\n1. 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.\n\n ```shell\n gh release delete TAG -y\n ```\n\n
"}