當同一份 iCloud 文件在多個裝置或情境下被修改,系統可能無法自動決定哪一版本才是最新,於是便會出現文件衝突。對使用者而言,衝突處理策略會直接影響資料可信度,因此開發者必須提前設計。
最簡單的方式是以目前版本覆蓋其他版本,適合即時性優先、且舊版本不具保留價值的應用。較複雜的做法是列出衝突內容,讓使用者手動選擇或合併,這適合文字編輯器等需要保留修改軌跡的場景。本文以「目前版本覆蓋舊版本」為例。
在 updateUbiquitousDocuments: 方法中,若 iCloud 文件物件存在,就必須將它加入 NSFileCoordinator 的 file presenter,才能收到文件狀態變化的通知。接著註冊 UIDocumentStateChangedNotification,讓衝突發生時能進入自訂的處理方法。
[NSFileCoordinator addFilePresenter:_myCloudDocument];
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(resolveConflict:) name:UIDocumentStateChangedNotification object:nil];
在 resolveConflict: 中,先檢查 documentState 是否等於 UIDocumentStateInConflict。若是,表示目前確實發生版本衝突。接著使用 NSFileVersion 的 removeOtherVersionsOfItemAtURL:error: 移除其他版本,將目前編輯內容寫回文件,並呼叫 updateChangeCount:UIDocumentChangeDone 告知系統內容已更新。
處理完成後,應移除 UIDocumentStateChangedNotification 的 observer,並將文件物件從 NSFileCoordinator 中解除,避免後續收到非預期通知。這樣即可完成一個以目前版本為準的衝突解決流程。