A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.
Configurar para desenvolvimento em AOSP (9.0 ou mais recente)
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Antes de fazer o download e criar a ramificação main da origem do Android, confira se
o hardware atende aos requisitos e se o software necessário
está instalado corretamente. Você também precisa conhecer estes termos:
Git
O Git é um sistema de controle de versões distribuído, de código aberto e gratuito.
O Android usa o Git para operações locais, como ramificações,
commits, diferenças e edições. Para aprender a usar o Git, consulte a documentação relevante (em inglês).
Repo
Repo é um wrapper Python baseado no Git que simplifica a execução
de operações complexas em vários repositórios Git. O Repo não substitui o Git
para todas as operações de controle de versões, apenas facilita operações complexas do
Git. Ele usa arquivos de manifesto para agregar projetos do Git no
superprojeto do Android.
Arquivo de manifesto
Um arquivo de manifesto é um arquivo XML que especifica onde os vários projetos Git na
origem do Android são posicionados na árvore de origem do AOSP.
Atender aos requisitos de hardware
Sua estação de trabalho de desenvolvimento precisa atender ou exceder estes requisitos
de hardware:
Um sistema x86 de 64 bits.
Pelo menos 400 GB de espaço livre em disco para verificar e criar o código
(250 GB para verificar + 150 GB para criar).
Mínimo de 64 GB de RAM. O Google usa máquinas de 72 núcleos com 64 GB
de RAM para criar para o Android. Com essa configuração de hardware, é necessário
aproximadamente 40 minutos para um build completo do Android e apenas alguns minutos para um build incremental do Android. Por outro lado, leva aproximadamente 6 horas para um
build completo com uma máquina de 6 núcleos com 64 GB de RAM.
Atender aos requisitos do sistema operacional
Sua estação de trabalho de desenvolvimento precisa executar uma distribuição de Linux de 64 bits com a biblioteca GNU C
(glibc) 2.17 ou mais recente.
Instalar os pacotes necessários
Para criar para o Android 11 ou mais recente, você precisa usar o Ubuntu 18.04 ou mais recente. Para instalar os
pacotes necessários para Ubuntu 18.04 ou mais recente, execute este comando:
Dentre os pacotes instalados, este comando instala o Git, que é utilizado para
fazer o download da origem AOSP.
Instalar o software necessário
Antes de poder trabalhar com AOSP, você precisa instalar o
OpenJDK, Make, Python 3 e Repo. A principal ramificação AOSP do Android vem com
versões pré-criadas do OpenJDK, Make e Python 3. Etapas extra de instalação
não são necessárias. A seção abaixo explica como instalar o Repo.
Instalar o Repo
Siga estas etapas para instalar o Repo:
Faça o download das informações do pacote atual:
sudoapt-getupdate
Execute o comando abaixo para instalar o inicializador do Repo:
sudoapt-getinstallrepo
O inicializador do Repo fornece um script Python que faz o download e a instalação da ferramenta do Repo completa.
Se isso der certo, pule para a etapa 4.
(opcional) Instale manualmente o Repo usando estes comandos:
Os três primeiros comandos configuram um arquivo temporário, fazem o download do Repo para o arquivo e
verificam se a chave fornecida corresponde à chave necessária. Se os comandos tiverem
sucesso, o comando final vai instalar o inicializador do Repo.
Confira a versão do inicializador do Repo:
repoversion
A saída precisa indicar a versão 2.4 ou mais recente. Por exemplo:
repo launcher version 2.45
Definir um diretório de saída alternativo
Por padrão, a saída de cada build é armazenada no subdiretório out/
da árvore de origem correspondente. É possível mudar esse diretório exportando
a variável de ambiente OUT_DIR. Por exemplo, se você quiser armazenar a saída
em uma unidade diferente, aponte OUT_DIR para essa unidade:
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-04-04 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-04-04 UTC."],[],[],null,["# Set up for AOSP development (9.0 or later)\n\nBefore you download and build the Android latest release branch\n(android16-release) of the Android source, ensure\nthat your hardware meets the necessary requirements and that required software\nis properly installed. You should also be familiar with the following terms:\n\n*Git*\n: Git is a free and open source distributed version control system.\n Android uses Git for local operations such as branching, commits, diffs,\n and edits. For help learning Git, refer to the [Git documentation](https://git-scm.com/doc).\n\n*Repo*\n: Repo is a Python wrapper around Git that simplifies performing\n complex operations across multiple Git repositories. Repo doesn't replace Git\n for all version control operations, it only makes complex Git operations easier\n to accomplish. Repo uses manifest files to aggregate Git projects into the\n Android superproject.\n\n*Manifest file*\n: A manifest file is an XML file specifying where the various Git projects in\n the Android source are placed within an AOSP source tree.\n| **Note:** All commands in this documentation are preceded by a dollar sign ($) to differentiate them from output or entries within files. To copy a command to the clipboard, click the **Copy code sample** icon in the top right of each command box.\n| **Note:** If you want to build Android 2.3 - 8.0, refer to [Set up for AOSP development (2.3 - 8.0)](/docs/setup/start/older-versions).\n\nMeet hardware requirements\n--------------------------\n\nYour development workstation should meet or exceed these hardware\nrequirements:\n\n- A 64-bit x86 system.\n\n | **Note:** You can compile AOSP versions previous to 2.3.x on 32-bit systems.\n- At least 400 GB of free disk space to check out and build the code\n (250 GB to check out + 150 GB to build).\n\n | **Note:** If you're checking out a mirror, you need more space because the full Android Open Source Project (AOSP) mirrors contain all Git repositories that have ever been used.\n- A minimum of 64 GB of RAM. Google uses 72-core machines with 64 GB\n of RAM to build Android. With this hardware configuration, it takes\n approximately 40 minutes for a full build of Android and only a few minutes for incremental build of Android. By contrast, it takes approximately 6 hours for a\n full build with a 6-core machine with 64 GB of RAM.\n\nMeet operating system requirements\n----------------------------------\n\nYour development workstation must run any 64-bit Linux distribution with GNU C\nLibrary (glibc) 2.17 or later.\n| **Warning:** Android OS development on macOS isn't supported as of June 22, 2021 (Android 11). For information on configuring your development workstation for macOS, refer to [Set Up for AOSP development (2.3 - 8.0)](/docs/setup/start/older-versions).\n\nInstall required packages\n-------------------------\n\nTo build Android 11 or higher, you must use Ubuntu 18.04 or later. To install\nrequired packages for Ubuntu 18.04 or later, run the following command: \n\n sudo apt-get install git-core gnupg flex bison build-essential zip curl zlib1g-dev libc6-dev-i386 x11proto-core-dev libx11-dev lib32z1-dev libgl1-mesa-dev libxml2-utils xsltproc unzip fontconfig\n\nAmong the packages installed, this command installs Git, which is used to\ndownload the AOSP source.\n| **Note:** This command works for Ubuntu 18.04 or later. For package installation for earlier versions of Ubuntu, see [Setup for Android development (AOSP 2.3 - 8)](/docs/setup/start/older-versions).\n\nInstall required software\n-------------------------\n\nBefore you can work with AOSP, you must have installations of OpenJDK, Make,\nPython 3, and Repo. The latest release branch of Android comes with prebuilt\nversions of OpenJDK, Make, and Python 3, so additional installation steps aren't\nrequired. The following section explains how to install Repo.\n\n### Install Repo\n\nFollow these steps to install Repo:\n\n1. Download the current package information:\n\n sudo apt-get update\n\n2. Run the following command to install the Repo launcher:\n\n sudo apt-get install repo\n\n The Repo launcher provides a Python script that initializes a checkout\n and downloads the full Repo tool.\n\n If successful, skip to step 4.\n3. (optional) Manually install Repo using the following series of commands:\n\n export REPO=$(mktemp /tmp/repo.XXXXXXXXX)\n curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo\n gpg --recv-keys 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65\n curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo\n\n The first three commands set up a temp file, download Repo to the file, and\n verify that the key provided matches the required key. If these commands are\n successful, the final command installs the Repo launcher.\n4. Verify the Repo launcher version:\n\n repo version\n\n The output should indicate a version of 2.4 or higher, for example:\n\n `repo launcher version 2.45`\n\nSet an alternative output directory\n-----------------------------------\n\nBy default, the output of each build is stored in the `out/` subdirectory of\nthe matching source tree. You can override this directory by exporting the\n`OUT_DIR` environment variable. For example, if you want to store your output\non a different drive, you can point `OUT_DIR` to that drive: \n\n export OUT_DIR=\u003cvar translate=\"no\"\u003emy_other_drive\u003c/var\u003e\n\nWhat's next?\n------------\n\n- To download the source code, continue to [Download the Android source](/docs/setup/download).\n- For help learning Git, see the [Git documentation](https://git-scm.com/doc).\n- For additional Repo documentation, see the [Repo README](https://gerrit.googlesource.com/git-repo/+/refs/heads/main/README.md).\n- For a list of all Repo commands, refer to the [Repo command reference](/docs/setup/reference/repo)."]]
