檔案相關的操作是每個專案都會用到的基礎能力。以下整理幾個最常見的需求與對應寫法,並持續補充。
NSString *absoluteFileName =
[[[NSBundle mainBundle] bundlePath] stringByAppendingPathComponent:@"filename.ext"];
bundle 是唯讀的,適合存放隨 App 一起打包的靜態資源。任何寫入需求都必須換到 App 沙盒內的目錄。
// 取得文件根目錄(此目錄可在 iTunes 檔案共享中看見並增減)
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,
NSUserDomainMask,
YES);
// 通常只有一個,取第一個即可
NSString *documentsDirectory = [paths objectAtIndex:0];
// 拼接檔名,得到完整路徑
NSString *absoluteFileName =
[documentsDirectory stringByAppendingPathComponent:@"filename.ext"];
iOS 沙盒中幾個常用目錄的用途值得記住:
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,
NSUserDomainMask,
YES);
NSString *documentsDirectory = [paths objectAtIndex:0];
NSString *absoluteFileName =
[documentsDirectory stringByAppendingPathComponent:fileName];
NSFileManager *fileManager = [NSFileManager defaultManager];
if (![fileManager fileExistsAtPath:absoluteFileName]) {
// 文件目錄中沒有,改從 App bundle 中尋找
absoluteFileName = [[[NSBundle mainBundle] bundlePath]
stringByAppendingPathComponent:fileName];
}
這個「先找沙盒、再退回 bundle」的模式非常實用:App 首次啟動時從 bundle 把預設檔案複製到 Documents,之後一律讀 Documents 的版本,使用者修改的內容就能被保留下來。
// UTF-8
NSString *fileContent = [NSString stringWithContentsOfFile:absoluteFileName
encoding:NSUTF8StringEncoding
error:nil];
// GB 18030(簡體中文常見編碼)
NSStringEncoding stringEncoding =
CFStringConvertEncodingToNSStringEncoding(kCFStringEncodingGB_18030_2000);
NSString *fileContent = [NSString stringWithContentsOfFile:absoluteFileName
encoding:stringEncoding
error:nil];
更多編碼標識可查閱 CoreFoundation/CFStringEncodingExt.h 中的宣告。實務上遇到不明編碼的文字檔,比較有效率的做法是逐一嘗試常見編碼(UTF-8、UTF-16、GB 18030、Big5、Shift JIS),並用下列啟發式方法自動判斷:
// 讓系統自行偵測編碼
NSString *content = [NSString stringWithContentsOfFile:absoluteFileName
usedEncoding:&detectedEncoding
error:&error];
NSLog(@"偵測到的編碼:%lu", (unsigned long)detectedEncoding);
stringByAppendingPathComponent: 而非字串格式化加上 /,前者會處理重複與缺失的斜線。NSError ** 並檢查,不要傳 nil 就當它一定成功。檔案系統錯誤(權限、空間、路徑不存在)在真實環境中很常見。atomically:YES(或 NSData writeToFile:options:NSDataWritingAtomic)。原子寫入會先寫暫存檔再改名,能避免寫到一半被中斷而留下半個壞檔。contentsOfDirectoryAtPath:error: 或 enumeratorAtPath:,不要用已废弃的 directoryContentsAtPath:。