iOS 上的檔案操作,Apple 已經封裝成 NSFileManager 這個類別,幾乎所有與檔案系統相關的工作都能交給它。
取得實例
NSFileManager 沒有公開的 init 方式,請一律透過單例取得,不要自己 alloc:
NSFileManager *manager = [NSFileManager defaultManager];
建立目錄
[manager createDirectoryAtPath:directoryPath
withIntermediateDirectories:YES
attributes:nil
error:nil];withIntermediateDirectories 設為 YES 時,中間層級的目錄會一併建立;回傳值是 BOOL,可直接判斷是否成功。
寫入資料
NSData 提供了便利的寫檔方法:
BOOL isWrite = [_data writeToFile:filePath atomically:YES];
atomically 設為 YES 時,系統會先寫入暫存檔再取代目標檔,避免寫入中途失敗而留下半個檔案,正式專案建議一律開啟。
複製、搬移、刪除
- (BOOL)copyItemAtPath:(NSString *)srcPath toPath:(NSString *)dstPath error:(NSError **)error; - (BOOL)moveItemAtPath:(NSString *)srcPath toPath:(NSString *)dstPath error:(NSError **)error; - (BOOL)removeItemAtPath:(NSString *)path error:(NSError **)error;
這三個方法都會回傳成敗結果,同時透過 error 參數帶出失敗原因。
檢查檔案狀態
- (BOOL)fileExistsAtPath:(NSString *)path; - (BOOL)isReadableFileAtPath:(NSString *)path; - (BOOL)isWritableFileAtPath:(NSString *)path; - (BOOL)isDeletableFileAtPath:(NSString *)path;
最後要特別提醒一個容易忽略的環節:以上路徑都不能天馬行空地寫。App 只能操作自己沙盒內的目錄,實務上最常用的是 Documents(使用者資料,會被 iCloud 備份)、Library/Caches(可隨時重建的暫存資料,不會被備份)與 tmp(系統隨時可能清空)。取得這些路徑要用 NSSearchPathForDirectoriesInDomains 這類 API,而不是把絕對路徑寫死在程式碼裡,否則換一台裝置或升級系統後就會出問題。