Téléchargez la source Android

La source Android se trouve dans une collection de référentiels Git hébergés par Google. Le référentiel Git inclut l'historique complet de la source Android, y compris les modifications apportées à la source et la date à laquelle les modifications ont été apportées. Cette page décrit comment télécharger la source.

Initialiser le client Repo

Configurez votre client pour accéder au référentiel source Android :

  1. Créez et accédez à un répertoire de travail :

    $ mkdir WORKING_DIRECTORY
    $ cd WORKING_DIRECTORY
    
  2. Initialisez votre répertoire de travail pour le contrôle de source :

    $ repo init -b main -u https://android.googlesource.com/platform/manifest
    

    L'option -b est utilisée pour identifier la branche que vous initialisez. Si -b n'est pas fourni, repo init est par défaut la branche principale. Pour obtenir la liste des branches et des noms de balises, consultez Balises et builds de code source .

    L'option -u est obligatoire et est utilisée pour spécifier un fichier manifeste , qui est un fichier XML spécifiant l'emplacement des différents projets Git de la source Android dans votre répertoire de travail. Dans cet exemple, le nom du fichier manifeste n'est pas spécifié, la commande utilise donc le fichier manifeste par défaut ( default.xml ).

    La sortie doit contenir le message :

    $ repo has been initialized in path_to_working_directory
    

Pour plus d’informations sur le format de fichier manifeste, consultez repo Manifest Format .

Pour obtenir la liste de toutes les commandes Repo, consultez la référence des commandes Repo .

Téléchargez la source Android

Exécutez la commande suivante pour télécharger l'arborescence des sources Android dans votre répertoire de travail :

$ repo sync -c -j8

L'argument -c demande à Repo de récupérer la branche manifeste actuelle du serveur. La commande -j8 répartit la synchronisation entre les threads pour une exécution plus rapide.

Cette opération devrait prendre un peu plus d'une heure.

Si vous rencontrez des problèmes pendant le téléchargement, reportez-vous à Résoudre les problèmes de réseau .

Résoudre les problèmes de réseau

Cette section fournit plusieurs suggestions pour résoudre les problèmes de réseau pouvant entraîner des échecs de synchronisation.

Utilisez l'authentification pour éviter les barrières de quotas

Pour protéger les serveurs contre une utilisation excessive, chaque adresse IP utilisée pour accéder à la source est associée à un quota.

Lors du partage d'une adresse IP avec d'autres utilisateurs, par exemple lors de l'accès aux référentiels sources au-delà d'un pare-feu NAT, les quotas peuvent se déclencher pour des modèles normaux. Par exemple, un quota peut se déclencher lorsque plusieurs utilisateurs synchronisent de nouveaux clients à partir de la même adresse IP, sur une courte période.

Pour éviter de déclencher des quotas, vous pouvez utiliser un accès authentifié, qui utilise un quota distinct pour chaque utilisateur, quelle que soit l'adresse IP.

Pour activer l'accès authentifié :

  1. Créez un mot de passe avec le générateur de mot de passe .

  2. Exécutez la commande suivante pour convertir votre client afin qu'il utilise l'authentification automatique (sans changer de branche) :

    $ repo init -u https://android.googlesource.com/a/platform/manifest
    

    Notez que le préfixe du répertoire /a/ déclenche une authentification automatique.

Configurer pour une utilisation proxy

Si vous téléchargez la source derrière un proxy, comme cela est courant dans certains environnements d'entreprise, assurez-vous de spécifier explicitement un proxy que Repo doit utiliser en exécutant ces commandes :

$ export HTTP_PROXY=http://proxy_user_id:proxy_password@proxy_server:proxy_port
$ export HTTPS_PROXY=http://proxy_user_id:proxy_password@proxy_server:proxy_port

Ajustez les paramètres TCP/IP pour éviter les problèmes de connectivité

Bien que cela soit rare, les clients Linux peuvent rencontrer des problèmes de connectivité, comme rester bloqués au milieu de téléchargements lors de la réception d'objets. Pour améliorer ce problème, ajustez les paramètres de la pile TCP/IP ou utilisez des connexions non parallèles. Vous devez disposer d'un accès root pour modifier le paramètre TCP. Pour modifier le paramètre, exécutez les commandes suivantes :

$ sudo sysctl -w net.ipv4.tcp_window_scaling=0
$ repo sync -j1

Utilisez un miroir local pour éviter la latence du réseau

Lorsque vous utilisez plusieurs clients, vous pouvez créer un miroir local de l'intégralité du contenu du serveur et synchroniser les clients à partir de ce miroir sans accéder au réseau. Suivez ces instructions pour créer un miroir local dans ~/aosp-mirror/ et synchroniser les clients avec ce miroir :

  1. Créez et synchronisez le miroir :

    $ mkdir -p /usr/local/aosp/mirror
    $ cd /usr/local/aosp/mirror
    $ repo init -u https://android.googlesource.com/mirror/manifest --mirror
    

    Ces commandes créent un miroir local dans /user/local/aosp/mirror et initialisent le miroir à l'aide de l'indicateur --mirror avec la commande repo init .

  2. Pour synchroniser les clients depuis le miroir :

    $ mkdir -p /usr/local/aosp/main
    $ cd /usr/local/aosp/main
    $ repo init -u /usr/local/aosp/mirror/platform/manifest.git
    $ repo sync
    
  3. Enfin, suivez ces commandes pour synchroniser le miroir avec le serveur et synchroniser le client avec le miroir :

    $ cd /usr/local/aosp/mirror</code>
    $ repo sync
    $ cd /usr/local/aosp/main
    $ repo sync
    

Il est possible de stocker le miroir sur un serveur LAN et d'y accéder via NFS, SSH ou Git. Il est également possible de le stocker sur un disque amovible et de transmettre ce disque aux utilisateurs ou aux machines.

Utiliser un clone partiel

Si vous utilisez Git version 2.19 ou ultérieure, spécifiez --partial-clone lors de l'exécution repo init pour résoudre tout problème de réseau à faible latence :

  $ repo init -u https://android.googlesource.com/platform/manifest -b main --partial-clone --clone-filter=blob:limit=10M

Au lieu d'initialiser Repo pour tout télécharger, cette commande télécharge les objets Git selon leurs besoins.

Télécharger des binaires propriétaires

AOSP peut fonctionner directement sur les émulateurs Cuttlefish, mais AOSP ne peut pas être utilisé sur du matériel sans bibliothèques propriétaires supplémentaires spécifiques au périphérique. Voici comment obtenir les fichiers binaires de ces appareils :

  • Si vous téléchargez la branche main et créez une version pour un appareil Nexus ou Pixel, téléchargez les derniers fichiers binaires à partir du site de prévisualisation des fichiers binaires .
  • Si vous téléchargez et créez la branche main et créez pour votre propre appareil, vous devez fournir les fichiers binaires spécifiques à votre appareil.
  • Si vous téléchargez et créez une branche et une construction balisées, non principales, pour un appareil Nexus ou Pixel, téléchargez le binaire spécifique à l'appareil à partir de Binaries for Nexus and Pixel devices .

Extraire les binaires propriétaires

Chaque ensemble de binaires se présente sous la forme d'un script auto-extractible dans une archive compressée. Pour extraire et placer ces binaires au bon emplacement de votre arborescence source :

  1. Extrayez l'archive.
  2. Exécutez le script shell auto-extractible inclus à partir de la racine de votre arborescence source AOSP.
  3. Acceptez les termes du contrat de licence ci-joint. Les binaires et leurs makefiles correspondants sont installés dans le vendor/ hiérarchie de l'arborescence source.

(facultatif) Vérifier la légitimité du code

Si vous êtes préoccupé par la légitimité du code source, par exemple s'il provient de Google, vous pouvez vérifier les balises git de la branche. Pour vérifier les balises Git :

  1. Copiez et collez le bloc de clé suivant dans un fichier texte, tel que keyfile.asc .

    -----BEGIN PGP PUBLIC KEY BLOCK-----
    Version: GnuPG v1.4.2.2 (GNU/Linux)
    
    mQGiBEnnWD4RBACt9/h4v9xnnGDou13y3dvOx6/t43LPPIxeJ8eX9WB+8LLuROSV
    lFhpHawsVAcFlmi7f7jdSRF+OvtZL9ShPKdLfwBJMNkU66/TZmPewS4m782ndtw7
    8tR1cXb197Ob8kOfQB3A9yk2XZ4ei4ZC3i6wVdqHLRxABdncwu5hOF9KXwCgkxMD
    u4PVgChaAJzTYJ1EG+UYBIUEAJmfearb0qRAN7dEoff0FeXsEaUA6U90sEoVks0Z
    wNj96SA8BL+a1OoEUUfpMhiHyLuQSftxisJxTh+2QclzDviDyaTrkANjdYY7p2cq
    /HMdOY7LJlHaqtXmZxXjjtw5Uc2QG8UY8aziU3IE9nTjSwCXeJnuyvoizl9/I1S5
    jU5SA/9WwIps4SC84ielIXiGWEqq6i6/sk4I9q1YemZF2XVVKnmI1F4iCMtNKsR4
    MGSa1gA8s4iQbsKNWPgp7M3a51JCVCu6l/8zTpA+uUGapw4tWCp4o0dpIvDPBEa9
    b/aF/ygcR8mh5hgUfpF9IpXdknOsbKCvM9lSSfRciETykZc4wrRCVGhlIEFuZHJv
    aWQgT3BlbiBTb3VyY2UgUHJvamVjdCA8aW5pdGlhbC1jb250cmlidXRpb25AYW5k
    cm9pZC5jb20+iGAEExECACAFAknnWD4CGwMGCwkIBwMCBBUCCAMEFgIDAQIeAQIX
    gAAKCRDorT+BmrEOeNr+AJ42Xy6tEW7r3KzrJxnRX8mij9z8tgCdFfQYiHpYngkI
    2t09Ed+9Bm4gmEO5Ag0ESedYRBAIAKVW1JcMBWvV/0Bo9WiByJ9WJ5swMN36/vAl
    QN4mWRhfzDOk/Rosdb0csAO/l8Kz0gKQPOfObtyYjvI8JMC3rmi+LIvSUT9806Up
    hisyEmmHv6U8gUb/xHLIanXGxwhYzjgeuAXVCsv+EvoPIHbY4L/KvP5x+oCJIDbk
    C2b1TvVk9PryzmE4BPIQL/NtgR1oLWm/uWR9zRUFtBnE411aMAN3qnAHBBMZzKMX
    LWBGWE0znfRrnczI5p49i2YZJAjyX1P2WzmScK49CV82dzLo71MnrF6fj+Udtb5+
    OgTg7Cow+8PRaTkJEW5Y2JIZpnRUq0CYxAmHYX79EMKHDSThf/8AAwUIAJPWsB/M
    pK+KMs/s3r6nJrnYLTfdZhtmQXimpoDMJg1zxmL8UfNUKiQZ6esoAWtDgpqt7Y7s
    KZ8laHRARonte394hidZzM5nb6hQvpPjt2OlPRsyqVxw4c/KsjADtAuKW9/d8phb
    N8bTyOJo856qg4oOEzKG9eeF7oaZTYBy33BTL0408sEBxiMior6b8LrZrAhkqDjA
    vUXRwm/fFKgpsOysxC6xi553CxBUCH2omNV6Ka1LNMwzSp9ILz8jEGqmUtkBszwo
    G1S8fXgE0Lq3cdDM/GJ4QXP/p6LiwNF99faDMTV3+2SAOGvytOX6KjKVzKOSsfJQ
    hN0DlsIw8hqJc0WISQQYEQIACQUCSedYRAIbDAAKCRDorT+BmrEOeCUOAJ9qmR0l
    EXzeoxcdoafxqf6gZlJZlACgkWF7wi2YLW3Oa+jv2QSTlrx4KLM=
    =Wi5D
    -----END PGP PUBLIC KEY BLOCK-----
    
  2. Exécutez la commande suivante pour saisir une clé publique dans votre base de données de clés GnuPG. La clé est utilisée pour signer des balises annotées qui représentent les versions.

    $ gpg --import keyfile.asc
    
  3. Après avoir importé les clés, vous pouvez vérifier n'importe quelle balise en exécutant cette commande :

    $ git tag -v TAG_NAME