做 iOS 的檔案讀寫,第一步永遠是「我要存到哪裡」。Cocoa Touch 把沙盒內各個職責不同的目錄都定義成了常量,搭配 NSSearchPathForDirectoriesInDomains 就能拿到實際路徑。這篇把常見的取路徑寫法與常量清單一次整理清楚。
#import <Foundation/Foundation.h>
int main(int argc, const char * argv[]) {
@autoreleasepool {
// 應用程式根目錄(沙盒最外層)
NSString *homePath = NSHomeDirectory();
NSLog(@"程序根目錄:%@", homePath);
// Documents:使用者產生的資料,會被 iCloud/iTunes 備份
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSLog(@"Documents:%@", [paths lastObject]);
// Desktop:使用者桌面
paths = NSSearchPathForDirectoriesInDomains(NSDesktopDirectory, NSUserDomainMask, YES);
NSLog(@"桌面:%@", [paths lastObject]);
// Library:輔助資源與設定檔
paths = NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES);
NSLog(@"Library:%@", [paths lastObject]);
// Caches:可隨時清除的快取
paths = NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES);
NSLog(@"Caches:%@", [paths lastObject]);
// tmp:臨時檔案,系統可能隨時清空
NSString *tmpPath = NSTemporaryDirectory();
NSLog(@"臨時目錄:%@", tmpPath);
// 把路徑拆成各層目錄,逐段檢視
paths = [tmpPath pathComponents];
for (int i = 0; i < paths.count; i++) {
NSLog(@"%@", [paths objectAtIndex:i]);
}
}
return 0;
}
以下常量都定義在 NSPathUtilities 相關標頭中,可直接傳給 NSSearchPathForDirectoriesInDomains 或 URLForDirectory:inDomain:appropriateForURL:create:error::
NSApplicationDirectory:已安裝的應用程式(Applications)NSDemoApplicationDirectory:示範版應用程式(Demos)NSDeveloperApplicationDirectory:開發者應用程式,已標記為不建議使用NSAdminApplicationDirectory:系統與網路管理工具(Administration)NSLibraryDirectory:各類文件、支援檔案與資源(Library)NSDeveloperDirectory:開發者資源,同樣已不建議使用NSUserDirectory:使用者家目錄(Users)NSDocumentationDirectory:說明文件(Documentation)NSDocumentDirectory:文件(Documents)NSCoreServiceDirectory:System/Library/CoreServicesNSAutosavedInformationDirectory:自動儲存文件(Documents/Autosaved)NSDesktopDirectory:使用者桌面NSCachesDirectory:可丟棄的快取檔(Library/Caches)NSApplicationSupportDirectory:應用程式支援檔,如外掛(Library/Application Support)NSDownloadsDirectory:使用者的「下載」目錄NSInputMethodsDirectory:輸入法(Library/Input Methods)NSMoviesDirectory、NSMusicDirectory、NSPicturesDirectory:影片、音樂、圖片NSPrinterDescriptionDirectory:印表機 PPD 描述檔(Library/Printers/PPDs)NSSharedPublicDirectory:使用者公開分享目錄(~/Public)NSPreferencePanesDirectory:系統偏好設定的面板(Library/PreferencePanes)NSApplicationScriptsDirectory:呼叫應用程式的使用者腳本資料夾NSItemReplacementDirectory:搭配 URLForDirectory: 系列使用,取得暫時替換用的檔案位置NSAllApplicationsDirectory、NSAllLibrariesDirectory:所有可能出現應用程式/資源的目錄NSTrashDirectory:回收筒選錯目錄,審核或版本更新時容易出問題。大致原則是:使用者看得到、該被備份的資料放 Documents;純粹暫存、可重建的資料放 Caches;過渡用的中間檔放 tmp;需要長期保存但不想讓使用者直接翻到的設定,放 Library 底下自己開的資料夾。另外 iOS 的 App 沙盒預設會整包備份,若把大量快取塞進 Documents,反而會拖慢使用者的備份速度。