Poprawka: synchronizacja projektu Gradle nie powiodła się

Programiści używający IDE Android Studio napotykają komunikat o błędzie „ Gradle Project Sync Failed ”, gdy kompilują swój kod lub uruchamiają go na swoim urządzeniu z Androidem (rzeczywistym lub emulowanym). Gradle Sync to zadanie Gradle, którego główną funkcją jest sprawdzenie wszystkich zależności w plikach build.gradle , które są skojarzone z projektem Android Studio, a następnie pobranie określonej wersji (jeśli jeszcze nie została pobrana).

Istnieje wiele odmian, w których może wystąpić ten komunikat o błędzie. Możesz napotkać coś tak prostego, jak połączenie internetowe, w przypadku złożonych problemów, w których kompilacja gradle nie działa. W tym artykule omówimy wszystkie przyczyny tego problemu, a następnie przejdziemy do rozwiązań.

Co powoduje komunikat o błędzie „Gradle Project Sync Failed” w Android Studio?

Jak wspomniano wcześniej, istnieje kilka powodów, dla których projekt Gradle może się nie skompilować lub zsynchronizować. Oto niektóre z przyczyn (każda z nich może nie mieć zastosowania):

  • Złe połączenie internetowe: Ponieważ Gradle pobiera wszystkie brakujące wersje, które są wymagane do uruchomienia projektu, może się nie powieść, jeśli nie masz prawidłowego połączenia internetowego.
  • Problemy z kompilatorem Gradle: mogą wystąpić przypadki, w których kompilator Gradle nie działa poprawnie. Tutaj możemy ręcznie spróbować załadować Gradle i sprawdzić, czy to załatwi sprawę.
  • Zła pamięć podręczna w Android Studio: Android Studio korzysta z pamięci podręcznej w komputerze, aby działać poprawnie. W niektórych przypadkach może ulec uszkodzeniu i powodować problemy w kilku modułach (w tym w Gradle).
  • Brakujące pliki: mogą również brakować pliki, które są wymagane do uruchomienia Gradle. Zainstalowanie ich natychmiast rozwiązuje problem.
  • Serwery proxy: mimo że serwery proxy stają się coraz bardziej popularne, widzieliśmy kilka przypadków, w których Gradle nie synchronizował się na nich poprawnie. Wyłączenie serwera proxy rozwiązuje problem.

Zanim zaczniemy z rozwiązaniami, upewnij się, że masz kopię zapasową bieżącego projektu. Zapisz plik i na wszelki wypadek zrób kopię w innym miejscu. Upewnij się również, że jesteś zalogowany jako administrator na swoim komputerze.

Rozwiązanie 1: sprawdzanie połączenia internetowego

Gradle wymaga posiadania działającego połączenia internetowego na komputerze. Ponieważ jego głównym zadaniem jest pobranie wszystkich wymaganych wersji z Internetu, których brakuje na Twoim komputerze, konieczne jest posiadanie odpowiedniego połączenia internetowego. Możesz także sprawdzić połączenie, próbując podłączyć inne urządzenia do tej samej sieci. Gdy jesteś już absolutnie pewien, że to nie jest problem, możesz przejść do innych rozwiązań.

Rozwiązanie 2: Wyłączanie serwera proxy

Serwery proxy są coraz powszechniejsze z dnia na dzień, gdzie są używane w organizacjach i innych instytutach w celu zwiększenia bieżącej przepustowości i zapewnienia lepszego dostępu do Internetu dla wszystkich użytkowników. Jednak serwery proxy mają swoje ograniczenia. Jednym z nich jest problem polegający na tym, że synchronizacja modułów nie działa zgodnie z wymaganiami. Dotyczy to również Gradle. Oto metoda, aby upewnić się, że nie używasz serwera proxy.

  1. Naciśnij Windows + R, wpisz „ inetcpl. cpl ”w oknie dialogowym i naciśnij klawisz Enter.
  2. Teraz zostaną otwarte właściwości internetowe . Kliknij zakładkę Połączenia, a następnie Ustawienia sieci LAN .
  1. Teraz, jeśli korzystasz z serwera proxy, pole zostanie sprawdzone ze szczegółami w środku. Odznacz wszystkie serwery proxy, jeśli są włączone. Teraz uruchom ponownie Android Studio i sprawdź, czy problem został rozwiązany.

Rozwiązanie 3: Instalowanie brakujących składników

Zanim oddamy się bardziej technicznym metodom, powinieneś sprawdzić, czy brakuje niektórych modułów, które są niezbędne do synchronizacji Gradle. Gradle nie jest samodzielny i wymaga innych usług, aby działać prawidłowo.

Teraz za każdym razem, gdy próbujesz zsynchronizować Gradle i pojawia się komunikat o błędzie, sprawdź, czy pod problemem jest jakieś hiperłącze z nagłówkiem Zainstaluj brakującą platformę (y) i zsynchronizuj projekt . Po kliknięciu linku Android Studio rozpocznie proces pobierania i zainstaluje wszystko, czego brakuje. Spróbuj teraz zsynchronizować projekt i zobacz, czy to rozwiąże problem.

Rozwiązanie 4: Wykorzystanie lokalnej dystrybucji Gradle

Za każdym razem, gdy budujesz swój projekt i Gradle zostaje aktywowany, łączy się z najnowszą dystrybucją online i pobiera stamtąd wszystkie wymagane moduły lub wersje. Napotkaliśmy kilka przypadków, w których dystrybucja online nie działała zgodnie z oczekiwaniami i nie powiodła się synchronizacja Gradle. Innym obejściem tego problemu jest ręczne pobranie dystrybucji Gradle i skorzystanie z niej. Wykonaj poniższe kroki:

  1. Pobierz najnowszą wersję Gradle z oficjalnej strony internetowej Gradle Release.
  2. Po pobraniu wypakuj wszystkie pliki do dostępnego folderu.
  3. Teraz uruchom Android Studio i przejdź do Plik> Ustawienia> Kompilacja, wykonanie, wdrożenie> Gradle .
  4. Teraz wybierz opcję Local Gradle Distribution . Ponadto w katalogu głównym Gradle wskaż ścieżkę, do której właśnie rozpakowałeś pliki.

Uwaga: jeśli korzystasz z pracy w trybie offline w Globalnych ustawieniach Gradle, usuń zaznaczenie tej opcji.

  1. Teraz spróbuj zbudować projekt i sprawdź, czy Gradle synchronizuje się poprawnie. Będziesz musiał powtarzać te kroki za każdym razem, gdy tworzysz nowy projekt.

Rozwiązanie 5: Włączanie debugera GPU

Debuger GPU umożliwia debugowanie i analizowanie aplikacji OpenGL ES. Ma kilka funkcji, dzięki którym możesz sprawdzić stan GPU, a także zrozumieć, co spowodowało wynik renderowania. W niektórych przypadkach kompilacji Gradle w systemie występuje błąd, który nie jest włączony. W tym rozwiązaniu zmusimy moduły do ​​odświeżenia i zainstalowania tego komponentu.

  1. Kliknij Narzędzia, a następnie wybierz Android> Menedżer SDK .
  2. Teraz kliknij kartę SDK Tools, a następnie odznacz opcję Android SDK Build-Tools . Po odczekaniu około 5 sekund ponownie włącz opcję.
  3. Teraz poczekaj chwilę, aż lista zostanie odświeżona i pozycje zostaną wypełnione.
  1. Po zapełnieniu nowych pozycji spójrz na listę i zaznacz opcję Narzędzia do debugowania GPU . Po zakończeniu naciśnij OK.

Teraz te narzędzia zostaną pobrane do aplikacji Android Studio i będziesz mógł poprawnie zsynchronizować Gradle bez żadnych problemów.

Rozwiązanie 6: Odświeżanie pamięci podręcznej

Każda aplikacja, w tym Microsoft Windows, ma wszędzie pamięć podręczną, która pomaga aplikacji działać płynnie i bez żadnych problemów. Służą jako tymczasowe miejsce przechowywania, w którym aplikacja przechowuje preferencje lub tymczasowe dane do późniejszego odebrania. Ustaliliśmy, że jeśli ta pamięć podręczna jest uszkodzona, zatrzyma proces budowania gradle. W tym rozwiązaniu odświeżymy całą pamięć podręczną i po usunięciu istniejących plików Gradle zrestartujemy Android Studio i sprawdzimy, czy to rozwiąże problem.

  1. Przejdź do Plik  i kliknij Unieważnij pamięć podręczną / Uruchom ponownie .
  2. Teraz po zakończeniu procesu całkowicie zamknij Android Studio.
  3. Przejdź do folderu .gradle w katalogu instalacyjnym Android Studio. Teraz możesz wyciąć / wkleić go w inne miejsce lub po prostu zmienić jego nazwę.

    Teraz, gdy Android studio spróbuje uzyskać dostęp do plików Gradle, zobaczy, że ich nie ma, i spróbuje ponownie pobrać całość.

  4. Uruchom ponownie Android Studio i spróbuj ponownie przeprowadzić synchronizację Gradle. Teraz sprawdź, czy problem został rozwiązany.