資料庫幾乎是每支 App 都會碰到的資料載體,多數團隊習慣在程式進入點就把資料庫準備好。本文以一個最小需求為例,示範兩條常見路徑,並說明各自適合什麼場景。
在 Documents 目錄下建立 test.sqlite,其中包含一張 User 表,欄位為 username 與 password,兩者皆為 varchar。
先用 SQLiteManager 這類工具把資料庫與表結構設計好,把檔案拖進專案,再於程式啟動時判斷沙盒裡有沒有檔案,沒有的話就從 bundle 複製一份出來。
/**
* 若沙盒中尚無資料庫,則從 bundle 複製一份可寫入的副本
*/
- (void)createEditableCopyOfDatabaseIfNeeded {
NSFileManager *fileManager = [NSFileManager defaultManager];
NSError *error;
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *documentsDirectory = [paths objectAtIndex:0];
NSString *writableDBPath = [documentsDirectory stringByAppendingPathComponent:@"test.sqlite"];
if ([fileManager fileExistsAtPath:writableDBPath]) {
NSLog(@"資料庫已存在,無需複製");
return;
}
NSString *defaultDBPath = [[NSBundle mainBundle] pathForResource:@"test" ofType:@"sqlite"];
BOOL success = [fileManager copyItemAtPath:defaultDBPath toPath:writableDBPath error:&error];
if (!success) {
NSLog(@"複製失敗:%@", [error localizedDescription]);
} else {
NSLog(@"資料庫初始化完成");
}
}
FMDB 是 Objective-C 對 SQLite 的常見封裝,把建表語句寫在程式碼裡,第一次啟動時判斷檔案不存在就建立。
/**
* 以程式碼建立資料庫與資料表
*/
- (void)createDatabaseIfNeeded {
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *path = [[paths objectAtIndex:0] stringByAppendingPathComponent:@"test.sqlite"];
if ([[NSFileManager defaultManager] fileExistsAtPath:path]) {
return;
}
FMDatabase *db = [FMDatabase databaseWithPath:path];
if (![db open]) {
debugLog(@"開啟資料庫失敗");
return;
}
NSString *sql = @"CREATE TABLE User (username varchar, password varchar)";
BOOL res = [db executeUpdate:sql];
debugLog(res ? @"User 表建立成功" : @"User 表建立失敗");
[db close];
}
第一種做法把結構設計的負擔前移到開發階段,需求變動時(例如要加幾張表)只要重新產生檔案即可,容錯率明顯較高,多數情況會推薦;第二種的好處是結構完全掌握在程式碼裡,適合結構簡單或需要依條件動態建表的情境。
另外有一個容易被忽略的細節:兩種做法都是「先判斷存在與否」。但 App 升級時,舊版本的資料庫檔案會被系統一併帶到新版本,所以即使你在新版裡整個改了結構,舊檔依然存在,判斷結果就是「已存在、不處理」。若真的需要變更結構,得在升級後另外做遷移邏輯:建立全新資料庫,再把舊資料搬過去。