在 iOS 開發中,應用之間共享文檔是很常見的需求。但 iOS 為每個 App 提供了獨立的沙盒環境,應用無法直接與另一個應用溝通,因此跨應用傳遞資料必須依賴系統提供的互動機制。
最簡單的跨應用互動手段是 URL Scheme,透過 UIApplication 的 openURL:,以「應用名://」的形式指定要啟動的 App,並在 URL 中附加類似 GET 請求的參數:
[[UIApplication sharedApplication] openURL: [NSURL URLWithString:@"myapp://test_page/one?token=12345&user=ABC"]];
以上程式碼會啟動名為 myapp 的應用,並把 token 與 user 兩個參數傳過去。官方範例中的 LaunchMe 有完整的示範。
不過 URL Scheme 只適合傳遞簡短的文字資料,無法完成文檔共享。要傳檔案,必須用下面的方法。
發起共享的一方通常使用 UIDocumentInteractionController。呼叫 presentOpenInMenuFromRect: 後,系統會彈出一個「Open In」選單,列出所有在 Info.plist 中宣告支援該文檔類型的應用圖示,由使用者自行選擇以哪個 App 開啟。
NSString *filePath = [[NSBundle mainBundle] pathForResource:@"PDF Document" ofType:@"pdf"];
NSLog(@"file path is: %@", filePath);
self.documentController = [UIDocumentInteractionController
interactionControllerWithURL:[NSURL fileURLWithPath:filePath]];
self.documentController.delegate = self;
self.documentController.UTI = @"com.adobe.pdf";
[self.documentController presentOpenInMenuFromRect:CGRectZero
inView:self.view
animated:YES];
把這段程式碼放進某個控件的 action 方法中,觸發該控件就會彈出「Open In」選單。
要注意的是,選單中出現的只是「聲稱」支援該格式的應用,使用者選了哪個、那個 App 是否真能正確處理,是系統與使用者這邊無法控制的。因此 UTI 的設定務必準確,否則會列出不相容的應用造成困惑。
第一件事:在 Info.plist 中宣告支援的文件類型。於專案設定的 Info 頁籤中找到「Document Types」區段,加入 PDF 等類型的設定(包含 UTI、名稱與 icon)。
第二件事:實作 openURL 回呼,取出被共享的檔案。系統會把檔案複製一份到本應用的 Documents/Inbox 目錄,並透過 URL 參數傳入:
- (BOOL)application:(UIApplication *)application
openURL:(NSURL *)url
sourceApplication:(NSString *)sourceApplication
annotation:(id)annotation {
NSLog(@"openURL method was called");
NSLog(@"the source application is: %@", sourceApplication);
NSLog(@"url is: %@", url);
// url 指向 Documents/Inbox 中的檔案,即為他應用共享過來的副本
// 在此處加入你的處理邏輯
return YES;
}
取得這個路徑後,就能在本應用的任意位置讀取該檔案。要特別留意的是 Inbox 目錄是唯讀的,若需要長期保存,必須自行複製到 Documents 或其他可寫目錄中。