Các lập trình viên sử dụng IDE Android Studio gặp thông báo lỗi "Gradle Project Sync Failed" khi họ biên dịch mã hoặc chạy nó trên thiết bị Android (thật hoặc giả lập). Gradle Sync là một tác vụ Gradle có chức năng chính là kiểm tra tất cả các phụ thuộc trong file build.gradle liên quan đến dự án Android Studio của bạn và sau đó tải xuống phiên bản được chỉ định (nếu chưa được tải xuống).
Nguyên nhân gây ra thông báo lỗi "Gradle Project Sync Failed" trong Android Studio?
Như đã đề cập trước đó, có một số lý do khiến dự án Gradle của bạn không thể biên dịch hoặc đồng bộ. Dưới đây là một số nguyên nhân (mỗi cái có thể không áp dụng cho bạn):
- Kết nối internet kém: Vì Gradle tải xuống tất cả các phiên bản bị thiếu cần thiết để chạy dự án của bạn, nó có thể thất bại nếu bạn không có kết nối internet hợp lệ.
- Vấn đề trong trình biên dịch Gradle: Có thể có trường hợp trình biên dịch Gradle của bạn không hoạt động đúng. Ở đây chúng ta có thể thử tải Gradle thủ công xem có giải quyết được không.
- Cache xấu trong Android Studio: Android Studio sử dụng cache trong máy tính của bạn để hoạt động đúng. Trong một số trường hợp, nó có thể bị hỏng và gây ra vấn đề trong một số mô-đun (bao gồm Gradle).
- Thiếu file: Có thể cũng thiếu các file cần thiết để chạy Gradle. Cài đặt chúng sẽ giải quyết vấn đề ngay lập tức.
- Proxy servers: Mặc dù proxy server ngày càng phổ biến, chúng tôi thấy một số trường hợp Gradle không đồng bộ đúng trên chúng. Vô hiệu hóa proxy server sẽ giải quyết vấn đề.
Trước khi bắt đầu với các giải pháp, hãy đảm bảo bạn có bản sao lưu dự án hiện tại. Lưu file và tạo bản sao ở nơi khác phòng khi cần. Ngoài ra, hãy đảm bảo bạn đăng nhập với tư cách quản trị viên trên máy tính.
Giải pháp 1: Kiểm tra kết nối Internet
Gradle yêu cầu bạn phải có kết nối internet hoạt động trên máy tính. Vì công việc chính của nó là tải xuống tất cả các phiên bản cần thiết từ internet bị thiếu trên máy tính của bạn, nên kết nối internet hợp lệ là bắt buộc. Bạn cũng có thể kiểm tra kết nối bằng cách thử kết nối các thiết bị khác với cùng mạng. Khi bạn hoàn toàn chắc chắn đây không phải là vấn đề, bạn có thể chuyển sang các giải pháp khác.
Giải pháp 2: Vô hiệu hóa Proxy Server
Proxy server ngày càng phổ biến nơi chúng được sử dụng trong các tổ chức và viện khác nhau để tăng cường băng thông hiện tại và cung cấp truy cập internet tốt hơn cho tất cả người dùng. Tuy nhiên, proxy server có giới hạn của chúng. Một trong số đó bao gồm các vấn đề mà các mô-đun đồng bộ không hoạt động như yêu cầu. Điều này bao gồm cả Gradle. Dưới đây là phương pháp để đảm bảo bạn không sử dụng proxy server.
- Nhấn Windows + R, gõ "inetcpl.cpl" trong hộp thoại và nhấn Enter.
- Bây giờ Internet Properties sẽ mở ra. Nhấp vào tab Connections rồi LAN settings.
- Nếu bạn đang sử dụng proxy server, trường sẽ được tích với chi tiết bên trong. Bỏ tích bất kỳ proxy server nào nếu được bật. Bây giờ khởi động lại Android Studio và kiểm tra xem vấn đề có được giải quyết không.
Giải pháp 3: Cài đặt các thành phần còn thiếu
Trước khi đi sâu vào các phương pháp kỹ thuật hơn, bạn nên kiểm tra xem mình có thiếu một số mô-đun cần thiết cho việc đồng bộ Gradle hay không. Gradle không độc lập và nó cũng cần các dịch vụ khác để hoạt động đúng.
Bây giờ mỗi khi bạn thử đồng bộ Gradle và thông báo lỗi xuất hiện, hãy kiểm tra xem có bất kỳ hyperlink nào bên dưới vấn đề với tiêu đề Install missing platform(s) and sync project không. Sau khi nhấp vào liên kết, Android Studio sẽ bắt đầu quá trình tải xuống và cài đặt mọi thứ bị thiếu. Thử đồng bộ dự án của bạn ngay bây giờ và xem liệu điều này có giải quyết được vấn đề không.
Giải pháp 4: Sử dụng Local Gradle Distribution
Bất cứ khi nào bạn xây dựng dự án và Gradle được kích hoạt, nó kết nối với một bản phân phối trực tuyến mới nhất và tải xuống tất cả các mô-đun hoặc phiên bản cần thiết từ đó. Chúng tôi gặp một số trường hợp bản phân phối trực tuyến không hoạt động như mong đợi và làm thất bại đồng bộ Gradle. Một cách giải quyết thay thế cho vấn đề này là tải xuống bản phân phối Gradle thủ công và sử dụng nó. Làm theo các bước dưới đây:
- Tải xuống phiên bản mới nhất của Gradle từ trang web Gradle Release chính thức.
- Sau khi tải xuống, giải nén tất cả các file vào một thư mục dễ truy cập.
- Bây giờ khởi chạy Android Studio và vào File > Settings > Build, Execution, Deployment > Gradle.
- Bây giờ chọn tùy chọn Local Gradle Distribution. Cũng, khi ở Gradle home, trỏ đến đường dẫn nơi bạn vừa giải nén các file.
Lưu ý: Nếu bạn đang sử dụng offline work trong Global Gradle Settings, bỏ tích tùy chọn đó.
- Bây giờ thử xây dựng dự án của bạn và kiểm tra xem Gradle có đồng bộ đúng không. Bạn sẽ phải lặp lại các bước này mỗi khi tạo dự án mới.
Giải pháp 5: Bật GPU Debugger
GPU Debugger cho phép bạn gỡ lỗi và phân tích các ứng dụng OpenGL ES. Nó có một số chức năng cho phép bạn kiểm tra trạng thái GPU và hiểu nguyên nhân gây ra kết quả rendering. Trong một số trường hợp xây dựng Gradle, có một số lỗi trong hệ thống nơi điều này không được bật. Trong giải pháp này, chúng ta sẽ buộc các mô-đun làm mới và cài đặt thành phần này.
- Nhấp vào Tools rồi chọn Android > SDK Manager.
- Bây giờ nhấp vào tab SDK Tools và bỏ tích tùy chọn Android SDK Build-Tools. Sau khi chờ khoảng 5 giây, bật tùy chọn đó lại.
- Bây giờ, chờ một chút cho đến khi danh sách được làm mới và các mục được điền.
- Khi các mục mới được điền, nhìn vào danh sách và chọn tùy chọn GPU Debugging Tools. Nhấn OK khi bạn xong.
Bây giờ, các công cụ này sẽ được tải xuống vào ứng dụng Android Studio của bạn và bạn sẽ có thể đồng bộ Gradle đúng cách mà không gặp vấn đề.
Giải pháp 6: Làm mới Cache
Mọi ứng dụng bao gồm Microsoft Windows đều có cache ở khắp nơi để giúp ứng dụng chạy trơn tru mà không gặp vấn đề. Chúng đóng vai trò là bộ nhớ tạm nơi ứng dụng lưu trữ sở thích hoặc dữ liệu tạm thời để lấy lại sau. Chúng tôi xác định rằng cache này, nếu bị hỏng, sẽ dừng quá trình xây dựng gradle. Trong giải pháp này, chúng ta sẽ làm mới toàn bộ cache và sau khi xóa các file Gradle hiện có, khởi động lại Android Studio và xem liệu điều này có khắc phục được vấn đề hay không.
- Điều hướng đến File và nhấp Invalidate cache/Restart.
- Bây giờ sau khi quá trình xong, tắt Android Studio hoàn toàn.
- Điều hướng đến thư mục .gradle trong thư mục cài đặt Android Studio của bạn. Bây giờ bạn có thể cut/paste nó sang vị trí khác hoặc đơn giản chỉ đổi tên nó.
Bây giờ khi Android studio cố gắng truy cập các file Gradle, nó sẽ thấy không có file nào và sẽ cố gắng tải xuống toàn bộ thứ lại từ đầu. - Khởi động lại Android Studio của bạn và thử đồng bộ Gradle lại. Bây giờ kiểm tra xem vấn đề có được giải quyết không.