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 é executada sobre o Git). Consulte a página Fluxo de trabalho de controle do código -fonte 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 o Git para operações locais, como ramificação local, confirmações, diffs e edições. Um dos desafios na configuração do projeto Android foi determinar a melhor forma de oferecer suporte à comunidade externa, desde a comunidade de amadores até os grandes OEMs que constroem dispositivos de consumo de 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 .

recompra

Repo unifica 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 em um checkout de 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. Repo usa arquivos de manifesto para agregar projetos Git no 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 na 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 na rede torna seu trabalho muito mais simples. Para obter mais detalhes sobre o Repo, consulte Repo Command Reference , Repo README , Preupload Hooks (testes) que podem ser ativados no Repo e documentos gerais no AOSP .

Para baixar e instalar o Repo Launcher a partir de 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. A Gerrit incentiva um uso mais centralizado do Git, permitindo que todos os usuários autorizados enviem alterações, que são mescladas automaticamente se passarem na revisão do código. Além disso, o 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 do Android

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

Outras ferramentas

O Android Studio é o ambiente de desenvolvimento integrado (IDE) oficial para o 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 Android 10 e superior, use o IntelliJ com AIDEgen IDE para desenvolvimento da plataforma Android.

Instalando o 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 funcionarem para o 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-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, baixam o repositório para ele e verificam se a chave fornecida corresponde à chave necessária. Se forem bem-sucedidos, a instalação continua.

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 a repo version relata algo semelhante ao seguinte quando está em execução em um diretório regular. (Um diretório regular não faz parte de um cliente de repositório; 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 relatório do número da repo launcher version como 2.15 ou superior indica um número de versão correto e uma 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

A seguir: para concluir a instalação completa da ferramenta Repo, consulte Inicializando um cliente Repo , na página Fazendo download do código-fonte .