Correction: échec de la synchronisation du projet Gradle

Les programmeurs utilisant l'IDE Android Studio rencontrent le message d'erreur « Gradle Project Sync Failed » lorsqu'ils compilent leur code ou l'exécutent sur leur appareil Android (réel ou émulé). Gradle Sync est une tâche Gradle dont la fonction principale est de vérifier toutes les dépendances dans vos fichiers build.gradle qui sont associées à votre projet de studio Android, puis de télécharger cette version spécifiée (si elle n'est pas déjà téléchargée).

Il existe de nombreuses variantes dans lesquelles ce message d'erreur peut apparaître. 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 de ce problème, puis passer aux solutions.

Qu'est-ce qui cause le message d'erreur «Gradle Project Sync Failed» dans Android Studio?

Comme mentionné précédemment, il existe plusieurs raisons pour lesquelles votre projet Gradle peut échouer à la compilation ou à la synchronisation. Voici quelques-unes des causes (chacune d'entre elles peut ne pas s'appliquer à vous):

• Mauvaise connexion Internet: puisque Gradle télécharge toutes les versions manquantes requises pour exécuter votre projet, il peut échouer si vous ne disposez pas d'une connexion Internet valide.
• Problèmes dans le compilateur Gradle: il peut y avoir des cas où votre compilateur Gradle ne fonctionne pas correctement. Ici, nous pouvons essayer manuellement de charger Gradle et voir si cela vous convient.
• Mauvais cache 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 qui sont nécessaires pour exécuter Gradle. Leur installation résout le problème instantanément.
• Serveurs proxy: même si les serveurs proxy sont de plus en plus populaires, nous avons vu des cas où Gradle ne se synchronisait pas correctement. La désactivation du serveur proxy résout le problème.

Avant de commencer avec les solutions, assurez-vous d'avoir une sauvegarde de votre projet actuel. Enregistrez le fichier et faites 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 nécessite que vous disposiez d'une connexion Internet fonctionnelle sur votre ordinateur. Comme son travail principal est de télécharger toutes les versions requises sur Internet qui manquent sur votre ordinateur, il est obligatoire d'avoir une connexion Internet appropriée. Vous vérifiez également la connexion en essayant de connecter d'autres appareils au même réseau. Une fois que vous êtes absolument sûr que ce n'est pas le problème, vous pouvez passer à d'autres solutions.

Solution 2: désactivation du serveur proxy

Les serveurs proxy sont de plus en plus courants lorsqu'ils 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'eux inclut des problèmes où les modules de synchronisation ne fonctionnent pas comme requis. Cela inclut également Gradle. Voici la méthode pour vous assurer que vous n'utilisez pas de serveur proxy.

1. Appuyez sur Windows + R, tapez « inetcpl. cpl ”dans la boîte de dialogue et appuyez sur Entrée.
2. Maintenant, les propriétés Internet seront ouvertes. Cliquez sur l'onglet Connexions puis sur Paramètres LAN .

3. 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 s'ils sont activés. Redémarrez maintenant Android Studio et vérifiez si le problème est résolu.

Solution 3: installation des composants manquants

Avant de nous livrer à des méthodes plus techniques, vous devriez vérifier s'il vous manque des modules nécessaires à la synchronisation de Gradle. Gradle n'est pas autonome et nécessite également 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 y a un lien hypertexte sous le problème avec l'en-tête Installer les plates-formes manquantes et synchroniser le projet . Après avoir cliqué sur le lien, Android Studio lancera le processus de téléchargement et installera 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 Gradle locale

Chaque fois que vous créez votre projet et que Gradle est activé, il se connecte à une distribution en ligne qui est 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 a échoué la synchronisation Gradle. Une autre solution de contournement à ce problème consiste à télécharger la distribution Gradle manuellement et à l'utiliser. Suivez les étapes ci-dessous:

1. Téléchargez la dernière version de Gradle à partir du site Web officiel de Gradle Release.
2. Après le téléchargement, extrayez tous les fichiers dans un dossier accessible.
3. Lancez maintenant Android Studio et accédez à Fichier> Paramètres> Construction, exécution, déploiement> Gradle .
4. Sélectionnez maintenant l'option de distribution locale de Gradle . De plus, lorsque vous vous trouvez dans la maison Gradle, pointez sur le chemin où vous venez d'extraire les fichiers.

Remarque: si vous utilisez le travail hors ligne dans les paramètres globaux de Gradle, décochez cette option.

5. Maintenant, essayez de créer 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 possède plusieurs fonctionnalités dans lesquelles il vous permet d'inspecter l'état du GPU et de comprendre également ce qui a causé un résultat de rendu. Dans certaines instances de construction Gradle, il y a un bogue dans le système où cela n'est pas activé. Dans cette solution, nous forcerons les modules à actualiser et installer ce composant.

1. Cliquez sur Outils , puis sélectionnez Android> Gestionnaire de SDK .
2. Cliquez maintenant sur l'onglet Outils du SDK , puis décochez l'option Outils de construction du SDK Android . Après avoir attendu environ 5 secondes, réactivez l'option.
3. Maintenant, attendez un peu que la liste soit actualisée et que les éléments soient remplis.

4. Une fois que les nouveaux éléments sont remplis, regardez la liste et cochez l'option des outils de débogage GPU . Appuyez sur OK lorsque vous avez terminé.

Maintenant, 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: actualisation du cache

Chaque application, y compris Microsoft Windows, dispose de cache partout pour aider l'application à fonctionner correctement sans aucun problème. Ils servent de stockage temporaire où l'application stocke les préférences ou les données temporaires à récupérer plus tard. Nous avons déterminé que ce cache, s'il est corrompu, arrêtera le processus de construction gradle. Dans cette solution, nous actualiserons tout le cache et, après avoir supprimé les fichiers Gradle existants, redémarrerons Android Studio et verrons si cela résout le problème.

1. Accédez à Fichier  et cliquez sur Invalidate cache / Restart .
2. Maintenant, une fois le processus terminé, fermez complètement Android Studio.
3. Accédez au dossier .gradle dans votre répertoire d'installation Android Studio. Vous pouvez maintenant le couper / coller à un autre emplacement ou simplement le renommer.

   Maintenant, lorsque le studio Android essaiera d'accéder aux fichiers Gradle, il verra qu'il n'y en a pas et il tentera à nouveau de télécharger le tout.

4. Redémarrez votre Android Studio et réessayez la synchronisation Gradle. Vérifiez maintenant si le problème est résolu.