O'rganiladigan tushunchalar

Refleksiya (Reflection) mexanizmi va uning R8 bilan to'qnashuvi.

proguard-rules.pro fayli sintaksisi va -keep turlari.

@Keep annotatsiyasi va mapping.txt deobfuskatsiyasi.

Amaliy ko'nikmalar

Gson / Moshi DTO modellarini R8 dan himoyalash.

Crashlytics chalkash stacktrace hisobotlarini o'qish (Retrace).

Dinamik aktivlar uchun keep.xml faylini sozlash.

Kutilmagan xatolik

Ilovani Debug rejimda ishga tushirsangiz, barcha ma'lumotlar serverdan keladi va chiroyli chiqadi.

Lekin assembleRelease orqali APK yig'ib telefonga o'rnatganda ilova to'satdan qulaydi (Crash).

Asl sabab nima?

R8 koddagi data class maydonlarini «foydalanilmagan» deb hisoblab o'chirgan yoki ularni a, b ga aylantirgan.

JSON o'quvchi kutubxona esa kalitlarni topa olmay qolgan!

R8 uchun yo'riqnoma

Bu app/ papkasida joylashgan maxsus qoidalar fayli.

Undan maqsad: R8 ga qaysi klasslar va metodlarni aslo o'chirmaslik va chalkashtirmaslikni qat'iy buyurish.

Selektiv himoya

Butun ilovani obfuskatsiyasiz qoldirish xavfsizlikka ziyon.

Biz faqat refleksiya orqali chaqiriladigan DTO modellar va tashqi API interfeyslarini saqlaymiz.

Sintaksis tuzilishi

# Bitta klassni saqlash
-keep class com.xorazmiy.app.models.User { *; }

# Butun paket va barcha quyi paketlarni saqlash
-keep class com.xorazmiy.app.models.** { *; }

Bu nimani anglatadi?

class so'zidan keyin to'liq paket yo'li ko'rsatiladi.

{ *; } qismi klass ichidagi barcha maydonlar va metodlarni to'liq saqlab qolishni bildiradi.

Bitta yulduzcha (*)

Faqat ko'rsatilgan paketning to'g'ridan-to'g'ri o'zidagi klasslarga ta'sir qiladi.

# Faqat models/ papkasi ichidagi klasslar
-keep class com.xorazmiy.app.models.* { *; }

Quyi papkalardagi klasslar himoyalanmaydi!

Ikkita yulduzcha (**)

Paket va uning ichidagi BARCHA quyi paketlarni (sub-packages) chuqur qamrab oladi.

# models, models.dto, models.auth va hk.
-keep class com.xorazmiy.app.models.** { *; }

Amaliyotda eng ko'p ishlatiladigan xavfsiz usul.

Nafis optimallashtirish

Klass nomini obfuskatsiya qilish xavfsizlikni kuchaytiradi, faqat JSON o'qiydigan maydonlar o'zgarmasligi lozim.

-keepclassmembers class * {
    @com.google.gson.annotations.SerializedName <fields>;
}

Qanday ishlaydi?

R8 har bir klassni ko'radi: agar maydon tepasida @SerializedName bo'lsa, uning nomiga teginmaydi.

Qolgan biznes mantiq klasslari esa to'liq obfuskatsiya qilinadi!

Kutubxonani ulash

AndroidX annotatsiyalar kutubxonasini build.gradle.kts ga kiritamiz:

dependencies {
    implementation("androidx.annotation:annotation:1.7.1")
}

Klassga qo'llash

Har safar proguard-rules.pro ga yozib o'tirmay, model tepasiga @Keep qo'yiladi:

import androidx.annotation.Keep

@Keep
data class UserOrder(
    val orderId: String,
    val totalAmount: Double
)

Fayl manzili

app/build/outputs/mapping/release/mapping.txt

Bu fayl faqat isMinifyEnabled = true bo'lganda va Release yig'ilganda generatsiya qilinadi.

Oltin qoida: Saqlab qo'ying!

Har bir Play Store'ga chiqarilgan versiyaning mapping.txt faylini maxsus arxivda saqlang.

Agar bu fayl yo'qolsa, release foydalanuvchilaridagi xatolarni o'qib bo'lmaydi!

Shifrlangan log (Obfuscated)

java.lang.NullPointerException:
    at c.a.b.d.a(Unknown:14)
    at com.app.ui.b.c(Source:45)

Qaysi funksiya buzilganini bilib bo'lmaydi.

Retrace qilingan log

java.lang.NullPointerException:
    at AuthService.loginUser()
    at LoginViewModel.execute()

Google Play Console va Crashlytics mapping orqali asl kodni ko'rsatadi.

Ogohlantirishlarni bostirish

Katta kutubxonalar (masalan, Retrofit yoki OkHttp) platformaning boshqa versiyalari uchun yozilgan sinflarga murojaat qilishi mumkin.

R8 ularni topolmay «Warning» beradi va build to'xtab qoladi.

Yechim qoidasi

# Keraksiz ogohlantirishlarni e'tiborsiz qoldirish
-dontwarn okio.**
-dontwarn retrofit2.**

Faqat o'zingiz ishonch hosil qilgan tashqi kutubxonalar uchun qo'llang.

1. Modelni himoyalash

Loyihangizda User nomli model yarating va proguard-rules.pro ga -keep qoidasini qo'shing.

2. mapping.txt tahlili

./gradlew assembleRelease qiling va app/build/outputs/mapping/release/mapping.txt faylini ochib ko'ring.

1. Modellarni doim himoyalang

Gson, Moshi va Retrofit modellari uchun @Keep yoki -keep qo'llash shart.

2. mapping.txt ni saqlang

Har bir release versiya xaritasini arxivlang, deobfuskatsiya uchun zarur.

3. Dinamik resurslarni biling

Agar matn orqali rasm yuklasangiz, res/raw/keep.xml dan foydalaning.

4. Release ni sinovsiz chiqarmang

Har safar release yig'ilganda emulyator yoki real telefonda to'liq test qiling.

1. Modellarni himoyalash

3 ta data class model yaratish va ularni -keep hamda @Keep bilan himoyalash.

2. mapping.txt tahlili

Release build qilib, mapping.txt dagi o'zgarishlarni tahlil qilish.