Programiści korzystający z IDE Android Studio widzą komunikat o błędzie „ Gradle Project Sync Failed ” podczas kompilowania kodu lub uruchamiania go na 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ą powiązane z projektem Android studio, a następnie pobranie określonej wersji (jeśli jeszcze nie została pobrana).

Synchronizacja projektu gradle nie powiodła się

Istnieje wiele odmian, w których może wystąpić ten komunikat o błędzie. Być może masz do czynienia z czymś tak prostym, jak połączenie internetowe do skomplikowanych problemów, w których kompilacja stopni nie działa. W tym artykule omówimy wszystkie przyczyny wystąpienia 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 nie zostać skompilowany lub zsynchronizowany. Oto niektóre z przyczyn (każda z nich może nie dotyczyć Ciebie):

• Złe połączenie internetowe: ponieważ Gradle pobiera wszystkie brakujące wersje wymagane do uruchomienia projektu, może się nie powieść, jeśli nie masz prawidłowego połączenia internetowego.
• Problemy w kompilatorze Gradle: Mogą wystąpić przypadki, w których kompilator Gradle nie działa poprawnie. Tutaj możemy ręcznie 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 Gradle).
• Brakujące pliki: mogą również brakować pliki wymagane do uruchomienia Gradle. Zainstalowanie ich rozwiązuje problem natychmiast.
• Serwery proxy: chociaż serwery proxy stają się coraz bardziej popularne, widzieliśmy przypadki, w których Gradle nie synchronizował się z nimi poprawnie. Wyłączenie serwera proxy rozwiązuje problem.

Zanim zaczniemy od rozwiązań, upewnij się, że masz kopię zapasową bieżącego projektu. Zapisz plik i na wszelki wypadek wykonaj kopię w innym miejscu. Upewnij się także, że jesteś zalogowany jako administrator na swoim komputerze.

Rozwiązanie 1: Sprawdzanie połączenia z Internetem

Gradle wymaga posiadania działającego połączenia internetowego na komputerze. Ponieważ jego głównym zadaniem jest pobieranie wszystkich wymaganych wersji z Internetu, których brakuje na komputerze, wymagane jest prawidłowe połączenie z Internetem. Sprawdzasz również połączenie, próbując podłączyć inne urządzenia do tej samej sieci. Gdy masz absolutną pewność, że to nie jest problem, możesz przejść do innych rozwiązań.

Rozwiązanie 2: Wyłączanie serwera proxy

Serwery proxy stają się popularne z dnia na dzień, gdy są używane w organizacjach i innych instytutach w celu zwiększenia obecnej przepustowości i zapewnienia lepszego dostępu do Internetu wszystkim użytkownikom. Jednak serwery proxy mają swoje ograniczenia. Jednym z nich są problemy, w których moduły synchronizujące nie działają zgodnie z wymaganiami. Dotyczy to również Gradle. Oto metoda upewnienia 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 kartę Połączenia, a następnie Ustawienia sieci LAN .

Wyłączanie serwera proxy

3. Teraz, jeśli używasz 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 komponentów

Zanim przejdziemy do bardziej technicznych metod, powinieneś sprawdzić, czy brakuje niektórych modułów niezbędnych do synchronizacji Gradle. Gradle nie jest samodzielny i wymaga innych usług, aby działać poprawnie.

Zainstaluj brakujące platformy i zsynchronizuj projekt - Android Studio

Teraz, ilekroć spróbujesz zsynchronizować Gradle i pojawi się komunikat o błędzie, sprawdź, czy pod problemem występuje nagłówek Instaluj brakujące platformy i synchronizuj projekt . Po kliknięciu linku Android Studio rozpocznie proces pobierania i zainstaluje wszystko, czego brakuje. Spróbuj teraz zsynchronizować swój projekt i sprawdź, czy to rozwiąże problem.

Rozwiązanie 4: Wykorzystanie lokalnej dystrybucji stopniowej

Ilekroć budujesz projekt, a Gradle zostaje aktywowany, łączy się on 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 udało się zsynchronizować Gradle. Innym obejściem tego problemu jest ręczne pobranie dystrybucji Gradle i korzystanie z niej. Wykonaj poniższe kroki:

1. Pobierz najnowszą wersję Gradle z oficjalnej strony internetowej z wydaniami Gradle.
2. Po pobraniu rozpakuj wszystkie pliki do dostępnego folderu.
3. Teraz uruchom Android Studio i przejdź do Plik> Ustawienia> Kompilacja, wykonanie, wdrożenie> Stopień .
4. Teraz wybierz opcję Lokalna dystrybucja stopniowa . Również w domu Gradle wskaż ścieżkę, do której właśnie rozpakowałeś pliki.

Korzystanie z lokalnej dystrybucji stopniowej - Android Studio

Uwaga: Jeśli korzystasz z pracy offline w Globalnych ustawieniach stopniowania, odznacz tę opcję.

5. Teraz spróbuj zbudować projekt i sprawdź, czy Gradle synchronizuje się poprawnie. Powinieneś powtórzyć 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, w których pozwala sprawdzić stan GPU, a także zrozumieć, co spowodowało wynik renderowania. W niektórych instancjach kompilacji Gradle występuje pewien błąd w systemie, w którym nie jest to włączone. W tym rozwiązaniu zmusimy moduły do ​​odświeżenia i zainstalowania tego komponentu.

1. Kliknij Narzędzia, a następnie wybierz Android> SDK Manager .
2. Teraz kliknij kartę SDK Tools, a następnie odznacz opcję Android SDK Build-Tools . Po odczekaniu około 5 sekund włącz ponownie opcję.
3. Teraz poczekaj chwilę, aż lista zostanie odświeżona i elementy zostaną wypełnione.

Narzędzia do budowania zestawu SDK systemu Android

4. Po zapełnieniu nowych elementów spójrz na listę i zaznacz opcję Narzędzia do debugowania GPU . Po zakończeniu naciśnij przycisk OK.

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

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

Każda aplikacja, w tym Microsoft Windows, ma pamięć podręczną wszędzie, aby pomóc jej w płynnym działaniu bez żadnych problemów. Służą jako tymczasowe miejsce przechowywania, w którym aplikacja przechowuje preferencje lub tymczasowe dane do pobrania w późniejszym terminie. Ustaliliśmy, że ta pamięć podręczna, jeśli jest uszkodzona, zatrzyma proces budowania stopni. W tym rozwiązaniu odświeżymy całą pamięć podręczną, a po usunięciu istniejących plików Gradle ponownie uruchomimy Android Studio i sprawdzimy, czy to rozwiąże problem.

1. Przejdź do pliku i kliknij opcję Unieważnij pamięć podręczną / uruchom ponownie .
   
   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 innym miejscu lub po prostu zmienić jego nazwę.

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

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