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

iOS App 升級別讓資料不見:Core Data 資料庫遷移實作指南

編輯:iOS 開發綜合

如果你的 App 有用到 Core Data,而新版本又動過資料庫結構(新增資料表、加欄位等),那麼使用者覆蓋安裝時就會遇到 schema 不相容的問題——舊資料庫打不開,App 一啟動就當掉。這時候必須做 Core Data 的輕量級遷移(Lightweight Migration)。

步驟一:新增一個 Model Version

選中 mydata.xcdatamodeld 檔案,從選單進入 Editor > Add Model Version,命名為例如 mydata2.xcdatamodel。

Xcode 會產生一個新的版本檔,此時專案裡同時存在舊版與新版兩個 model,這是遷移機制的基本前提——系統需要舊版當作「來源 schema」才知道該怎麼轉換。

步驟二:指定當前版本

選中 mydata.xcdatamodeld,在右側 inspector 的 Versioned Core Data Model 區塊中,把 Current 設為 mydata2。

這一步很重要:Current 決定執行時實際載入哪一份 schema。設錯的話,你改的欄位不會生效,或者會直接觸發遷移失敗。

步驟三:修改新的資料模型

在新版 mydata2 上進行你要的變更——新增欄位、新增 entity 等。切記只改新版,舊版保持原狀不動。

輕量級遷移能自動處理的變更範圍有限,主要包括:新增 entity、新增屬性、將屬性設為 optional、把 required 改為 optional 等。若是 rename、型別轉換或資料拆分合併,就需要另外撰寫 mapping model 甚至自訂遷移策略,那就不在本文範圍內了。

步驟四:重新產生 NSManagedObject 子類

刪除原本由 model 產生的類別檔案,然後重新產生一次。因為 schema 變了,舊的類別檔案屬性對不上,留著只會造成編譯或執行期錯誤。

步驟五:在 AppDelegate 加上遷移選項

關鍵是最後掛載 persistent store 時,要告訴 Core Data「自動遷移」與「自動推論 mapping model」:

NSDictionary *optionsDictionary = [NSDictionary dictionaryWithObjectsAndKeys:
    [NSNumber numberWithBool:YES], NSMigratePersistentStoresAutomaticallyOption,
    [NSNumber numberWithBool:YES], NSInferMappingModelAutomaticallyOption,
    nil];

if (![persistentStoreCoordinator addPersistentStoreWithType:NSSQLiteStoreType
                                             configuration:nil
                                                       URL:storeUrl
                                                   options:optionsDictionary
                                                     error:&error]) {
    NSLog(@"failed to add persistent store with type to persistent store coordinator");
}

原本這段程式寫的是 options:nil,把它換成 options:optionsDictionary 即可。這兩個選項的作用分工是:NSMigratePersistentStoresAutomaticallyOption 允許 Core Data 自行推斷並執行遷移;NSInferMappingModelAutomaticallyOption 讓它在 schema 差異夠簡單時自動推論 mapping model,不必你手寫。

步驟六:重新編譯驗證

編譯執行,並用「舊版本安裝 → 覆蓋安裝新版本」的方式實測一次。這是驗證遷移是否成功唯一可靠的方法——直接從乾淨狀態安裝新版本,是不會觸發遷移路徑的。

實務提醒

輕量級遷移有個前提:舊 store 必須是同一個 model 家族延續下來的。如果你在開發過程中不斷重設 schema、又想遷移一個來路不明的 store,失敗是很正常的。

另外建議在正式版上線前,先想清楚「遷移失敗」的退路。實務上常見做法是:遷移失敗時不要直接讓 App 崩潰,而是把舊 store 備份起來、建立一個新的 store 讓 App 能啟動,並提示使用者部分歷史資料可能無法讀取。這比讓使用者完全打不開 App 友善得多。

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