Correctif: Echec de la synchronisation du projet Gradle
Les programmeurs utilisant l'IDE Android Studio rencontrent le message d'erreur « Echec de la synchronisation du projet Gradle » lorsqu'ils compilent leur code ou l'exécutent sur leur périphérique Android (réel ou émulé). Gradle Sync est une tâche Gradle dont la fonction principale est de vérifier toutes les dépendances de vos fichiers build.gradle associés à votre projet de studio Android, puis de télécharger la version spécifiée (si elle n’a pas déjà été téléchargée).
Ce message d'erreur peut se produire dans de nombreuses variantes. Vous pourriez être confronté à quelque chose d'aussi simple qu'une connexion Internet à des problèmes complexes où votre compilation Gradle ne fonctionne pas. Dans cet article, nous allons passer en revue toutes les causes expliquant pourquoi ce problème se produit, puis passer aux solutions.
Quelle est la cause du message d'erreur «Echec de la synchronisation du projet Gradle» dans Android Studio?
Comme mentionné précédemment, plusieurs raisons peuvent expliquer l'échec de la compilation ou de la synchronisation de votre projet Gradle. Voici certaines des causes (chacune d’elles pourrait ne pas s’appliquer à vous):
- Mauvaise connexion Internet: étant donné que Gradle télécharge toutes les versions manquantes nécessaires à l'exécution de votre projet, il peut échouer si vous ne disposez pas d'une connexion Internet valide.
- Problèmes liés au compilateur Gradle: il peut arriver que votre compilateur Gradle ne fonctionne pas correctement. Ici, nous pouvons essayer manuellement de charger Gradle et voir si cela vous convient.
- Cache défectueux dans Android Studio: Android Studio utilise le cache de votre ordinateur pour fonctionner correctement. Dans certains cas, il peut être corrompu et causer des problèmes dans plusieurs modules (y compris Gradle).
- Fichiers manquants: il peut également y avoir des fichiers manquants nécessaires à l'exécution de Gradle. Leur installation résout le problème instantanément.
- Serveurs proxy: bien que les serveurs proxy soient de plus en plus populaires, nous avons pu constater que Gradle ne synchronisait pas correctement sur eux. La désactivation du serveur proxy résout le problème.
Avant de commencer avec les solutions, assurez-vous de disposer d’une sauvegarde de votre projet actuel. Enregistrez le fichier et faites-en une copie ailleurs, au cas où. Assurez-vous également que vous êtes connecté en tant qu'administrateur sur votre ordinateur.
Solution 1: Vérification de la connexion Internet
Gradle requiert une connexion Internet en état de fonctionnement sur votre ordinateur. Comme sa tâche principale est de télécharger toutes les versions requises d’Internet qui manquent sur votre ordinateur, il est indispensable de disposer d’une connexion Internet adéquate. Vous vérifiez également la connexion en essayant de connecter d'autres appareils au même réseau. Une fois que vous êtes absolument certain que ce n'est pas le problème, vous pouvez passer à d'autres solutions.
Solution 2: Désactivation du serveur proxy
Les serveurs proxy se communiquent de jour en jour et sont utilisés dans les organisations et autres instituts pour augmenter la bande passante actuelle et fournir un meilleur accès Internet à tous les utilisateurs. Cependant, les serveurs proxy ont leurs limites. L'un d'entre eux inclut des problèmes pour lesquels les modules de synchronisation ne fonctionnent pas correctement. Cela inclut aussi Gradle. Voici la méthode pour vous assurer que vous n'utilisez pas un serveur proxy.
- Appuyez sur Windows + R, tapez “ inetcpl. cpl ”dans la boîte de dialogue et appuyez sur Entrée.
- Maintenant, Internet Properties sera ouvert. Cliquez sur l'onglet Connexions, puis sur Paramètres LAN .
- Maintenant, si vous utilisez un serveur proxy, le champ sera vérifié avec les détails à l'intérieur. Décochez tous les serveurs proxy si activé. Maintenant, redémarrez Android Studio et vérifiez si le problème est résolu.
Solution 3: Installation des composants manquants
Avant de vous livrer à des méthodes plus techniques, vous devez vérifier s’il manque certains modules nécessaires à la synchronisation de Gradle. Gradle n'est pas autonome en soi et nécessite d'autres services pour fonctionner correctement.
Maintenant, chaque fois que vous essayez de synchroniser Gradle et que le message d'erreur apparaît, vérifiez s'il existe un lien hypertexte sous le problème avec l'en-tête Installer la (les) plate-forme (s) manquante (s) et le projet de synchronisation . Après avoir cliqué sur le lien, Android Studio démarre le processus de téléchargement et installe tout ce qui manque. Essayez de synchroniser votre projet maintenant et voyez si cela résout le problème.
Solution 4: Utilisation de la distribution de gradles locale
Chaque fois que vous construisez votre projet et que Gradle est activé, il se connecte à une distribution en ligne la plus récente et télécharge tous les modules ou versions requis à partir de là. Nous avons rencontré plusieurs cas où la distribution en ligne ne fonctionnait pas comme prévu et la synchronisation de Gradle a échoué. Une autre solution à ce problème consiste à télécharger manuellement la distribution de Gradle et à l'utiliser. Suivez les étapes ci-dessous:
- Téléchargez la dernière version de Gradle sur le site Web officiel de Gradle Release.
- Après le téléchargement, extrayez tous les fichiers dans un dossier accessible.
- Maintenant, lancez Android Studio et allez dans Fichier> Paramètres> Construire, Exécution, Déploiement> Gradle .
- Sélectionnez maintenant l’option de distribution en dégradé local . De plus, une fois dans la maison Gradle, pointez sur le chemin où vous venez d'extraire les fichiers.
Remarque: Si vous utilisez un travail hors ligne dans les paramètres globaux de dégradé, décochez cette option.
- Maintenant, essayez de construire votre projet et vérifiez si Gradle se synchronise correctement. Vous devrez répéter ces étapes chaque fois que vous créez un nouveau projet.
Solution 5: activation du débogueur GPU
Le débogueur GPU vous permet de déboguer et d'analyser les applications OpenGL ES. Il a plusieurs fonctionnalités où il vous permet d'inspecter l'état du GPU et également de comprendre ce qui a provoqué un résultat de rendu. Dans certaines instances de génération Gradle, il existe un bogue dans le système qui n’est pas activé. Dans cette solution, nous forcerons les modules à actualiser et à installer ce composant.
- Cliquez sur Outils, puis sélectionnez Android> Gestionnaire de SDK .
- Maintenant, cliquez sur l'onglet Outils SDK, puis décochez l'option Outils de compilation Android SDK . Après avoir attendu environ 5 secondes, activez à nouveau l’option.
- Maintenant, attendez un peu que la liste soit actualisée et que les éléments soient remplis.
- Une fois les nouveaux éléments renseignés, consultez la liste et cochez la case Outils de débogage du processeur graphique . Appuyez sur OK lorsque vous avez terminé.
Désormais, ces outils seront téléchargés dans votre application Android Studio et vous pourrez synchroniser correctement le Gradle sans aucun problème.
Solution 6: actualiser le cache
Toutes les applications, y compris Microsoft Windows, ont un cache partout pour l’aider à s’exécuter sans problème. Ils servent de stockage temporaire où l’application stocke les préférences ou les données temporaires à récupérer ultérieurement. Nous avons déterminé que ce cache, s'il était corrompu, interromprait le processus de construction de Gradle. Dans cette solution, nous actualiserons l'intégralité du cache et, après la suppression des fichiers Gradle existants, redémarrerons Android Studio et verrons si cela résout le problème.
- Naviguez vers le fichier et cliquez sur Invalidate cache / Restart .
- Maintenant, une fois le processus terminé, fermez complètement Android Studio.
- Accédez au dossier .gradle de votre répertoire d'installation Android Studio. Vous pouvez maintenant le copier / coller à un autre emplacement ou simplement le renommer.
Maintenant, lorsque le studio Android tente d'accéder aux fichiers Gradle, il constate qu'il n'y en a pas et il tente de télécharger à nouveau le tout.
- Redémarrez votre Android Studio et essayez à nouveau la synchronisation Gradle. Maintenant, vérifiez si le problème est résolu.
