您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 教學 >> iOS 相關教學

iOS 檔案移動方法整理:從 NSFileManager 到 FCFileManager

編輯:iOS 相關教學

iOS 的檔案操作幾乎都繞著 NSFileManager 打轉,移動檔案也不例外。本文整理三種常見做法,從最基礎的單檔搬移,到批次搬移整個目錄,最後是一個把常用操作再包一層的第三方工具。

方法一:移動單一檔案

先說明一個容易混淆的點:下面的程式碼示範的是複製,而標題說的是移動。兩者差別在於移動是 moveItemAtPath:toPath:error:,複製則是 copyItemAtPath:toPath:error:。

// 複製
if ([fileManager copyItemAtPath:@"FilePath1"
                         toPath:@"FilePath2"
                          error:NULL]) {
    NSLog(@"Copied successfully");
}

// 移動(原檔案會被移除)
if ([fileManager moveItemAtPath:@"FilePath1"
                         toPath:@"FilePath2"
                          error:NULL]) {
    NSLog(@"Moved successfully");
}

兩者的差異值得記牢:copy 保留來源檔案,move 則會把來源移走。若目標路徑已存在,move 會回傳 NO 並帶出錯誤,這點與部分檔案系統的覆寫行為不同,寫程式時要留意。

方法二:批次搬移整個目錄的內容

使用 NSFileManager 搭配目錄列舉,就能把某個目錄底下的所有檔案一次搬到別處。以下示範把 Documents 目錄的內容全部移到 Caches:

- (void) moveAllDocs {
    NSFileManager *fileManager = [NSFileManager defaultManager];
    NSError *error = nil;

    NSString *sourceDirectory =
        [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
    NSString *destinationDirectory =
        [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) lastObject];

    NSArray *contents = [fileManager contentsOfDirectoryAtPath:sourceDirectory error:&error];

    for (NSString *sourceFileName in contents) {
        NSString *sourceFile = [sourceDirectory stringByAppendingPathComponent:sourceFileName];
        NSString *destFile = [destinationDirectory stringByAppendingPathComponent:sourceFileName];

        if (![fileManager moveItemAtPath:sourceFile toPath:destFile error:&error]) {
            NSLog(@"Error: %@", error);
        }
    }
}

這裡有幾點值得補充:

先確認目標目錄存在。moveItemAtPath:toPath: 不會自動幫你建立目標父目錄,若 Caches 下缺少對應路徑,搬移會失敗。

列舉期間不要更動來源目錄。contentsOfDirectoryAtPath: 回傳的是一個已經取出來的快照陣列,所以在迴圈中搬移檔案本身是安全的;但若要處理大量檔案,改用 enumeratorAtPath: 搭配串流式列舉會更省記憶體。

為什麼要從 Documents 搬到 Caches。Documents 會被使用者看見(透過檔案 App)並納入 iCloud/iTunes 備份;Caches 則不會。因此適合放可重新產生的暫存資料。反過來說,放進 Caches 的檔案要預期它隨時可能被系統清掉,不能當成唯一副本。

方法三:用 FCFileManager 簡化操作

FCFileManager 是一個建構在 NSFileManager 之上的 iOS 檔案管理工具,把最常見的操作都包成了類方法,幾行程式碼就能搞定。它的設計有一個貼心之處:預設以 App 的 Documents 為基準目錄,因此可以直接使用相對路徑;當然,它也完全支援傳入絕對路徑操作其他目錄。

移動檔案:

[FCFileManager moveItemAtPath:@"test.txt" toPath:@"tests/test.txt"];

刪除檔案:

// 刪除指定路徑的檔案
[FCFileManager removeItemAtPath:@"test.txt"];

這類封裝的價值在於把「取得沙盒路徑」、「檢查目標是否存在」、「建立父目錄」這些每次都得重寫的樣板程式收攏起來。不過要提醒的是,任何第三方封裝在大幅簡化 API 的同時,也把錯誤處理的細節藏起來了。若你的專案對檔案操作的失敗有明確的處理需求(例如需要向使用者提示「空間不足」或「權限不足」),仍應確認該套件是否提供了帶 error 參數的版本,或保留直接呼叫 NSFileManager 的能力。

以上三種方式依專案規模與團隊習慣挑選即可。小專案用 NSFileManager 原生 API 足矣;檔案操作頻繁、邏輯重複的地方多,則值得引入一層自己的封裝或成熟套件。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved