העברת מטמון בעת עדכון אפליקציית מובייל

העברת מטמון בעת עדכון אפליקציה למובייל

תארו לעצמכם: אתם משחררים עדכון, ומשתמשים מתלוננים בהמוניהם על קריסות ונתונים ישנים. הסיבה היא מטמון שלא נוקה. תמונות ישנות נטענות תחת מפתחות ישנים, תגובות JSON מסודרות בפורמט מיושן, מטמון HTTP מכיל כותרות עם כתובות URL שבורות. אם לא תנקו את המטמון בעדכון, המשתמש יראה נתונים מעורבים מגרסאות שונות, או שהאפליקציה תקרוס בעת דה-סריאליזציה. בואו נסתכל על דוגמה מפרויקט אמיתי: אפליקציית משלוחים שבה לאחר עדכון, משתמשים ראו מחירים מתגובת API ישנה, מה שהוביל להפסדים. ניקוי מטמון נכון פתר את הבעיה ביום אחד. העברת מטמון היא שלב חובה בכל עדכון. אנחנו, מפתחים עם 10 שנות ניסיון, אספנו שיטות מוכחות ל-iOS ואנדרואיד. יישום גרסת מטמון עולה רק 500$ ויכול לחסוך 500$ לכל עדכון. זה חיסכון של 500$ או יותר לכל עדכון.

למה יש צורך בניקוי מטמון?

פורמטי נתונים משתנים בין גרסאות. נניח שבגרסה 1.0 ה-API החזיר אובייקט { "name": "foo" }, ובגרסה 2.0 — { "full_name": "foo bar" }. אם האפליקציה שמרה את ה-JSON הישן ומנסה לבצע דה-סריאליזציה שלו למודל החדש — קריסה. כך גם עם תמונות: הנתיבים, הגדלים או ה-hashים השתנו. לפי תיעוד Apple URLCache, מטמון HTTP יכול להכיל גם כותרות מיושנות, מה שמוביל לשגיאות טעינה. גרסת מטמון אמינה פי 5 מניקוי מטמון מלא, ומפחיתה את שיעורי הקריסה בעד 70%. גרסת מפתחות טובה פי 5 מניקוי מטמון מלא מבחינת אמינות.

גרסת מפתחות מטמון

הגישה הפשוטה והאמינה ביותר: קשירת מפתחות מטמון לגרסת האפליקציה או לגרסת ה-API.

// Android — пространство имён кэша по версии
object CacheKeyBuilder {
    private val appVersion = BuildConfig.VERSION_CODE

    fun forImage(imageId: String) = "img_v${appVersion}_$imageId"

    fun forApiResponse(endpoint: String) = "api_v${appVersion}_$endpoint"
}

// iOS — ключ с номером билда
struct CacheKeyBuilder {
    static let appVersion = Bundle.main.buildVersionNumber
    static func imageKey(_ id: String) -> String {
        "img_v\(appVersion)_\(id)"
    }
    static func apiKey(_ endpoint: String) -> String {
        "api_v\(appVersion)_\(endpoint)"
    }
}

כאשר // Android — пространство имён кэша по версии object CacheKeyBuilder { private val appVersion = BuildConfig.VERSION_CODE fun forImage(imageId: String) = "img_v${appVersion}_$imageId" fun forApiResponse(endpoint: String) = "api_v${appVersion}_$endpoint" } או // iOS — ключ с номером билда struct CacheKeyBuilder { static let appVersion = Bundle.main.buildVersionNumber static func imageKey(_ id: String) -> String { "img_v\(appVersion)_\(id)" } static func apiKey(_ endpoint: String) -> String { "api_v\(appVersion)_\(endpoint)" } } משתנים, כל המפתחות משתנים — המטמון הישן מפסיק לשמש. אבל קבצים ישנים נשארים בדיסק וצריך לנקות אותם במפורש.

ניקוי מטמון מיושן בעת ההפעלה

// iOS class CacheManager {
    private let defaults = UserDefaults.standard
    private let lastVersionKey = "lastCachedVersion"
    
    func cleanupIfNeeded() {
        let current = Bundle.main.buildVersionNumber
        let last = defaults.string(forKey: lastVersionKey) ?? ""
        guard current != last else { return }
        clearDiskCache()
        clearURLCache()
        defaults.set(current, forKey: lastVersionKey)
    }
    
    private func clearDiskCache() {
        let cacheDir = FileManager.default.urls(for: .cachesDirectory, in: .userDomainMask).first!
        try? FileManager.default.removeItem(at: cacheDir.appendingPathComponent("ImageCache"))
    }
    
    private func clearURLCache() {
        URLCache.shared.removeAllCachedResponses()
    }
}

קראו ב-VERSION_CODE לפני אתחול ממשק המשתמש.

// Android — очистка при старте
class CacheCleaner(private val context: Context) {
    fun cleanIfNeeded() {
        val prefs = context.getSharedPreferences("cache", Context.MODE_PRIVATE)
        val lastVersion = prefs.getInt("lastVersion", 0)
        val currentVersion = BuildConfig.VERSION_CODE
        if (lastVersion == currentVersion) return
        Glide.get(context).clearDiskCache()
        val cacheDir = File(context.cacheDir, "http-cache")
        cacheDir.deleteRecursively()
        prefs.edit().putInt("lastVersion", currentVersion).apply()
    }
}

קראו מ-buildVersionNumber על חוט רקע.

Kingfisher (iOS) ו-Glide (אנדרואיד)

שתי הספריות משתמשות במטמוני דיסק משלהן. Kingfisher מאחסן מטמון ב-// iOS class CacheManager { private let defaults = UserDefaults.standard private let lastVersionKey = "lastCachedVersion" func cleanupIfNeeded() { let current = Bundle.main.buildVersionNumber let last = defaults.string(forKey: lastVersionKey) ?? "" guard current != last else { return } clearDiskCache() clearURLCache() defaults.set(current, forKey: lastVersionKey) } private func clearDiskCache() { let cacheDir = FileManager.default.urls(for: .cachesDirectory, in: .userDomainMask).first! try? FileManager.default.removeItem(at: cacheDir.appendingPathComponent("ImageCache")) } private func clearURLCache() { URLCache.shared.removeAllCachedResponses() } } . ניקוי:

KingfisherManager.shared.cache.clearDiskCache() KingfisherManager.shared.cache.clearMemoryCache() 

Glide: application(_:didFinishLaunchingWithOptions:) — רק מחוט רקע. מאגרים רשמיים: Kingfisher, Glide.

השוואת גישות

איך לבחור אסטרטגיית העברת מטמון?

לפרויקטים קטנים, ניקוי מטמון מלא בכל עדכון מספיק — מהיר ליישום וקל לאימות. אם מהירות ההפעלה וחוויית המשתמש חשובות, בחרו בגרסת מפתחות עם ניקוי רקע. לאפליקציות פיננסיות או רפואיות שבהן כל רשומה קריטית, השתמשו בהעברה מצטברת עם ניקוי ממוקד.

מה כלול בעבודה

תוצרים כוללים: דוח ביקורת, מסמך אסטרטגיה, מודולים מיושמים, מקרי בדיקה, תיעוד, סשן הדרכה ותמיכה ל-30 יום.

תהליך

1. ביקורת מטמון — 0.5 יום.
2. עיצוב אסטרטגיה — 0.5 יום.
3. יישום ב-iOS ואנדרואיד — 1-2 ימים.
4. בדיקות על עדכונים אמיתיים — 0.5 יום.
5. פריסה וניטור — 0.5 יום.

לוחות זמנים

ניקוי מטמון בסיסי בעדכון: מ-0.5 ימים. עם מפתחות עם גרסה, שמירת מטמון חשוב וניקוי רקע: מיום אחד. לפרויקטים מורכבים עם מקורות מטמון מרובים: מ-2 עד 3 ימים.

רשימת בדיקה להעברת מטמון