Outils de contrôle de source

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 construit par Google qui s'exécute au-dessus de Git). Consultez la page Flux de travail du 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.

Gite

Git gère de grands projets répartis sur plusieurs référentiels. Android utilise Git pour les opérations locales telles que les branchements locaux, les commits, les différences et les modifications. L'un des défis de la mise en place du projet Android consistait à déterminer comment soutenir au mieux la communauté extérieure, de la communauté des amateurs aux grands équipementiers fabriquant des appareils grand public. Google voulait que les composants soient remplaçables et que les composants intéressants aient une vie propre, 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, consultez 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 de révision Gerrit et automatise certaines parties du flux de travail de développement Android.

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

Repo ne remplace pas Git, il facilite seulement le travail avec 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. En travaillant avec les fichiers source Android, vous pouvez utiliser Repo pour des opérations sur tout le réseau, comme 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 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 Installing Repo .

Gerrit

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 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 autorisant les commentaires en ligne.

Trouvez l'interface d'examen 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 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 votre poste de travail de développement directement à votre appareil Android afin que vous puissiez installer des packages et évaluer vos modifications.

Pour Android 10 et supérieur, utilisez IntelliJ avec AIDEgen IDE pour le développement de la plateforme Android.

Installation du référentiel

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 constatez 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-key 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 référentiel et vérifient que la clé fournie correspond à la clé requise. Si ceux-ci réussissent, l'installation se poursuit.

    Après l'installation, vérifiez que la repo version signale quelque chose de similaire à ce qui suit lorsqu'il s'exécute dans un répertoire normal. (Un répertoire normal 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 de repo launcher version de référentiel signalé comme 2.15 ou supérieur indique un numéro de version correct et une installation correcte.
    • (from /usr/bin/repo) indique une installation à partir d'un package.
    • (from /home/<>/bin/repo) indique une installation manuelle.

Terminer l'installation

Ensuite : pour terminer l'installation complète de votre outil Repo, consultez Initialisation d'un client Repo , sur la page Téléchargement de la source .