يواجه المبرمجون الذين يستخدمون IDE Android Studio رسالة الخطأ " Gradle Project Sync Failed " عندما يقومون بتجميع التعليمات البرمجية الخاصة بهم أو تشغيلها على جهاز Android الخاص بهم (سواء كان حقيقيًا أو مقلدًا). Gradle Sync هي مهمة Gradle تتمثل وظيفتها الرئيسية في التحقق من جميع التبعيات الموجودة في ملفات build.gradle الخاصة بك والتي ترتبط بمشروع استوديو Android الخاص بك ثم تنزيل هذا الإصدار المحدد (إذا لم يتم تنزيله بالفعل).

فشل مزامنة مشروع Gradle

هناك العديد من الاختلافات التي قد تحدث رسالة الخطأ هذه. قد تواجه شيئًا بسيطًا مثل اتصال الإنترنت بالمشكلات المعقدة التي لا تعمل فيها ميزة تجميع المهارات لديك. في هذه المقالة ، سنتعرف على جميع الأسباب التي تجعل سبب حدوث هذه المشكلة ثم ننتقل إلى الحلول.

ما أسباب ظهور رسالة الخطأ "فشل مشروع Gradle Project Sync" في Android Studio؟

كما ذكرنا من قبل ، هناك عدة أسباب لسبب فشل مشروع Gradle في التجميع أو المزامنة. فيما يلي بعض الأسباب (قد لا ينطبق كل واحد منها عليك):

• اتصال إنترنت غير صحيح : نظرًا لأن Gradle يقوم بتنزيل جميع الإصدارات المفقودة المطلوبة لتشغيل مشروعك ، فقد يفشل إذا لم يكن لديك اتصال إنترنت صالح.
• مشاكل في برنامج التحويل البرمجي لـ Gradle: قد تكون هناك حالات لا يعمل فيها برنامج التحويل البرمجي لـ Gradle بشكل صحيح. هنا يمكننا محاولة تحميل Gradle يدويًا ومعرفة ما إذا كانت هذه الحيله لك.
• ذاكرة تخزين مؤقت غير صالحة في Android Studio: يستخدم Android Studio ذاكرة التخزين المؤقت في جهاز الكمبيوتر الخاص بك من أجل العمل بشكل صحيح. في بعض الحالات ، قد تتلف وتتسبب في حدوث مشكلات في عدة وحدات (بما في ذلك Gradle).
• الملفات المفقودة: قد يكون هناك أيضًا ملفات مفقودة مطلوبة لتشغيل Gradle. تثبيتها يحل المشكلة على الفور.
• خوادم بروكسي: على الرغم من أن الخوادم الوكيلة تزداد شعبية ، فقد رأينا بعض الحالات التي لم تتم فيها مزامنة Gradle عليها بشكل صحيح. تعطيل الخادم الوكيل يحل المشكلة.

قبل أن نبدأ بالحلول ، تأكد من أن لديك نسخة احتياطية من مشروعك الحالي. احفظ الملف وقم بعمل نسخة في مكان آخر أيضًا في حالة. تأكد أيضًا من تسجيل الدخول كمسؤول على جهاز الكمبيوتر الخاص بك.

الحل 1: التحقق من اتصال الإنترنت

يتطلب Gradle أن يكون لديك اتصال إنترنت فعال على جهاز الكمبيوتر الخاص بك. نظرًا لأن وظيفتها الرئيسية هي تنزيل جميع الإصدارات المطلوبة من الإنترنت التي تفتقد إلى جهاز الكمبيوتر الخاص بك ، فمن الضروري وجود اتصال إنترنت مناسب. يمكنك أيضًا التحقق من الاتصال عن طريق محاولة توصيل أجهزة أخرى بالشبكة نفسها. بمجرد أن تكون متأكدًا تمامًا من أن هذه ليست هي المشكلة ، يمكنك الانتقال إلى حلول أخرى.

الحل 2: تعطيل خادم الوكيل

تصبح خوادم بروكسي شائعة يومًا بعد يوم حيث يتم استخدامها في المؤسسات والمعاهد الأخرى لزيادة النطاق الترددي الحالي وتوفير وصول أفضل للإنترنت لجميع المستخدمين. ومع ذلك ، خوادم بروكسي لها حدودها. تتضمن إحداها مشاكل حيث لا تعمل وحدات المزامنة كما هو مطلوب. وهذا يشمل Gradle كذلك. إليك الطريقة للتأكد من أنك لا تستخدم خادمًا وكيلًا.

1. اضغط على Windows + R ، اكتب " inetcpl " . cpl "في مربع الحوار واضغط على Enter.
2. الآن سيتم فتح خصائص الإنترنت . انقر فوق علامة التبويب اتصالات ثم إعدادات الشبكة المحلية .

تعطيل الخادم الوكيل

3. الآن إذا كنت تستخدم خادمًا وكيلًا ، فسيتم التحقق من الحقل مع التفاصيل الموجودة بداخله. قم بإلغاء تحديد أي خوادم بروكسي في حالة التمكين. أعد الآن تشغيل Android Studio وتحقق مما إذا كانت المشكلة قد تم حلها.

الحل 3: تثبيت مكونات مفقودة

قبل الانغماس في المزيد من الأساليب التقنية ، يجب عليك التحقق مما إذا كان لديك بعض الوحدات المفقودة والتي تعتبر ضرورية لمزامنة Gradle. Gradle ليس قائما بذاته ويتطلب خدمات أخرى كذلك لأداء بشكل صحيح.

قم بتثبيت نظام (منصات) مفقود ومزامنة المشروع - Android Studio

الآن كلما حاولت مزامنة Gradle وظهور رسالة الخطأ ، تحقق مما إذا كان هناك أي ارتباط تشعبي أسفل المشكلة مع العنوان تثبيت نظام أساسي (منصات) ومشروع مزامنة . بعد النقر على الرابط ، سيبدأ Android Studio عملية التنزيل ويثبت كل ما هو مفقود. حاول مزامنة مشروعك الآن ومعرفة ما إذا كان هذا يحل المشكلة.

الحل 4: استخدام توزيع Gradle المحلي

عندما تقوم بإنشاء مشروعك ويتم تنشيط Gradle ، فإنه يتصل بتوزيع عبر الإنترنت وهو الأحدث ويقوم بتنزيل جميع الوحدات أو الإصدارات المطلوبة من هناك. لقد صادفنا العديد من الحالات التي لم يعمل فيها التوزيع عبر الإنترنت كما هو متوقع وفشل في مزامنة Gradle. حل آخر لهذه المشكلة هو تنزيل توزيع Gradle يدويًا والاستفادة من ذلك. اتبع الخطوات التالية:

1. قم بتنزيل أحدث إصدار من Gradle من موقع إصدار Gradle الرسمي.
2. بعد التنزيل ، قم باستخراج جميع الملفات إلى مجلد يمكن الوصول إليه.
3. قم الآن بتشغيل Android Studio وانتقل إلى ملف> إعدادات> إنشاء ، تنفيذ ، نشر> Gradle .
4. الآن حدد خيار Local Gradle Distribution . أيضًا ، عندما تكون في Gradle home ، أشر إلى المسار الذي استخرجت منه الملفات للتو.

باستخدام توزيع Gradle المحلي - Android Studio

ملاحظة: إذا كنت تستخدم العمل في وضع عدم الاتصال في إعدادات Global Gradle ، فقم بإلغاء تحديد هذا الخيار.

5. حاول الآن إنشاء مشروعك وتحقق مما إذا كان Gradle يتزامن بشكل صحيح. يجب عليك تكرار هذه الخطوات في كل مرة تقوم فيها بإنشاء مشروع جديد.

الحل 5: تمكين مصحح GPU

يمكّنك GPU Debugger من تصحيح تطبيقات OpenGL ES وتحليلها. لديه العديد من الوظائف حيث يتيح لك فحص حالة GPU وفهم أيضًا ما الذي تسبب في نتيجة التقديم. في بعض حالات إنشاء Gradle ، يوجد بعض الأخطاء في النظام حيث لم يتم تمكين هذا. في هذا الحل ، سوف نفرض الوحدات على تحديث وتثبيت هذا المكون.

1. انقر فوق أدوات ، ثم حدد Android> SDK Manager .
2. الآن انقر فوق علامة التبويب أدوات SDK ثم قم بإلغاء تحديد خيار Android SDK Build-Tools . بعد الانتظار لمدة 5 ثوانٍ تقريبًا ، قم بتمكين الخيار مرة أخرى.
3. الآن ، انتظر قليلاً حتى يتم تحديث القائمة وتعبئة العناصر.

أدوات بناء SDK Android

4. بمجرد تعبئة عناصر جديدة ، انظر إلى القائمة وتحقق من خيار أدوات تصحيح GPU . اضغط على موافق عند الانتهاء.

الآن ، سيتم تنزيل هذه الأدوات في تطبيق Android Studio الخاص بك وستكون قادرًا على مزامنة Gradle بشكل صحيح دون أي مشاكل.

الحل 6: تحديث ذاكرة التخزين المؤقت

يحتوي كل تطبيق بما في ذلك Microsoft Windows على ذاكرة تخزين مؤقت في كل مكان لمساعدة التطبيق على العمل بسلاسة دون أي مشاكل. إنها بمثابة تخزين مؤقت حيث يخزن التطبيق تفضيلات أو بيانات مؤقتة ليتم التقاطها لاحقًا. لقد قررنا أن ذاكرة التخزين المؤقت هذه ، إذا كانت تالفة ، ستوقف عملية إنشاء gradle. في هذا الحل ، سنقوم بتحديث ذاكرة التخزين المؤقت بالكامل وبعد حذف ملفات Gradle الموجودة ، أعد تشغيل Android Studio ومعرفة ما إذا كان هذا سيؤدي إلى حل المشكلة.

1. انتقل إلى ملف وانقر فوق إبطال ذاكرة التخزين المؤقت / إعادة التشغيل .
   
   إبطال ذاكرة التخزين المؤقت / إعادة التشغيل
2. الآن بعد الانتهاء من العملية ، أغلق Android Studio لأسفل تمامًا.
3. انتقل إلى مجلد .gradle في دليل تثبيت Android Studio. الآن يمكنك إما قصها / لصقها في مكان آخر أو ببساطة إعادة تسميته.

   الآن عندما يحاول Android studio الوصول إلى ملفات Gradle ، سيظهر أنه لا يوجد حاضر وسيحاول تنزيل الشيء بأكمله مرة أخرى.

4. أعد تشغيل Android Studio وحاول مزامنة Gradle مرة أخرى. تحقق الآن من حل المشكلة.