À partir de 2026, pour nous aligner sur notre modèle de développement stable et garantir la stabilité de la plate-forme pour l'écosystème, nous publierons le code source sur AOSP au deuxième et au quatrième trimestre. Pour créer et contribuer à AOSP, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main. La branche de fichier manifeste android-latest-release fera toujours référence à la version la plus récente envoyée à AOSP. Pour en savoir plus, consultez Modifications apportées à AOSP.

Dépannage et résolution des problèmes de synchronisation

Cette page explique comment résoudre les problèmes liés à la commande repo sync.

Résoudre les problèmes de réseau

Cette section fournit plusieurs suggestions pour résoudre les problèmes de réseau qui peuvent entraîner des synchronisations infructueuses.

Utiliser l'authentification pour éviter les barrières de quota

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

Lorsque vous partagez une adresse IP avec d'autres utilisateurs, par exemple lorsque vous accédez aux dépôts 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é, procédez comme suit :

Créez un mot de passe à l'aide de le générateur de mots de passe.
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 de répertoire /a/ déclenche l'authentification automatique.

Configurer pour l'utilisation d'un proxy

Si vous téléchargez la source à partir d'un proxy, comme c'est courant dans certains environnements d'entreprise, assurez-vous de spécifier explicitement un proxy à utiliser par Repo en exécutant les commandes suivantes :

$ 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

Ajuster 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é, par exemple rester bloqués au milieu des téléchargements lors de la réception d'objets. Pour résoudre 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 racine 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

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

Lorsque vous utilisez plusieurs clients, vous pouvez créer un miroir local de l'ensemble 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 :

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 l'initialisent à l'aide de l'indicateur --mirror avec la commande repo init.

Synchronisez les clients à partir du miroir :

$ mkdir -p /usr/local/aosp/main
$ cd /usr/local/aosp/main
$ repo init -u /usr/local/aosp/mirror/platform/manifest.git -b android-latest-release
$ repo sync

Synchronisez le miroir avec le serveur et les clients avec le miroir :

$ cd /usr/local/aosp/mirror
$ repo sync
$ cd /usr/local/aosp/android-latest-release
$ repo sync

Vous pouvez stocker le miroir sur un serveur LAN et y accéder via NFS, SSH ou Git. Vous pouvez également le stocker sur un lecteur amovible et le transmettre entre les utilisateurs ou les machines.

Utiliser un clone partiel

Si vous utilisez Git version 2.19 ou ultérieure, spécifiez --partial-clone lorsque vous effectuez repo init pour résoudre les problèmes de réseau à faible latence :

  $ repo init -u https://android.googlesource.com/platform/manifest -b android-latest-release --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 les besoins.

Résoudre les erreurs 403 ou 500 (problèmes de proxy)

Les commandes repo init ou repo sync peuvent échouer avec une erreur 403 ou 500. Le plus souvent, ces erreurs sont liées à des proxys HTTP qui ont du mal à gérer les transferts de données volumineux.

Bien qu'il n'existe pas de correctif spécifique à ces erreurs, l'utilisation de la dernière version de Python et l'utilisation explicite de repo sync -j1 peuvent parfois être utiles.