Requisitos

Antes de fazer o download e criar a origem do Android, verifique se o sistema atende aos requisitos a seguir e, então, consulte Como estabelecer um ambiente de build para ver instruções de instalação de acordo com o sistema operacional.

Requisitos de hardware

Sua estação de trabalho de desenvolvimento precisa atender ou exceder estes requisitos de hardware:

• Um ambiente de 64 bits é necessário para o Android 2.3.x (Gingerbread) e versões posteriores, incluindo a ramificação mestre. É possível compilar versões antigas em sistemas de 32 bits.
• Pelo menos 250 GB de espaço livre em disco para verificar o código e mais 150 GB para criá-lo. Se você for criar vários builds, precisará de mais espaço.
  Observação: se você estiver verificando um espelho, precisará de mais espaço, já que os espelhos completos do Android Open Source Project (AOSP) contêm todos os repositórios Git que já foram usados.
• Pelo menos 16 GB de RAM disponíveis, mas o Google recomenda 64 GB.

Desde junho de 2021, o Google usa máquinas de 72 núcleos com 64 GB de RAM interna, o que leva cerca de 40 minutos para criar um build completo e poucos minutos para criar builds incrementais, dependendo dos arquivos modificados. Já uma máquina de seis núcleos com uma quantidade de RAM semelhante leva três horas para fazer o mesmo.

Requisitos de software

A ramificação master do AOSP é tradicionalmente desenvolvida e testada em versões do Ubuntu com Suporte de Longo Prazo (LTS), mas outras distribuições podem ser usadas. Consulte Como estabelecer um ambiente de build para ver outros pacotes obrigatórios e os comandos para instalá-los.

Sua estação de trabalho precisa ter os softwares listados abaixo. Esses requisitos se aplicam à ramificação master do AOSP. Para as versões 8.0 (Oreo ou O) a 5.0 (Lollipop ou L) do Android, considere o uso do Dockerfile incluído para facilitar a instalação de todos os pacotes necessários. Para usar o método manual, consulte Como oferecer compatibilidade com versões anteriores.

SO

Se você está desenvolvendo com a ramificação master do AOSP, use o Ubuntu 18.04 (Bionic Beaver) (link em inglês).

Aviso: a partir de 22 de junho de 2021, NÃO será possível criar no Windows ou MacOS.

JDK

Como a ramificação master do Android no AOSP vem com uma versão pré-criada do OpenJDK, nenhuma outra instalação é necessária.

Versões mais antigas do Android exigem uma instalação separada do JDK. No Ubuntu, use o OpenJDK.

Pacotes principais

A ramificação principal do AOSP vem com uma versão pré-criada do Make. Portanto, nenhuma outra instalação é necessária. O Git é instalado de forma semelhante como parte do processo de Como estabelecer um ambiente de build.

Confira se o sistema tem o Python 3 (link em inglês).

Aviso: o suporte ao Python 2 foi descontinuado em 1.º de janeiro de 2020, conforme detalhado em Desativação do Python 2 (link em inglês). Todas as principais distribuições do Linux estão descontinuando o suporte ao pacote Python 2. O Google recomenda migrar todos os scripts para o Python 3.

Observação: o AOSP é enviado com as próprias cópias dos pacotes Python 2 e Python 3, e você pode usar a versão incluída na árvore de origem (como a SEPolicy). O Google está migrando todos os scripts da árvore de origem do Android para o Python 3, e a cópia incorporada do Python 2 pode ter sido descontinuada.

Para ver mais detalhes, consulte Portabilidade do código Python 2 para o Python 3 e as dicas para desativar seu código Python 2 (links em inglês).

Binários de dispositivos

Faça abaixo o download de visualizações, imagens de fábrica, drivers, atualizações over the air (OTA) e outros blobs. Para ver mais detalhes, consulte Adquirir binários reservados.

• Binários de visualização (blobs) para o desenvolvimento da ramificação master do AOSP
• Imagens de fábrica para dispositivos compatíveis que executam ramificações de versão marcadas do AOSP
• Arquivos binários de suporte a hardware para dispositivos que executam ramificações de versão com tags do AOSP

Conjunto de ferramentas de criação

O Android 8.0 e as versões posteriores são compatíveis apenas com o Clang/LLVM para criação da plataforma Android. Participe do grupo android-llvm para fazer perguntas e receber ajuda. Informe problemas de NDK/compilador no NDK GitHub.

Para o Kit de desenvolvimento nativo (NDK, na sigla em inglês) e os kernels legados, também é possível usar o GCC 4.9 incluído na ramificação master do AOSP (em prebuilts/).