如何在 iOS 14+ 及更低版本上将文件选择器添加到应用程序

Question

我是 iOS 开发的新手，所以我将在这里展示和询问的一些事情可能很愚蠢，请不要生气 :) 所以，我需要在我的应用程序中添加从本地存储中选择文件的支持。此功能将用于选择文件 -> 编码为 Base64，然后发送到远程服务器。现在我在将这个功能添加到我的应用程序时遇到了一些问题。我找到了this tutorial 并做了这里提到的一切：

1. 添加导入 - import MobileCoreServices

2. 添加实现 - UIDocumentPickerDelegate

3. 添加此代码范围以显示选择器：

   let documentPicker = UIDocumentPickerViewController(documentTypes: [String(kUTTypeText),String(kUTTypeContent),String(kUTTypeItem),String(kUTTypeData)], in: .import)
   documentPicker.delegate = self
   self.present(documentPicker, animated: true)
   

4. 还添加了所选文件的处理程序：

   func documentPicker(_ controller: UIDocumentPickerViewController, didPickDocumentsAt urls: [URL]) {
   print(urls)
   }
   

一般文件选择器出现在模拟器屏幕上，但我在 XCode 中看到警告：

'init(documentTypes:in:)' was deprecated in iOS 14.0

我访问了official guideline，在这里还找到了有关弃用某些方法的类似信息。那么，如何通过与最新iOS版本完全兼容的方式来解决我的文件选择问题。还有另一个问题 - 我如何编码选定的文件？现在我有能力选择文件并打印它的位置，但我需要获取它的数据，如名称、编码内容和其他一些数据。也许有人面临类似的问题并知道解决方案？我需要在普通的viewcontroller中添加它，所以当我尝试添加这个实现时：

UIDocumentPickerViewController

我看到了这样的错误信息：

Multiple inheritance from classes 'UIViewController' and 'UIDocumentPickerViewController'

我会很高兴任何信息：教程或建议 :)

Answer 1

一旦您有了文件 URL，您就可以使用该 URL 来检索它包含的数据。获得数据后，您可以将其转换为 Base64 并将其发送到服务器。您没有提供有关如何将其发送到服务器的信息，但其余部分可能如下所示：

func sendFileWithURL(_ url: URL, completion: @escaping ((_ error: Error?) -> Void)) {
    func finish(_ error: Error?) {
        DispatchQueue.main.async {
            completion(error)
        }
    }
    
    DispatchQueue(label: "DownloadingFileData." + UUID().uuidString).async {
        do {
            let data: Data = try Data(contentsOf: url)
            let base64String = data.base64EncodedString()
            // TODO: send string to server and call the completion
            finish(nil)
        } catch {
            finish(error)
        }
    }
}

你会使用它

func documentPicker(_ controller: UIDocumentPickerViewController, didPickDocumentsAt urls: [URL]) {
    urls.forEach { sendFileWithURL($0) { <#Your code here#> } }
}

分解：

要获取文件数据，您可以使用Data(contentsOf: url)。此方法甚至适用于远程文件，因此您可以例如在您可以访问的 Internet 上的任何地方使用图像链接的 URL。重要的是要知道此方法会暂停您的线程，这通常不是您想要的。

为避免中断当前线程，我们使用DispatchQueue(label: "DownloadingFileData." + UUID().uuidString) 创建一个新队列。队列的名称不是很重要，但在调试时很有用。

收到数据后，我们使用data.base64EncodedString() 将其转换为Base64 字符串，然后可以将这些数据发送到服务器。您只需要填写TODO: 部分即可。

检索您的文件数据可能会出现一些错误。也许访问限制或文件不再存在或没有互联网连接......这是通过抛出来处理的。如果带有try 的语句由于任何原因失败，则catch 部分将执行并且您会收到错误消息。

由于所有这些都是在后台线程上完成的，因此返回主线程通常是有意义的。这就是finish 函数的作用。如果您不需要，您可以简单地删除它并拥有：

func sendFileWithURL(_ url: URL, completion: @escaping ((_ error: Error?) -> Void)) {
    DispatchQueue(label: "DownloadingFileData." + UUID().uuidString).async {
        do {
            let data: Data = try Data(contentsOf: url)
            let base64String = data.base64EncodedString()
            // TODO: send string to server and call the completion
            completion(nil)
        } catch {
            completion(error)
        }
    }
}

在这种方法中还有其他需要考虑的事情。例如，您可以查看用户是否选择了多个文件，然后每个文件都将打开自己的队列并启动该过程。这意味着，如果用户选择多个文件，则可能在某些时候它们中的许多或全部将被加载到内存中。这可能会占用太多内存并使您的应用程序崩溃。由您决定此方法是否适合您或您希望序列化该过程。使用队列进行序列化应该非常简单。您只需要一个：

private lazy var fileProcessingQueue: DispatchQueue = DispatchQueue(label: "DownloadingFileData.main")

func sendFileWithURL(_ url: URL, completion: @escaping ((_ error: Error?) -> Void)) {
    func finish(_ error: Error?) {
        DispatchQueue.main.async {
            completion(error)
        }
    }
    
    fileProcessingQueue.async {
        do {
            let data: Data = try Data(contentsOf: url)
            let base64String = data.base64EncodedString()
            // TODO: send string to server and call the completion
            finish(nil)
        } catch {
            finish(error)
        }
    }
}

现在一项操作将在另一项操作开始之前完成。但这可能仅适用于获取文件数据和转换为 base64 字符串。如果上传是在另一个线程上完成的（通常是这样），那么您可能仍然有多个正在进行的请求，其中可能包含上传所需的所有数据。

Answer 2

我决定发布我自己的问题解决方案。由于我是 ios 开发新手，我的答案可能包含一些逻辑问题:) 首先，我在按下 Attach 按钮后添加了一些选择文件类型的对话框：

@IBAction func attachFile(_ sender: UIBarButtonItem) {
        let attachSheet = UIAlertController(title: nil, message: "File attaching", preferredStyle: .actionSheet)
        
        
        attachSheet.addAction(UIAlertAction(title: "File", style: .default,handler: { (action) in
            let supportedTypes: [UTType] = [UTType.png,UTType.jpeg]
            let documentPicker = UIDocumentPickerViewController(forOpeningContentTypes: supportedTypes)
            documentPicker.delegate = self
            documentPicker.allowsMultipleSelection = false
            documentPicker.shouldShowFileExtensions = true
            self.present(documentPicker, animated: true, completion: nil)
        }))
        
        attachSheet.addAction(UIAlertAction(title: "Photo/Video", style: .default,handler: { (action) in
            self.chooseImage()
        }))
        
        
        attachSheet.addAction(UIAlertAction(title: "Cancel", style: .cancel))
        
        self.present(attachSheet, animated: true, completion: nil)
    }

然后当用户选择File 时，他将被移动到我处理他的选择的普通目录：

func documentPicker(_ controller: UIDocumentPickerViewController, didPickDocumentsAt urls: [URL]) {
        var selectedFileData = [String:String]()
        let file = urls[0]
        do{
            let fileData = try Data.init(contentsOf: file.absoluteURL)
           
            selectedFileData["filename"] = file.lastPathComponent
            selectedFileData["data"] = fileData.base64EncodedString(options: .lineLength64Characters)
            
        }catch{
            print("contents could not be loaded")
        }
    }

正如您在上面的范围中看到的那样，我在将数据发送到服务器之前形成了用于存储数据的特殊字典。在这里您还可以看到 Base64 的编码。

当用户在警报对话框中按下Photo/Video 项目时，他将被移动到图库以进行图片选择：

func chooseImage() {
        imagePicker.allowsEditing = false
        imagePicker.sourceType = .photoLibrary
        
        present(imagePicker, animated: true, completion: nil)
    }
    
    func imagePickerController(_ picker: UIImagePickerController, didFinishPickingMediaWithInfo info: [UIImagePickerController.InfoKey : Any]) {
        var selectedImageData = [String:String]()
        
        
        guard let fileUrl = info[UIImagePickerController.InfoKey.imageURL] as? URL else { return }
        
        
        print(fileUrl.lastPathComponent)
        
        if let pickedImage = info[UIImagePickerController.InfoKey.originalImage] as? UIImage {
            selectedImageData["filename"] = fileUrl.lastPathComponent
            selectedImageData["data"] = pickedImage.pngData()?.base64EncodedString(options: .lineLength64Characters)

            
        }
        
        dismiss(animated: true, completion: nil)
    }
    
    func imagePickerControllerDidCancel(_ picker: UIImagePickerController) {
        dismiss(animated: true, completion: nil)
    }

通过我的方法，所有文件内容都将被编码为base64字符串。

附：我也很高兴@MaticOblak，因为他向我展示了我的研究和最终解决方案的起点。他的解决方案也不错，但我设法以对我的项目更方便的方式解决了我的问题:)