Ferramentas de controle de origem

Trabalhar com código Android requer o uso do Git (um sistema de controle de versões de código aberto) e do Repo (uma ferramenta de gestão de repositório criada pelo Google e executada sobre o Git). Consulte a página Fluxo de trabalho de controle de origem para ver um resumo das ações regulares que você pode realizar, como upload de mudanças para revisão.

Git

O Git lida com grandes projetos distribuídos em vários repositórios. O Android usa o Git para operações locais, como ramificações, confirmações, diferenças e edições. Um dos desafios da configuração do projeto Android foi descobrir como oferecer o melhor apoio à comunidade externa, desde a comunidade de amadores até grandes OEMs que fabricam dispositivos de consumo para o mercado de massa. Queríamos componentes interessantes, que tivessem uma vida própria fora do Android, e que fossem substituíveis. Primeiro, escolhemos um sistema de controle de revisão distribuído e, em seguida, nós o limitamos ao Git.

Para ver mais detalhes sobre o Git, consulte a documentação dele (link em inglês).

Repo

O Repo unifica os repositórios do Git quando necessário, faz uploads para o sistema de controle de revisão Gerrit e automatiza partes do fluxo de trabalho de desenvolvimento do Android.

O Repo Launcher fornece um script Python que inicializa um checkout e faz o download da segunda parte, a ferramenta completa do Repo. A ferramenta completa do Repo está incluída no checkout de um código-fonte do Android. Por padrão, ele está localizado em $SRCDIR/.repo/repo/... e recebe comandos encaminhados do Repo Launcher transmitido por download.

O Repo não substitui o Git, ele só facilita trabalhar com o Git no contexto do Android. Ele usa arquivos de manifesto para agregar projetos do Git no superprojeto do Android. Coloque o comando repo, que é um script Python executável, em qualquer lugar do seu caminho. Ao trabalhar com os arquivos de origem do Android, você pode usar o Repo para operações em toda a rede, como com um único diretório de trabalho do Repo.

Na maioria das situações, é possível usar o Git em vez do Repo ou combinar os comandos de Repo e Git para formar comandos complexos. No entanto, usar o Repo para operações básicas em toda a rede facilita muito seu trabalho. Para ver mais detalhes sobre o Repo, consulte a Referência de comandos Repo, o README do Repo, os Hooks de pré-upload (testes) que podem ser ativados no Repo e os documentos gerais no AOSP.

Para fazer o download e instalar o Repo Launcher usando git-repo- downloads, consulte Como instalar o Repo.

Gerrit

O Gerrit é um sistema de análise de código baseado na Web para projetos que usam o Git. O Gerrit incentiva o uso mais centralizado do Git, permitindo que todos os usuários autorizados enviem mudanças, que são automaticamente mescladas se forem aprovadas na análise do código. Além disso, o Gerrit facilita a análise, exibindo as mudanças lado a lado no navegador e permitindo comentários in-line.

Veja a interface de análise Gerrit do Android em android-review.googlesource.com e a interface de navegação de código em android.googlesource.com.

Android Code Search

O Android Code Search permite pesquisar no AOSP sem precisar fazer o download de nada. Você pode usar o Code Search para ver o código-fonte do AOSP, alternar entre ramificações de código aberto e navegar por referências cruzadas. Para saber mais, consulte a documentação do Code Search no site do Google Developers.

Outras ferramentas

O Android Studio é o ambiente de desenvolvimento integrado (IDE) oficial para o desenvolvimento de apps Android.

O Android Debug Bridge (ADB) permite conectar sua estação de trabalho de desenvolvimento diretamente ao dispositivo Android para que você possa instalar pacotes e analisar as mudanças.

Para o Android 10 e versões mais recentes, use o ambiente de desenvolvimento integrado IntelliJ com AIDEgen para desenvolvimento com a Plataforma Android.

Como instalar o Repo

Siga estas etapas para instalar o Repo.

1. Execute estes comandos para usar o pacote oficial da sua distribuição do Linux:

     sudo apt-get update
     sudo apt-get install repo
   

   Se esses comandos não funcionarem no seu sistema, por exemplo, se você descobrir que a versão do pacote está desatualizada ou que não há um pacote oficial disponível na sua distribuição do Linux, instale o Repo manualmente usando os seguintes comandos:

   export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
   curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
   gpg --recv-key 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
   curl -s https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ${REPO} && install -m 755 ${REPO} ~/bin/repo
   

Esses comandos configuram um arquivo temporário, fazem o download do repositório e verificam se a chave fornecida corresponde à necessária. Se a operação for bem-sucedida, a instalação continuará normalmente.

Observação: as chaves estão registradas em keys.openpgp.org (link em inglês) e funcionam por padrão em distribuições baseadas no Debian. Se não for possível fazer o download da chave ou se a verificação falhar, consulte a documentação da distribuição para usar o Gnu Privacy Guard (GPG). Para ver outro recurso, consulte o site do GnuPG (link em inglês).

Após a instalação, verifique se a repo version gera um relatório semelhante ao seguinte quando a execução é feita em um diretório regular. O diretório regular não faz parte de um cliente Repo (por exemplo, seu diretório inicial).

2. Execute este comando:

repo version

3. Você verá um relatório semelhante a este:

<repo not installed>
repo launcher version 2.15
(from /usr/bin/repo)

• O número da repo launcher version aparecendo como 2.15 ou posterior indica um número de versão correto e a instalação adequada.
• (from /usr/bin/repo) indica a instalação de um pacote.
• (from /home/<>/bin/repo) indica a instalação manual.

Como concluir a instalação

Próximo: para concluir a instalação completa da ferramenta Repo, consulte Como inicializar um cliente do Repo, na página Como fazer o download da origem.