幾乎每個 App 啟動時都要跑一段初始化:建立資料庫、準備預設設定、下載基礎資源。而 App 一旦升版,資料結構可能改變,於是又需要資料遷移。這兩件事如果沒有在早期版本就想清楚,後續每次改版都會變成手忙腳亂的補救工程。本文整理一套可落地的框架設計。
核心機制其實很簡單——保存一個「舊版本號」,啟動時比對它與當前版本號,依結果決定要做什麼:
這個設計的優點是幂等——同一版本重複啟動不會重複執行,而升版時又能精準知道要從哪個版本開始遷移。
上述方案在單一使用者下沒問題,但如果 App 支援多帳號切換,而且各帳號的資料彼此獨立,就會出問題。
關鍵在於:舊版本號不能存在 UserDefaults 裡。因為 NSUserDefaults 是 App 全域共享的。當 A 使用者完成初始化後,舊版本號就被寫入了;此時切換到 B 使用者,程式讀到舊版本號已存在,便跳過初始化——但 B 使用者的資料檔案其實還沒建立,於是整個資料層就壞了。
正確做法是把版本號存到每個使用者各自的私有空間,例如各自的 sqlite 檔案中;讀取時也要帶著使用者的唯一標識一起查詢。
版本資訊的讀取
- (BOOL)needInit
{
return [oldVersion isEqual:@"0"];
}
- (NSString *)oldVersion
{
return oldVersion;
}
- (NSString *)currentVersion
{
return currentVersion;
}
#pragma mark - private method
- (void)initOldVersion
{
// 資料庫檔案不存在,oldVersion 設為 0
NSFileManager *fileManager = [NSFileManager defaultManager];
NSString *dbFilePath = [YLSGlobalUtils getDatabaseFilePath];
if (![fileManager fileExistsAtPath:dbFilePath]) {
oldVersion = @"0";
return;
}
// 資料庫開啟失敗,oldVersion 設為 0
FMDatabase *db = [FMDatabase databaseWithPath:dbFilePath];
if (![db open]) {
oldVersion = @"0";
return;
}
// 版本表不存在,oldVersion 設為 0
int tableCount = 0;
FMResultSet *rs = [db executeQuery:@"select count(*) as count from sqlite_master "
"where type='table' and name='tb_clientstage'"];
if ([rs next]) {
tableCount = [rs intForColumn:@"count"];
}
if (tableCount == 0) {
oldVersion = @"0";
[db close];
return;
}
// 取出舊版本號
rs = [db executeQuery:@"select * from tb_clientstage where id = '1' and tableno = '0'"];
if ([rs next]) {
oldVersion = [rs stringForColumn:@"version"];
} else {
oldVersion = @"0";
}
[db close];
}
- (void)initCurrentVersion
{
NSDictionary *infoDict = [[NSBundle mainBundle] infoDictionary];
currentVersion = [infoDict objectForKey:@"CFBundleVersion"];
}
啟動時的判斷
clientInfo = [YLSClientInfo new];
if ([clientInfo needInit]) {
[self createEverythingForFirstTime]; // 只有首次安裝才執行
}
[self allTheTime]; // 每次啟動都要執行
[migrationHelper doMigration:clientInfo]; // 視版本差異決定是否遷移
增量遷移
- (void)doMigration:(YLSClientInfo *)clientInfo
{
NSString *oldVersion = [clientInfo oldVersion];
NSString *currentVersion = [clientInfo currentVersion];
// 正常登入,版本相同,不需要遷移
if ([oldVersion isEqualToString:currentVersion]) {
return;
}
// 全新安裝而非升級,不需要遷移
if ([oldVersion isEqualToString:@"0"]) {
return;
}
// 以下都是版本升級,需要依起點版本決定要跑哪些腳本
if ([oldVersion isEqualToString:@"1.0.0"]) {
[script1 doMigration];
[script2 doMigration];
[script3 doMigration];
[script4 doMigration];
return;
}
// 其他情況依此類推
}
版本號改用純文字檔。目前把版本號存在 sqlite 裡,首次讀取的判斷邏輯相當繁瑣:要先確認檔案存在、再確認資料表存在、最後才能取值。改用一個小文字檔的話,可以省掉「判斷 table 是否存在」這一步,程式碼簡潔許多。若堅持用資料庫,至少應把這段邏輯抽成獨立方法並加上單元測試。
用整數版本號而非字串。以 @"1.0.0" 這種字串做遞迴 if 判斷,版本一多就會難以維護。實務上常見做法是維護一個有序遷移步驟陣列,每步標註適用範圍,啟動時依序檢查並執行尚未跑過的步驟。
遷移必須可重入。App 可能在遷移途中被系統終止。每個遷移步驟都應該設計成「重跑一次也不會出錯」,並在成功後記錄已完成的步驟。
保留升級路徑而非只做增量。若使用者跨了好幾個大版本(例如從 1.0 直接跳到 4.0),逐版遷移可能非常慢。可以考慮提供一條「大版本直升」路徑,把多個小步驟合併執行。
失敗要能被察覺。遷移失敗若靜默忽略,問題會在很久之後才爆發,且難以回溯。建議完整記錄日誌,並在無法繼續時引導使用者重建資料。