把前陣子開源的程式碼整理發布一下。
ARDBConfig
On iOS, provide a database table structure update mechanism, ensuring that users on any version of the app installer will have a compatible database structure.
在 iOS 上提供一個資料庫表結構更新機制,保證使用者無論從哪個版本安裝程式,資料庫結構都能保持適配。
它解決的是一個很典型、也很容易出包的問題:使用者可能從任何一個歷史版本安裝你的 App,因此資料庫結構必須能一路平滑升級上來,而不是只有「全新安裝」這條路徑被測試過。
假設目前最新版本的資料庫結構是 v3:
v1 → v2 → v3。v2 → v3。v1 → v2 → v3 的完整結構。也就是說,升級腳本會被依序、逐版本執行,跳過已經套用過的步驟。這是資料庫遷移(migration)的標準做法:每一次結構變更都是一個獨立、可重複執行的「差異腳本」,而不是針對每個歷史版本各寫一份完整 SQL。
RLDBConfigBase 的類別,例如 DBConfigLogic。int 型別的唯讀屬性 dbVersion,實作 getter 並 return 1。onCreate,在其中寫入第一次建立資料表的 SQL 與程式碼。AppDelegate 的 didFinishLaunchingWithOptions)建立 DBConfigLogic 實例並呼叫 checkDatabase,即完成初始化。dbVersion 的回傳值改成 return 2。onUpgrade,沿用範例中的 switch 骨架,只需在對應的 case 中補上這次的變更 SQL。didChecked,在其中寫後續處理。checkDatabase,即可同時完成初始化與升級判斷。程式啟動時只需比較「裝置上的實際版本」與「程式碼宣告的目標版本」:前者小於後者就走升級流程,相等就什麼都不做。這個判斷點集中在一處,就不會出現「某些頁面記得建表、某些頁面忘了」的情況。
逐版本升級的核心是「只做尚未做過的事」。在 switch (oldVersion) 的每個 case 中,通常刻意不寫 break,讓 v1 的使用者能一路穿透執行 v2、v3 的腳本。這裡必須格外小心:若某個 case 誤加了 break,該版本的資料庫就會停在半路,之後的欄位永遠補不上。
結構變更若中途失敗(例如新增欄位成功、建立索引失敗),資料庫會處於半吊子狀態,且版本號已寫入,下次啟動就不會再修。建議整個 onUpgrade 包在 BEGIN TRANSACTION / COMMIT 中,失敗即 ROLLBACK。
涉及刪除欄位、拆分資料表這類不可逆操作的版本,強烈建議在升級前把 .sqlite 檔複製一份到 Documents 或 Caches,為客服排查與使用者資料救援留一條後路。