您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

開源分享:一套 iOS 資料庫表結構版本升級機制(ARDBConfig)

編輯:iOS 開發綜合

把前陣子開源的程式碼整理發布一下。

ARDBConfig 是什麼

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:

  • 使用者 A 的資料庫是 v1 → 依序執行 v1 → v2 → v3。
  • 使用者 B 的資料庫是 v2 → 執行 v2 → v3。
  • 使用者 C 沒裝過 App → 直接建立 v1 → v2 → v3 的完整結構。

也就是說,升級腳本會被依序、逐版本執行,跳過已經套用過的步驟。這是資料庫遷移(migration)的標準做法:每一次結構變更都是一個獨立、可重複執行的「差異腳本」,而不是針對每個歷史版本各寫一份完整 SQL。

如何使用

情境一:第一次建立資料庫(版本為 1)

  1. 新增一個繼承自 RLDBConfigBase 的類別,例如 DBConfigLogic。
  2. 加上 int 型別的唯讀屬性 dbVersion,實作 getter 並 return 1。
  3. 覆寫父類的 onCreate,在其中寫入第一次建立資料表的 SQL 與程式碼。
  4. 在 App 啟動時(例如 AppDelegate 的 didFinishLaunchingWithOptions)建立 DBConfigLogic 實例並呼叫 checkDatabase,即完成初始化。

情境二:某版本需要改動表結構(版本升為 2)

  1. 把 dbVersion 的回傳值改成 return 2。
  2. 覆寫父類的 onUpgrade,沿用範例中的 switch 骨架,只需在對應的 case 中補上這次的變更 SQL。
  3. 若結構升級完成後還要做資料補償(例如把舊欄位的值搬到新欄位),覆寫 didChecked,在其中寫後續處理。
  4. 同樣在啟動時呼叫 checkDatabase,即可同時完成初始化與升級判斷。

為什麼要這樣設計

把「版本號」當成唯一真相來源

程式啟動時只需比較「裝置上的實際版本」與「程式碼宣告的目標版本」:前者小於後者就走升級流程,相等就什麼都不做。這個判斷點集中在一處,就不會出現「某些頁面記得建表、某些頁面忘了」的情況。

onUpgrade 中的 switch 一定要帶 break

逐版本升級的核心是「只做尚未做過的事」。在 switch (oldVersion) 的每個 case 中,通常刻意不寫 break,讓 v1 的使用者能一路穿透執行 v2、v3 的腳本。這裡必須格外小心:若某個 case 誤加了 break,該版本的資料庫就會停在半路,之後的欄位永遠補不上。

升級要在交易中進行

結構變更若中途失敗(例如新增欄位成功、建立索引失敗),資料庫會處於半吊子狀態,且版本號已寫入,下次啟動就不會再修。建議整個 onUpgrade 包在 BEGIN TRANSACTION / COMMIT 中,失敗即 ROLLBACK。

升級前先備份

涉及刪除欄位、拆分資料表這類不可逆操作的版本,強烈建議在升級前把 .sqlite 檔複製一份到 Documents 或 Caches,為客服排查與使用者資料救援留一條後路。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved