Google is committed to advancing racial equity for Black communities. See how.
This page was translated by the Cloud Translation API.
Switch to English

Outils de contrôle de source

Travailler avec du code Android nécessite l'utilisation de Git (un système de contrôle de version open-source) et Repo (un outil de gestion de référentiel construit par Google qui s'exécute sur Git). Voir Flux de travail de contrôle de la source pour un résumé des actions régulières, telles que le téléchargement des modifications pour examen.

Git

Git est conçu pour gérer de gros projets répartis sur plusieurs référentiels. Android utilise Git pour les opérations locales telles que la création de branches locales, les validations, les différences et les modifications. L'un des défis lors de la mise en place du projet Android était de trouver la meilleure façon de soutenir la communauté extérieure, de la communauté des amateurs aux grands équipementiers qui fabriquent des appareils grand public. Nous voulions que les composants soient remplaçables et nous voulions que les composants intéressants aient une vie propre en dehors d'Android. Nous avons d'abord choisi un système de contrôle de révision distribué, puis nous l'avons réduit à Git.

Pour plus de détails sur Git, reportez-vous à la 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.

Repo se compose de deux parties: Le lanceur de repo que vous téléchargez et installez à partir de git-repo-downloads . C'est un script Python qui sait comment initialiser une extraction et peut télécharger la deuxième partie, l'outil Repo complet, inclus dans une extraction de code source Android. L'outil Repo complet se trouve par défaut dans $SRCDIR/.repo/repo/... et reçoit les commandes transférées du lanceur de $SRCDIR/.repo/repo/... téléchargé.

Repo n'est pas destiné à remplacer Git, mais uniquement à faciliter le travail avec Git dans le contexte d'Android. Il utilise des fichiers manifestes pour agréger les projets Git dans le superprojet Android. La commande repo est un script Python exécutable que vous pouvez placer n'importe où dans votre chemin. Lorsque vous travaillez avec les fichiers source Android, vous utilisez Repo pour les 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 le réseau simplifie considérablement votre travail. 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 .

Autres outils

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

La recherche de code Android 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 .

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

Installation du repo

Repo est un outil qui facilite le travail avec Git dans le contexte d'Android. Voir l' aperçu Repo ci-dessus pour son objectif et les liens vers les documents connexes.

Repo se compose de deux parties: l'une est un script de lancement que vous installez, et il communique avec la seconde partie, l'outil complet de Repo inclus dans une extraction de code source. Pour installer Repo:

  1. Assurez-vous que vous avez un répertoire bin/ dans votre répertoire personnel et qu'il est inclus dans votre chemin:

    mkdir ~/bin
    PATH=~/bin:$PATH
    
  2. Téléchargez le Repo Launcher et assurez-vous qu'il est exécutable:

    curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
    chmod a+x ~/bin/repo
    
  3. Vérifiez éventuellement que le lanceur correspond à nos signatures:

    gpg --recv-key 8BB9AD793E8E6153AF0F9A4416530D5E920F5C65
    curl https://storage.googleapis.com/git-repo-downloads/repo.asc | gpg --verify - ~/bin/repo
    

Dépôt plus ancien pour les systèmes Python 2 hérités

Si vous utilisez un système plus ancien sans Python 3.6+, essayez de télécharger une version plus ancienne du Repo Launcher qui prend toujours en charge Python 2.7. Cela ne fonctionnera pas indéfiniment mais pourrait vous aider jusqu'à ce que votre système soit mis à niveau.

curl https://storage.googleapis.com/git-repo-downloads/repo-1 > ~/bin/repo
chmod a+x ~/bin/repo