Siga estas instruções para começar a compilar para Android.
Como configurar o ambiente
Inicialize o ambiente com o script envsetup.sh
:
source build/envsetup.sh
ou
. build/envsetup.sh
Veja descrições de comandos relacionados no script em platform/build/envsetup.sh, incluindo lunch para escolher os dispositivos de destino e tapas para criar novos apps desagrupados, como o app de TV de referência.
É necessário reemitir esse comando após cada repo sync
para detectar
as mudanças nesse script. Observe que a substituição de source
por .
(um único
ponto) economiza alguns caracteres, e o formato curto é mais comumente usado na documentação.
O script envsetup.sh
importa vários comandos que permitem
trabalhar com o código-fonte do Android, incluindo os comandos usados neste
exercício.
Para ver a lista completa dos comandos disponíveis, execute:
hmm
Como escolher um destino
lunch
Escolha qual destino criar com o lunch
. lunch
product_name-build_variant
seleciona
product_name como o produto a ser criado e build_variant
como a variante a ser criada, e armazena essas seleções no ambiente que será
lido por invocações subsequentes de m
e outros comandos parecidos.
A configuração exata pode ser passada como um argumento. Por exemplo, o comando a seguir se refere a uma versão completa para o emulador, com toda a depuração ativada:
lunch aosp_arm-eng
Se executado sem argumentos, lunch
solicitará que você escolha um
destino no menu. Consulte
Como selecionar
uma compilação do dispositivo para ver as configurações de compilação de todos os dispositivos existentes.
Todos os destinos da versão assumem o formato BUILD-BUILDTYPE
, em que
BUILD
é um codinome referente à combinação específica
de recursos. BUILDTYPE
é uma das opções a seguir.
Tipo da versão | Uso |
---|---|
user | Acesso limitado; adequado para produção |
userdebug | Como o user, mas com acesso root e capacidade de depuração; mais indicado para depuração |
eng | Configuração de desenvolvimento com outras ferramentas de depuração |
A versão userdebug precisa se comportar da mesma forma que a user, com a capacidade de ativar depuração adicional, que normalmente viola o modelo de segurança da plataforma. Isso faz com que userdebug seja uma boa versão para testes de usuários com maiores recursos de diagnóstico. Ao desenvolver com a versão userdebug, siga as diretrizes do userdebug.
A versão eng prioriza a produtividade de engenharia para engenheiros que trabalham na plataforma. Ela desativa várias otimizações usadas para fornecer uma boa experiência ao usuário. Fora isso, o build eng apresenta um comportamento semelhante ao dos builds user e userdebug, para que os desenvolvedores de dispositivos possam ver como o código se comporta nesses ambientes.
Para ver mais informações sobre como criar e executar em hardwares reais, consulte Como atualizar dispositivos.
tapas
O comando tapas
configura o build de apps desagrupados. Ele seleciona apps individuais
para serem criados pelo sistema de compilação do Android. Ao contrário de lunch
, tapas
não
solicita a criação de imagens para um dispositivo.
Execute tapas help
para ver mais informações sobre o comando.
Como compilar o código
Esta seção é um breve resumo para garantir que a configuração esteja concluída.
Crie tudo com m
. m
pode manipular tarefas paralelas com um argumento -jN
. Se você não fornecer um argumento -j
, o sistema de compilação selecionará automaticamente uma contagem de tarefas paralelas que julgar ser ideal para seu sistema.
m
Como explicado acima, você pode compilar módulos específicos em vez da imagem completa do dispositivo listando os nomes dos módulos na sua linha de comando m
. Além disso, m
oferece alguns pseudodestinos para fins especiais. Alguns exemplos:
droid
:m droid
é a compilação normal. Esse destino está aqui porque o destino padrão requer um nome.all
:m all
compila tudo o quem droid
faz, além de tudo que não tem a tagdroid
. O servidor de compilação o executa para garantir que tudo que está na árvore e tem um arquivoAndroid.mk
seja compilado.m
: executa builds do topo da árvore. Isso é útil porque você pode executar omake
dentro de subdiretórios. Se você tiver a variável de ambienteTOP
definida, ela será usada. Se você não tiver, o comando buscará a árvore no diretório atual para encontrar o topo dela. Você pode compilar toda a árvore de código-fonte executandom
sem argumentos ou compilar destinos específicos definindo os nomes deles.mma
: compila todos os módulos no diretório atual e nas dependências.mmma
: compila todos os módulos nos diretórios fornecidos e as respectivas dependências.croot
:cd
para o topo da árvore.clean
:m clean
exclui todos os arquivos de saída e intermediários para esta configuração. Ele é o mesmo querm -rf out/
.
Execute m help
para ver o que outros pseudodestinos m
oferecem.
Como executar o build
Você pode executar seu build em um emulador ou atualizá-lo em um dispositivo.
Como você já selecionou o destino de compilação com lunch
,
é improvável que ele seja executado em um destino diferente daquele para o qual foi criado.
Como realizar uma atualização com fastboot
Para realizar a atualização de um dispositivo, use fastboot
, que precisa
ser incluído no seu caminho após o build ser concluído. Consulte Como realizar uma atualização em um dispositivo para ver mais instruções.
Como emular um dispositivo Android
O emulador é adicionado ao seu caminho automaticamente pelo processo de criação. Para executá-lo, digite:
emulator
Como solucionar erros de criação comuns
Versão incorreta do Java
Caso você esteja tentando criar uma versão do Android que seja inconsistente com sua versão do Java, make
cancelará a tentativa com uma mensagem como:
************************************************************ You are attempting to build with the incorrect version of java. Your version is: WRONG_VERSION. The correct version is: RIGHT_VERSION. Please follow the machine setup instructions at https://source.android.com/source/initializing.html ************************************************************
Estas são as prováveis causas e soluções:
- Falha ao instalar o JDK correto conforme especificado nos requisitos do JDK. É necessário seguir as etapas apresentadas em Como configurar o ambiente e Como escolher um destino.
- Outro JDK instalado anteriormente aparece no seu caminho. Inclua o JDK correto no início do seu caminho ou remova o JDK problemático.
Versão 3 do Python
O Repo foi projetado com uma funcionalidade específica do Python 2.x e é incompatível com o Python 3. Para usar o Repo, instale o Python 2.x:
apt-get install python
Sistema de arquivos indiferente a maiúsculas
Se você estiver criando em um sistema de arquivos HFS no macOS, poderá encontrar um erro como:
************************************************************ You are building on a case-insensitive filesystem. Please move your source tree to a case-sensitive filesystem. ************************************************************
Siga as instruções em Como criar uma imagem de disco com diferenciação entre maiúsculas e minúsculas.
Sem permissão para USB
Na maioria dos sistemas Linux, por padrão, os usuários sem privilégios não podem acessar as portas USB. Se você encontrar um erro de permissão negada, siga as instruções em Como configurar o acesso por USB.
Se o adb já estava em execução e não consegue se conectar ao dispositivo
após a configuração dessas regras, você pode eliminá-lo com adb kill-server
.
Esse comando faz com que o adb seja reiniciado com a nova configuração.