دریافت گزارش‌های خرابی خوانا در داشبورد Crashlytics (اندروید)

انتخاب پلاتفرم:

iOS+ Android Web Flutter Unity

افزونه Gradle Crashlytics می‌تواند به‌طور خودکار تشخیص دهد که چه زمانی کدتان را مبهم‌سازی می‌کنید. وقتی ساخت شما فایل نگاشت تولید می‌کند، افزونه آن را بارگذاری می‌کند تا سرورهای Crashlytics بتوانند از فایل برای ارائه رد پشته برنامه شما به‌عنوان کد غیرمبهم و قابل‌خواندن برای انسان استفاده کنند.

پیکربندی لازم هنگام استفاده از R8،‏ ProGuard، و DexGuard

Crashlytics می‌تواند با هر فایل نگاشت سازگار با ProGuard ابهام‌زدایی کند، و علاوه‌براین با ProGuard،‏ R8، و DexGuard آزمایش شده است.

اگر برنامه‌تان از R8 با ابهام‌سازی روشن به‌همراه Android Gradle نسخه ۴.۲.۰ یا بالاتر استفاده می‌کند، Crashlytics گزارش‌های خرابی خوانا تولید خواهد کرد. توجه داشته باشید که Crashlytics اخیراً پشتیبانی از برنامه‌هایی را که از Kotlin و R8 استفاده می‌کنند بهبود داده است، که می‌تواند منجر به برخی برچسب‌گذاری‌های غیرمنتظره برای مشکلات شود.

اگر برنامه‌تان از فایل پیکربندی ProGuard استفاده می‌کند، باید اطلاعاتی را که Crashlytics برای تولید گزارش‌های خرابی خوانا نیاز دارد حفظ کنید. برای انجام این کار، خطوط زیر را به فایل پیکربندی ProGuard یا DexGuard اضافه کنید:

-keepattributes SourceFile,LineNumberTable        # Keep file names and line numbers.
-keep public class * extends java.lang.Exception  # Optional: Keep custom exceptions.

برای دریافت راهنمایی درباره سؤالات یا مشکلات مربوط به DexGuard، مستقیماً با تیم پشتیبانی Guardsquare تماس بگیرید. برای دریافت راهنمایی درباره ProGuard، به تالارهای گفتمان انجمن Guardsquare مراجعه کنید تا از کارشناسان کمک بگیرید.

نگه داشتن تنوع‌های ساخت مبهم‌سازی‌شده

برای جلوگیری از بارگذاری فایل نگاشت توسط افزونه Gradle Crashlytics برای انواع مختلفی که از مبهم‌سازی استفاده می‌کنند، ویژگی افزونه Gradle firebaseCrashlytics.mappingFileUploadEnabled را روی false در فایل Gradle واحد (سطح برنامه) خود تنظیم کنید (معمولاً <project>/<app-module>/build.gradle.kts یا <project>/<app-module>/build.gradle). این کار می‌تواند به افزایش سرعت زمان ساخت برای ساخت‌های مبهم‌شده کمک کند، اما توجه داشته باشید که ردگیری‌های پشته حاصل در صفحه Crashlytics کنسول Firebase مبهم ظاهر خواهند شد.

Kotlin

import com.google.firebase.crashlytics.buildtools.gradle.CrashlyticsExtension

// ...

android {

// To enable Crashlytics mapping file upload for specific build types:
buildTypes {
  getByName("debug") {
    minifyEnabled = true
    configure<CrashlyticsExtension> {
      mappingFileUploadEnabled = false
    }
  }
}

...

// To enable Crashlytics mapping file upload for specific product flavors:
flavorDimensions += "environment"
productFlavors {
  create("staging") {
    dimension = "environment"
    ...
    configure<CrashlyticsExtension> {
      mappingFileUploadEnabled = false
    }
  }
  create("prod") {
    dimension = "environment"
    ...
    configure<CrashlyticsExtension> {
      mappingFileUploadEnabled = true
    }
  }
}
}

Groovy

android {

// To enable Crashlytics mapping file upload for specific build types:
buildTypes {
  debug {
    minifyEnabled true
    firebaseCrashlytics {
      mappingFileUploadEnabled false
    }
  }
}

...

// To enable Crashlytics mapping file upload for specific product flavors:
flavorDimensions "environment"
productFlavors {
  staging {
    dimension "environment"
    ...
    firebaseCrashlytics {
      mappingFileUploadEnabled false
    }
  }
  prod {
    dimension "environment"
    ...
    firebaseCrashlytics {
      mappingFileUploadEnabled true
    }
  }
}
}