Outils de contrôle de source

Travailler avec le code Android nécessite à la fois à l' aide Git (un système de contrôle de version open-source) et Repo (un outil référentiel de gestion Google construit qui fonctionne sur le dessus de Git). Voir le flux de travail de contrôle Source page pour un résumé des actions ordinaires que vous pouvez prendre, comme les changements de téléchargement des fins d' examen.

Git

Git gère de gros 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 qui construisent des appareils grand public. Google voulait 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 dépôts Git si nécessaire, effectue des ajouts au système de contrôle de révision Gerrit , et automatise les parties du flux de travail de développement Android.

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

Repo ne remplace pas Git, il facilite seulement le travail avec Git dans le contexte d'Android. Repo utilise des fichiers manifestes à des projets globaux Git dans l'Android SuperProject. Vous pouvez mettre le repo commande, qui est un script Python exécutable, partout dans votre chemin. En travaillant avec les fichiers source Android, vous pouvez utiliser Repo pour des opérations sur plusieurs réseaux, 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 tous les réseaux rend votre travail beaucoup plus simple. Pour plus de détails sur Repo, consultez le commandement repo de référence , prise en pension README , les crochets Preupload (tests) qui peuvent être activés dans Repo et docs général dans PSBA .

Pour télécharger et installer le lanceur repo de téléchargements git-assimilables aux pensions, voir Installation Repo .

Gerrit

Gerrit est un code basé sur le Web système d'examen des 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 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.

Trouver l'interface Android examen Gerrit à android-review.googlesource.com et l'interface de navigation de code à android.googlesource.com .

Android Recherche de code vous permet de rechercher PSBA sans télécharger quoi que ce soit. 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 Recherche de code .

Autres outils

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

Android Debug Bridge (adb) vous permet de connecter votre poste de travail de développement directement sur votre appareil Android afin que vous puissiez installer des paquets et d' évaluer vos modifications.

Pour Android 10 et plus, utilisez le IntelliJ avec AIDEgen IDE pour le développement de la plate - forme Android.

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 :
  2.   sudo apt-get update
      sudo apt-get install repo
    
  3. Si ces commandes ne fonctionnent pour votre système , par exemple, vous voyez que la version du paquet est obsolète, ou il n'y a pas un paquet officiel disponible à partir de 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
    
  4. Ces commandes configurent un fichier temporaire, y téléchargent un 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 rapports quelque chose de semblable à ce qui suit quand il est en cours d' exécution dans un répertoire régulier. (Un répertoire normal ne fait pas partie d'un client de dépôt ; par exemple, c'est votre répertoire personnel.)

  1. Exécutez cette commande :
  2. repo version
  3. Attendez-vous à un rapport similaire à celui-ci :
  4. <repo not installed>
    repo launcher version 2.15
    (from /usr/bin/repo)
    
    • La repo launcher version nombre de rapports 2,15 ou plus indique un numéro de version correcte et une bonne installation.
    • (from /usr/bin/repo) à (from /usr/bin/repo) de (from /usr/bin/repo) indique l' installation d'un package.
    • (from /home/<>/bin/repo) indique une installation manuelle.

Terminer l'installation

Next: Pour compléter votre installation complète Repo Tool, voir Initialiser un client repo , le téléchargement de la source page.