מיפוי ProGuard/R8: פיענוח קריסות אנדרואיד

אפשר העלאה אוטומטית ב-Gradle. ב-app/build.gradle.kts הוסף:

android {
    buildTypes {
        release {
            isMinifyEnabled = true
            isShrinkResources = true
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
        }
    }
}
firebaseCrashlytics {
    mappingFileUploadEnabled = true
    nativeSymbolUploadEnabled = false
}

הגדרה מפורשת של android { buildTypes { release { isMinifyEnabled = true isShrinkResources = true proguardFiles( getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro" ) } } } firebaseCrashlytics { mappingFileUploadEnabled = true nativeSymbolUploadEnabled = false } מבטיחה שזה יעבוד ללא קשר לגרסת AGP.

הגדר העברת google-services.json ב-CI. לעולם אל תכלול קובץ זה ב-commit. השתמש במשתנה סביבה מאובטח ופענח אותו לפני הבנייה:

---
# GitHub Actions
- name: Decode google-services.json
  env:
    GOOGLE_SERVICES_JSON: ${{ secrets.GOOGLE_SERVICES_JSON }}
  run: |
    echo "$GOOGLE_SERVICES_JSON" | base64 --decode > app/google-services.json
---

הרץ את משימת ההעלאה בנפרד. לאחר mappingFileUploadEnabled = true בצע:

./gradlew uploadCrashlyticsMappingFileRelease 

זה מבטיח שה-CI ממתין להשלמת ההעלאה. ללא משימה זו, הפלאגין עשוי לסיים את ההעלאה באופן אסינכרוני והמיפוי עלול לא להגיע ל-Crashlytics.

אחסן את קובץ המיפוי לכל גרסה. הוסף שלב CI:

cp app/build/outputs/mapping/release/mapping.txt artifacts/mapping-${VERSION_NAME}-${VERSION_CODE}.txt 

שמור קבצים למשך 6 חודשים לפחות — משתמשים עשויים להריץ גרסאות ישנות.

ודא את ה-deobfuscation. השתמש ב-# GitHub Actions - name: Decode google-services.json env: GOOGLE_SERVICES_JSON: ${{ secrets.GOOGLE_SERVICES_JSON }} run: echo "$GOOGLE_SERVICES_JSON" | base64 --decode > app/google-services.json מקומית או בדוק ב-Firebase Console. אם retrace מקומי משחזר את עקבות המחסנית אבל הקונסול לא, המיפוי לא הועלה.

מדוע ה-deobfuscation נשבר ב-R8 fullMode

ב-AGP 8.x, R8 fullMode מופעל כברירת מחדל ומסיר סמלים באגרסיביות רבה יותר. ספריות כמו Retrofit, Gson ו-Room דורשות כללי keep מפורשים. בלעדיהם, המיפוי חסר מספרי שורות ומחלקות מפתח.

# proguard-rules.pro
-keepattributes SourceFile,LineNumberTable
-keep class com.example.app.data.model.** { *; }
-keepclassmembers class * {
    @com.google.gson.annotations.SerializedName <fields>;
}

assembleRelease הוא חובה — אחרת מספרי השורות יהיו שגויים, ועקבות המחסנית יישארו חלקית obfuscated.

כיצד לוודא שהמיפוי הועלה

1. עבור אל Firebase Console → Crashlytics → בחר את האפליקציה שלך → שלוש נקודות → Mapping Files.
2. ודא שקובץ מיפוי לגרסה שלך מופיע (תואם ל-versionName ול-versionCode).
3. אם אין קובץ, בדוק את יומן ה-Gradle לשגיאות העלאה או הרץ את הפקודה ידנית שוב.

מה כלול בהתקנה מלאה

• ביקורת על תצורת ProGuard/R8 הנוכחית: בדיקת כללים, דגלים ותאימות ל-AGP.
• הגדרת משימת Gradle ./gradlew uploadCrashlyticsMappingFileRelease עבור כל ה-flavors וסוגי הבנייה של release.
• אינטגרציה עם ה-CI שלך (GitHub Actions, GitLab CI, Jenkins) עם העברת google-services.json דרך secrets.
• פיתוח סקריפט לארכיון קבצי מיפוי לארטיפקטים עם שמות מבוססי גרסה.
• אימות deobfuscation על קריסה אמיתית מ-Crashlytics.
• תיעוד לתחזוקה ועדכוני תצורה.

הערכות זמן

התקנה לפרויקט סטנדרטי עם CI ב-GitHub Actions אורכת 3–6 שעות. לפרויקט מרובה מודולים עם רכיבי NDK ומספר flavors, זה לוקח 1–2 ימי עבודה, כולל אימות בכל גרסאות הבנייה. העלות מחושבת בנפרד.

יש לנו יותר מ-10 שנות ניסיון עם Firebase Crashlytics ו-deobfuscation, והגדרנו למעלה מ-40 פרויקטים. אנו מבטיחים פעולה תקינה של המנגנון. צור קשר כדי להגדיר deobfuscation בפרויקט שלך. בקש התקנה מלאה: מביקורת ועד פריסה.