Skip to main content

Sobre as versões

Você pode criar uma versão de modo a empacotar software, com notas de versão e links para arquivos binários, para uso de outras pessoas.

Sobre as versões

Versões são iterações de software implementáveis que você pode empacotar e disponibilizar para um público mais amplo para baixar e usar.

As versões são baseadas em tags do Git, que marcam um ponto específico no histórico do repositório. Uma data de tag pode ser diferente de uma data de versão, já que elas podem ser criadas em momentos diferentes. Para obter mais informações sobre como exibir suas marcas existentes, confira "Visualizando versões e tags do seu repositório".

Você pode receber notificações quando novas versões são publicadas em um repositório sem receber notificações sobre outras atualizações para o repositório. Para obter mais informações, confira "Visualizando suas assinaturas".

Qualquer pessoa com acesso de leitura a um repositório pode ver e comparar versões, mas somente pessoas com permissões de gravação a um repositório podem gerenciar versões. Para obter mais informações, confira "Gerenciar versões em repositórios".

Você pode criar manualmente notas sobre a versão enquanto gerencia uma versão. Como alternativa, você pode gerar automaticamente notas de versão a partir de um modelo padrão, ou personalizar seu próprio modelo de notas de versão. Para obter mais informações, confira "Notas de versão geradas automaticamente".

Ao exibir os detalhes de uma versão, a data de criação de cada ativo da versão será mostrada ao lado dele.

O GitHub incluirá automaticamente links para baixar um arquivo zip e um tarball contendo o conteúdo do repositório no ponto de criação da tag.

Pessoas com permissões de administrador em um repositório podem escolher se os objetos do Git Large File Storage (Git LFS) estão incluídos nos arquivos ZIP e tarballs que o GitHub cria para cada versão. Para obter mais informações, confira "Gerenciando objetos LFS do Git em arquivos do seu repositório".

Se uma versão consertar uma vulnerabilidade de segurança, você deverá publicar uma consultoria de segurança no seu repositório. GitHub revisa a cada consultoria de segurança publicado e pode usá-lo para enviar Dependabot alerts para repositórios afetados. Para obter mais informações, confira "Sobre os avisos de segurança do repositório".

Veja a guia Dependentes do grafo de dependência para saber quais repositórios e pacotes dependem do código no seu repositório e, que, portanto, podem ser afetados por uma nova versão. Para obter mais informações, confira "Sobre o gráfico de dependências".

Você também pode usar a API de Releases para reunir informações, tais como o número de vezes que as pessoas baixam um ativo de versão. Para obter mais informações, confira "Pontos de extremidade da API REST para lançamentos e ativos de lançamento".

Cotas de armazenamento e banda

Cada arquivo incluído em uma versão deve ser inferior a 2 GiB. Não há limite para o tamanho total de uma versão, nem uso de largura de banda.