{"meta":{"title":"Como baixar arquivos de código-fonte","intro":"Você pode baixar um instantâneo do código em seu repositório.","product":"Repositórios","breadcrumbs":[{"href":"/pt/repositories","title":"Repositórios"},{"href":"/pt/repositories/working-with-files","title":"Trabalhar com arquivos"},{"href":"/pt/repositories/working-with-files/using-files","title":"Usando arquivos"},{"href":"/pt/repositories/working-with-files/using-files/downloading-source-code-archives","title":"Arquivos de código-fonte"}],"documentType":"article"},"body":"# Como baixar arquivos de código-fonte\n\nVocê pode baixar um instantâneo do código em seu repositório.\n\n## Visão geral dos arquivos de código-fonte\n\nVocê pode baixar um snapshot de qualquer branch, tag ou commit específico de GitHub. Esses instantâneos são gerados pelo comando [`git archive`](https://git-scm.com/docs/git-archive) em um dos dois formatos: tarball ou zipball. Os instantâneos não contêm todo o histórico do repositório. Para obter todo o histórico, você pode clonar o repositório. Para saber mais, confira [Clonar um repositório](/pt/repositories/creating-and-managing-repositories/cloning-a-repository).\n\n## Como baixar arquivos de código-fonte\n\nVocê pode baixar os arquivos do código-fonte de três maneiras.\n\n### Baixando arquivos de código-fonte da visão do repositório\n\n1. Em GitHub, acesse a página principal do repositório.\n2. Acima da lista de arquivos, clique em ** Code**.\n\n \n3. Clique em ** Download ZIP**.\n\n### Baixando arquivos de código-fonte de uma versão\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. Desça até a seção \"Ativos\" do lançamento.\n4. Para baixar o código-fonte, clique em ** Source code (zip)** ou ** Source code (tar.gz)**.\n\n### Baixando arquivos de código-fonte de um tag\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 Lançamentos, clique em **Tags**.\n4. Para baixar o código-fonte, clique em ** zip** ou ** tar.gz**.\n\n \n\n## URLs de arquivos do código-fonte\n\nOs arquivos de código-fonte estão disponíveis em URLs específicas para cada repositório. Por exemplo, considere o repositório `github/codeql`. Existem URLs diferentes para baixar um branch, um tag ou um ID de commit específico.\n\n| Tipos de arquivos | Exemplo | URL |\n| ------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | --- |\n| ramo | `main` | |\n| \\[ | | |\n| | | |\n| **heads/main**.tar.gz]\\() | | |\n| Tag | `codeql-cli/v2.12.0` | |\n| \\[ | | |\n| | | |\n| **tags/codeql-cli/v2.12.0**.zip]\\() | | |\n| Confirmar | `aef66c4` | |\n| \\[ | | |\n| | | |\n| **aef66c462abe817e33aad91d97aa782a1e2ad2c7**.zip]\\() | | |\n\n> \\[!NOTE]\n> Você pode usar `.zip` ou `.tar.gz` nos URLs acima para solicitar um arquivo zipball ou tarball, respectivamente.\n\n## Estabilidade dos arquivos de código-fonte\n\nOs arquivos de código-fonte são gerados na solicitação, armazenados em cache por um tempo e, em seguida, excluídos. Se o mesmo arquivo for solicitado novamente no futuro, ele será regenerado. É importante entender o que o GitHub faz para garantir os arquivos de código-fonte.\n\n* Um arquivo de uma ID de confirmação sempre terá o mesmo conteúdo de arquivo sempre que for solicitado, assumindo que a ID de confirmação ainda está no repositório e que o nome do repositório não foi alterado.\n* Como branches e marcas podem ser movidos para diferentes IDs de confirmação, os downloads futuros de um arquivo podem ter conteúdos diferentes dos arquivos baixados anteriormente do mesmo branch ou marca. Supondo que o branch ou a marca ainda aponte para a mesma ID de confirmação, ele terá o mesmo conteúdo do arquivo.\n* As configurações exatas de compactação usadas para gerar um zipball ou tarball podem ser alteradas ao longo do tempo. O conteúdo extraído não será alterado se o branch ou a tag não forem alterados, mas o arquivo compactado externo poderá ter um layout de bytes diferente. GitHub fornecerá pelo menos seis meses de aviso prévio antes de alterar as configurações de compactação.\n* O nome do repositório faz parte da estrutura de diretório dentro do arquivo. Portanto, se o nome do repositório for alterado, o nome do diretório raiz também será alterado.\n\nSe você depender da estabilidade dos arquivos de código-fonte para reprodutibilidade (garantindo que você sempre obtenha arquivos idênticos dentro do arquivo), recomendamos usar a [API REST de arquivos](/pt/rest/repos/contents#download-a-repository-archive-tar) com uma ID de confirmação do `:ref`. O uso da ID de confirmação garante que você sempre obtenha o mesmo conteúdo de arquivo dentro do arquivo e esteja imune à reescrita de marcas por repositórios ou à movimentação de cabeçalhos de branch.\n\nSe você depender da estabilidade dos arquivos para segurança (por exemplo: para garantir que não tente descompactar um arquivo mal-intencionado), recomendamos usar versões em vez de usar downloads de origem. Para saber mais, confira [Sobre os lançamentos](/pt/repositories/releasing-projects-on-github/about-releases).\n\nVocê pode usar algo como [essa ação de GitHub de terceiros](https://github.com/softprops/action-gh-release) para criar e efetuar push desses arquivos como parte do processo de lançamento. A [API REST de Ativos de Liberação](/pt/rest/releases/assets#get-a-release-asset) pode ser usada posteriormente para recuperá-los."}