انهيار ClassNotFound / NoSuchMethod
نص الخطأ
java.lang.ClassNotFoundException: Didn't find class "com.example.Foo" on path: DexPathList java.lang.NoSuchMethodError: No virtual method bar()V in class Lcom/example/Foo;
السبب
صنف أو دالة مفقودة وقت التشغيل. السبب غالبًا حذف R8 للشيفرة أو مكتبة بإصدارين أو خلل multidex.
الحل خطوة بخطوة
- احصل على stack trace كاملًا بـ
adb logcat -b crash. - إن حدث في release فقط فالسبب R8: أضف قاعدة
-keep. - احمِ أصناف reflection ونماذج JSON بـ
-keep. - استخدم
dependenciesلترى هل للمكتبة نفسها إصداران. - إن كان الأثر مشوشًا فشغّل
retraceمعmapping.txt.
أوامر للمثال
adb logcat -b crash
./gradlew :app:dependencies --configuration releaseRuntimeClasspath
# proguard-rules.pro
-keep class com.example.Foo { *; }
retrace mapping.txt trace.txtكيف لا يتكرر
إن استخدمت reflection فاختبر APK من نوع release في كل مرة.
المؤلف والترخيص: Nibras Code
- APK لا يُثبَّت
- ما هو parse error؟
- ضاع ملف keystore
- التواقيع غير متطابقة
- خطأ في اسم الحزمة
- ملف APK تالف
- Play Protect يحظر التطبيق
- تبدو الحزمة غير صالحة
- لا توجد مساحة كافية
- الهاتف غير متوافق
- النسخة الأقدم لا تُثبَّت
- XAPK لا يُثبَّت
- فشل Gradle sync
- تعذّر حل الاعتمادية (Could not resolve)
- خطأ Duplicate class
- Manifest merger failed
- حد Dex: 65536 دالة
- R8: Missing class
- عدم توافق إصدار JDK
- SDK location not found
- تعارض minSdkVersion
- قيمة compileSdk منخفضة جدًا
- EAS build: فشل Gradle
- خطأ expo prebuild
- Metro: Unable to resolve module
- Hermes: خطأ JS في release فقط
- شاشة بيضاء في release
- شاشة حمراء: لا يتصل بـ Metro
- عدم توافق إصدار Expo SDK
- خطأ Capacitor sync
- Capacitor: شاشة بيضاء
- EAS: خطأ keystore وcredentials
- Keystore tampered / كلمة المرور خاطئة
- اسم alias أو كلمة مرور المفتاح خاطئة
- Play: التوقيع بمفتاح خاطئ
- INSTALL_FAILED_UPDATE_INCOMPATIBLE
- INSTALL_FAILED_VERSION_DOWNGRADE
- INSTALL_FAILED_INSUFFICIENT_STORAGE
- INSTALL_FAILED_NO_MATCHING_ABIS
- خطأ في تحليل الحزمة (Parse error)
- خطأ «App not installed»
- تثبيت ملف AAB على الهاتف
- adb: الجهاز «unauthorized»
- adb: الجهاز غير موجود
- عدم تطابق إصدار خادم adb
- Activity class does not exist
- Play: مستوى targetSdk منخفض
- Play: رفض بسبب سياسة الأذونات
- Play: شرط 64-bit
- Play: versionCode مستخدم من قبل
- انهيار OutOfMemoryError
- CLEARTEXT communication not permitted
- SecurityException: الإذن مرفوض