Outils de contrôle des sources

Pour travailler avec le code Android, vous devez utiliser à la fois Git (un système de contrôle des versions Open Source) et Repo (un outil de gestion des dépôts conçu par Google qui s'exécute sur Git). Consultez Workflow de contrôle des sources pour obtenir un résumé des actions régulières que vous pouvez effectuer, comme l'importation de modifications à examiner.

Git

Git gère les grands projets répartis sur plusieurs dépôts. Android utilise Git pour les opérations locales telles que la création de branches locales, les commits, les diffs et les modifications. L'un des défis de la configuration du projet Android consistait à déterminer comment prendre en charge au mieux la communauté externe, des amateurs aux grands OEM qui fabriquent des appareils grand public. Nous voulions que les composants soient remplaçables et que les composants intéressants aient leur propre vie en dehors d'Android. Nous avons d'abord choisi un système de contrôle des révisions distribué, puis nous l'avons limité à Git.

Pour en savoir plus sur Git, consultez cette documentation Git.

Repo

Repo unifie les dépôts Git si nécessaire, effectue des importations dans le système de contrôle des révisions Gerrit et automatise certaines parties du workflow de développement Android.

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

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

Dans la plupart des cas, vous pouvez utiliser Git à la place de Repo, ou combiner les commandes Repo et Git pour former des commandes complexes. Toutefois, l'utilisation de Repo pour les opérations de base sur le réseau simplifie considérablement votre travail. Pour en savoir plus sur Repo, consultez la référence de la commande Repo, le fichier README de Repo, les hooks de pré-importation (tests qui peuvent être activés dans Repo) et la documentation générale dans AOSP.

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

Gerrit

Gerrit est un système de revue de code Web pour les projets qui utilisent Git. Gerrit encourage une utilisation plus centralisée de Git en permettant à tous les utilisateurs autorisés d'envoyer des modifications, qui sont automatiquement fusionnées si elles réussissent la revue de code. De plus, Gerrit simplifie l'examen, en affichant les modifications côte à côte dans le navigateur et en activant les commentaires intégrés.

L'interface d'examen Gerrit Android est disponible sur android-review.googlesource.com et l'interface de navigation dans le code sur android.googlesource.com.

Android Code Search vous permet de rechercher dans AOSP sans rien télécharger. Vous pouvez utiliser Code Search pour afficher le code source AOSP, passer d'une branche Open Source à une autre et parcourir les références croisées. Pour en savoir plus, consultez le site Google Developers pour obtenir la documentation sur la 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 directement votre poste de développement à votre appareil Android afin d'installer des packages et d'évaluer vos modifications.

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