Outils de contrôle des sources

Travailler avec du code Android nécessite d'utiliser à la fois Git (un système de contrôle de version open source) et Repo (un outil de gestion de référentiel créé par Google qui s'exécute sur Git). Consultez la page Flux de travail de contrôle de code source pour un résumé des actions régulières que vous pouvez effectuer, telles que le téléchargement de modifications pour révision.

Git

Git gère de grands projets distribués sur plusieurs référentiels. Android utilise Git pour les opérations locales telles que les branchements locaux, les validations, les différences et les modifications. L'un des défis liés à la mise en place du projet Android consistait à déterminer la meilleure manière de soutenir la communauté externe, depuis la communauté des amateurs jusqu'aux grands équipementiers fabriquant des appareils grand public grand public. Google souhaitait que les composants soient remplaçables et que les composants intéressants aient leur propre vie, en dehors d'Android. Google a d'abord choisi un système de contrôle de révision distribué, puis l'a réduit à Git.

Pour plus de détails sur Git, reportez-vous à cette documentation Git .

Repo

Repo unifie les référentiels Git si nécessaire, effectue des téléchargements vers le système de contrôle des révisions Gerrit et automatise certaines parties du flux de travail de développement Android.

Le Repo Launcher fournit un script Python qui initialise une extraction et télécharge la deuxième partie, l'outil Repo complet. L'outil Repo complet est inclus dans une extraction de code source Android. Il se trouve, par défaut, dans $SRCDIR/.repo/repo/... et il reçoit les commandes transférées du Repo Launcher téléchargé.

Repo ne remplace pas Git, il facilite simplement le travail avec Git dans le contexte d'Android. Repo utilise des fichiers manifestes pour regrouper les projets Git dans le superprojet Android. Vous pouvez placer la commande repo , qui est un script Python exécutable, n'importe où sur votre chemin. En travaillant avec les fichiers sources Android, vous pouvez utiliser Repo pour des opérations sur l'ensemble du réseau, par exemple avec un seul répertoire de travail Repo.

Dans la plupart des situations, vous pouvez utiliser Git au lieu de Repo, ou mélanger les commandes Repo et Git pour former des commandes complexes. Cependant, l'utilisation de Repo pour les opérations de base sur l'ensemble du réseau rend votre travail beaucoup plus simple. Pour plus de détails sur Repo, consultez le Repo Command Reference , Repo README , les Preupload Hooks (tests) qui peuvent être activés dans Repo et la documentation générale dans AOSP .

Pour télécharger et installer le Repo Launcher à partir de git-repo-downloads , consultez Installation de Repo .

Gerrit

Gerrit est un système de révision de code basé sur le Web pour les projets utilisant Git. Gerrit encourage une utilisation plus centralisée de Git en permettant à tous les utilisateurs autorisés de soumettre des modifications, qui sont automatiquement fusionnées si elles réussissent la révision du code. De plus, Gerrit facilite la révision, en affichant les modifications côte à côte dans le navigateur et en permettant les commentaires en ligne.

Recherchez l'interface de révision Android Gerrit sur android-review.googlesource.com et l'interface de navigation de code sur android.googlesource.com .

Android Code Search vous permet de rechercher AOSP sans rien télécharger. Vous pouvez utiliser la recherche de code pour afficher le code source AOSP, basculer entre les branches open source et parcourir les références croisées. Pour plus d'informations, consultez le site Google Developers pour la documentation de recherche de code .

Autres outils

Android Studio est l'environnement de développement intégré (IDE) officiel pour le développement d'applications Android.

Android Debug Bridge (ADB) vous permet de connecter votre poste de travail de développement directement à votre appareil Android afin que vous puissiez installer des packages et évaluer vos modifications.

Pour le développement AOSP, utilisez Android Studio for Platform (ASfP) .

Installation du dépôt

Suivez ces étapes pour installer Repo.

  1. Exécutez ces commandes pour utiliser le package officiel de votre distribution Linux :
      sudo apt-get update
      sudo apt-get install repo
    
    Si ces commandes ne fonctionnent pas pour votre système – par exemple, vous voyez que la version du package est obsolète ou qu'aucun package officiel n'est disponible sur votre Distribution Linux, installez manuellement Repo à l'aide des commandes suivantes :
    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
    
  2. Ces commandes configurent un fichier temporaire, y téléchargent le dépôt et vérifient que la clé fournie correspond à la clé requise. Si cela réussit, l’installation se poursuit.

    Après l'installation, vérifiez que repo version signale quelque chose de similaire à ce qui suit lorsqu'elle s'exécute dans un répertoire normal. (Un répertoire standard ne fait pas partie d'un client de dépôt ; par exemple, c'est votre répertoire personnel.)

  3. Exécutez cette commande :
  4. repo version
  5. Attendez-vous à un rapport similaire à celui-ci :
  6. <repo not installed>
    repo launcher version 2.15
    (from /usr/bin/repo)
    
    • Le numéro repo launcher version signalé comme 2.15 ou supérieur indique un numéro de version correct et une installation correcte.
    • (from /usr/bin/repo) indique l'installation à partir d'un package.
    • (from /home/<>/bin/repo) indique une installation manuelle.

Terminer l'installation

Suivant : Pour terminer l'installation complète de Repo Tool, voir Initialisation d'un client Repo , sur la page Téléchargement de la source .