开发文件选择器：如何通过NativeScript访问iOS公共文件夹？

嘿，刚好之前做过iOS文件选择器的需求，给你详细说下怎么访问用户的公共文件夹（就是「文件」应用里那些用户自己存文件、下载的区域，不是应用私有沙盒）。iOS因为沙盒机制的限制，不能直接像Android那样遍历公共文件夹，得用系统提供的官方方法，分这几步来：

iOS 13+要求必须声明访问公共文件夹的用途，否则会直接崩溃或者权限被拒绝。你需要在Info.plist里添加以下键值对：

• NSDocumentsFolderUsageDescription：描述应用为什么需要访问Documents文件夹，比如"需要访问Documents文件夹来选择您保存的文件"
• NSDownloadsFolderUsageDescription：描述访问Downloads文件夹的理由，比如"需要访问Downloads文件夹来选择您下载的文件"

如果你的应用需要支持iCloud Drive访问，还要添加NSUbiquitousContainers字典，配置你的iCloud容器ID（可以在苹果开发者后台获取）。

这是苹果推荐的官方方式，用户可以直接在系统的「文件」应用里浏览所有有权限的公共文件夹（包括本地Downloads/Documents、iCloud Drive甚至第三方云存储）。下面是Swift的代码示例：

import UIKit

class FilePickerHandler: NSObject, UIDocumentPickerDelegate {
    private let parentVC: UIViewController
    
    init(parentVC: UIViewController) {
        self.parentVC = parentVC
        super.init()
    }
    
    // 唤起文件选择器
    func showFilePicker() {
        // 支持所有文件类型，也可以指定特定类型比如[.pdf, .image, .plainText]
        let picker = UIDocumentPickerViewController(
            forOpeningContentTypes: [.item], 
            asCopy: false // 设置为false可以直接访问原文件，不用复制到应用沙盒
        )
        picker.delegate = self
        picker.allowsMultipleSelection = true // 支持多选
        parentVC.present(picker, animated: true)
    }
    
    // 处理用户选中的文件
    func documentPicker(_ controller: UIDocumentPickerViewController, didPickDocumentsAt urls: [URL]) {
        for fileURL in urls {
            print("选中文件的URL：\(fileURL)")
            
            // 读取文件内容示例
            do {
                let fileData = try Data(contentsOf: fileURL)
                // 这里可以根据文件类型做后续处理（比如显示图片、解析文本等）
            } catch {
                print("读取文件失败：\(error.localizedDescription)")
            }
        }
        parentVC.dismiss(animated: true)
    }
    
    // 用户取消选择时的处理
    func documentPickerWasCancelled(_ controller: UIDocumentPickerViewController) {
        parentVC.dismiss(animated: true)
    }
}

// 在你的ViewController里调用
// let pickerHandler = FilePickerHandler(parentVC: self)
// pickerHandler.showFilePicker()

如果你想直接访问用户的Downloads文件夹（而不是让用户手动选择），iOS要求必须先通过UIDocumentPicker让用户授权一次，之后才能用FileManager直接访问。示例代码：

func accessDownloadsFolder() {
    guard let downloadsURL = FileManager.default.urls(
        for: .downloadsDirectory, 
        in: .userDomainMask
    ).first else {
        print("无法获取Downloads文件夹路径")
        return
    }
    
    do {
        // 尝试读取文件夹内容
        let files = try FileManager.default.contentsOfDirectory(
            at: downloadsURL, 
            includingPropertiesForKeys: nil
        )
        print("Downloads文件夹内的文件：\(files)")
    } catch {
        // 权限不足，引导用户通过文件选择器授权
        print("无权限访问Downloads文件夹，请先选择文件授权")
        let pickerHandler = FilePickerHandler(parentVC: self)
        pickerHandler.showFilePicker()
    }
}

如果用户希望下次打开应用时能直接访问之前选中的文件，你需要把文件URL保存为安全书签，避免沙盒限制导致权限失效。示例代码：

// 保存安全书签
func saveFileBookmark(for url: URL) {
    do {
        let bookmarkData = try url.bookmarkData(
            options: .withSecurityScope,
            includingResourceValuesForKeys: nil,
            relativeTo: nil
        )
        UserDefaults.standard.set(bookmarkData, forKey: "LastSelectedFileBookmark")
    } catch {
        print("保存安全书签失败：\(error.localizedDescription)")
    }
}

// 恢复访问权限
func restoreFileAccess() -> URL? {
    guard let bookmarkData = UserDefaults.standard.data(forKey: "LastSelectedFileBookmark") else {
        return nil
    }
    
    var isStale = false
    do {
        let url = try URL(
            resolvingBookmarkData: bookmarkData,
            options: .withSecurityScope,
            relativeTo: nil,
            bookmarkDataIsStale: &isStale
        )
        
        // 如果书签过期，重新保存
        if isStale {
            saveFileBookmark(for: url)
        }
        
        // 开始访问文件
        url.startAccessingSecurityScopedResource()
        defer {
            // 用完记得停止访问
            url.stopAccessingSecurityScopedResource()
        }
        return url
    } catch {
        print("恢复文件访问权限失败：\(error.localizedDescription)")
        return nil
    }
}

最后提醒下：苹果审核时会严格检查权限用途，一定要在Info.plist里如实填写访问理由，不能滥用权限哦。

内容的提问来源于stack exchange，提问作者zarax