فشل Gradle sync

نص الخطأ

Gradle sync failed: Could not resolve all files for configuration ':app:debugRuntimeClasspath'.

السبب

لم يستطع Gradle تنزيل اعتماديات المشروع. غالبًا السبب الشبكة أو عنوان مستودع ناقص أو ذاكرة تخزين مؤقت قديمة.

الحل خطوة بخطوة

1. اقرأ أول سطر من الخطأ، ففيه اسم المكتبة التي لم تُوجد.
2. تأكد أن settings.gradle يحوي المستودعين google() وmavenCentral().
3. أعد البناء من سطر الأوامر مع --refresh-dependencies لتحديث الذاكرة المؤقتة.
4. إن كنت خلف وكيل (proxy) للشركة فاكتب عنوانه في gradle.properties.
5. هل الإصدار موجود فعلًا؟ تحقق من الرقم في صفحة المكتبة نفسها.

أوامر للمثال

./gradlew --stop
./gradlew assembleDebug --refresh-dependencies --stacktrace
./gradlew :app:dependencies --configuration debugRuntimeClasspath

كيف لا يتكرر

احتفظ بكل الإصدارات في ملف واحد libs.versions.toml وزامن فور التغيير.

المؤلف والترخيص: Nibras Code