Ferramentas de controle de origem

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

Git

O Git lida com grandes projetos distribuídos em vários repositórios. O Android usa Git para operações locais, como ramificações locais, confirmações, diferenças e edições. Um dos desafios na criação do projeto Android foi determinar a melhor forma de apoiar a comunidade externa – desde a comunidade amadora até os grandes OEMs que criam dispositivos de consumo para o mercado de massa. O Google queria que os componentes fossem substituíveis e que componentes interessantes tivessem vida própria, fora do Android. O Google primeiro escolheu um sistema de controle de revisão distribuído e depois o restringiu ao Git.

Para obter mais detalhes sobre o Git, consulte esta documentação do Git .

Repositório

O Repo unifica os repositórios Git quando necessário, realiza 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 baixa a segunda parte, a ferramenta Repo completa. A ferramenta Repo completa está incluída na verificação do código-fonte do Android. Ele está localizado, por padrão, em $SRCDIR/.repo/repo/... e recebe comandos encaminhados do Repo Launcher baixado.

O Repo não substitui o Git, apenas facilita o trabalho com o Git no contexto do Android. O Repo usa arquivos de manifesto para agregar projetos Git ao superprojeto Android. Você pode colocar 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, você pode usar Git em vez de Repo ou misturar comandos Repo e Git para formar comandos complexos. No entanto, usar o Repo para operações básicas em toda a rede torna seu trabalho muito mais simples. Para obter mais detalhes sobre o Repo, consulte Repo Command Reference , Repo README , os Preupload Hooks (testes) que podem ser habilitados no Repo e documentos gerais no AOSP .

Para baixar e instalar o Repo Launcher do git-repo-downloads , consulte Instalando o Repo .

Gerrit

Gerrit é um sistema de revisão de código baseado na web para projetos que usam Git. Gerrit incentiva um uso mais centralizado do Git, permitindo que todos os usuários autorizados enviem alterações, que serão automaticamente mescladas se passarem na revisão do código. Além disso, Gerrit facilita a revisão, exibindo as alterações lado a lado no navegador e permitindo comentários embutidos.

Encontre a interface de revisão do Android Gerrit em android-review.googlesource.com e a interface de navegação de código em android.googlesource.com .

Pesquisa de código Android

Android Code Search permite pesquisar AOSP sem baixar nada. Você pode usar o Code Search para visualizar o código-fonte do AOSP, alternar entre ramificações de código aberto e navegar por referências cruzadas. Para obter mais informações, consulte o site do Google Developers para obter a documentação da pesquisa de código .

Outras ferramentas

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

O Android Debug Bridge (ADB) permite conectar sua estação de trabalho de desenvolvimento diretamente ao seu dispositivo Android para que você possa instalar pacotes e avaliar suas alterações.

Para desenvolvimento AOSP, use o Android Studio for Platform (ASfP) .

Instalando Repo

Siga estas etapas para instalar o Repo.

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

     sudo apt-get update
     sudo apt-get install repo
   

   Se esses comandos não funcionaram no seu sistema - por exemplo, você vê que a versão do pacote está desatualizada ou não há um pacote oficial disponível no seu Distribuição Linux, instale manualmente o Repo usando os seguintes comandos:

   export REPO=$(mktemp /tmp/repo.XXXXXXXXX)
   curl -o ${REPO} https://storage.googleapis.com/git-repo-downloads/repo
   gpg --recv-keys 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, baixam o repositório para ele e verificam se a chave fornecida corresponde à chave necessária. Se forem bem-sucedidos, a instalação prossegue.

Nota: As chaves são registradas em keys.openpgp.org e funcionam por padrão para distribuições baseadas em Debian. Se você não conseguir baixar a chave ou se a verificação falhar, consulte a documentação da sua distribuição para usar o Gnu Privacy Guard (GPG). Para obter um recurso adicional, consulte o site do GnuPG .

Após a instalação, verifique se repo version relata algo semelhante ao seguinte quando está sendo executado em um diretório normal. (Um diretório normal não faz parte de um cliente repo; por exemplo, é seu diretório inicial.)

2. Execute este comando:

repo version

3. Espere um relatório semelhante a este:

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

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

Concluindo a instalação

Próximo: Para concluir a instalação completa da ferramenta Repo, consulte Inicializando um cliente Repo , na página Baixando a fonte .