如何在iPadOS/iOS的Files应用中定位显示iCloud Drive指定文件（附macOS Finder实现代码）

没问题！在iPadOS/iOS上要实现和macOS里Finder定位文件类似的效果——也就是在Files应用中直接跳转到iCloud Drive Documents目录下的目标文件位置，其实用系统提供的API就能轻松搞定。下面结合你的开发环境（Xcode 12 | iPadOS 14 | Swift 5.4）给你详细的步骤和代码示例：

1. 确保获取正确的iCloud文件URL #

首先你需要确认拿到的是iCloud Drive Documents目录下的有效file://格式URL。如果还未构造，可以通过FileManager来获取：

// 获取iCloud容器的根URL（nil表示使用App默认的iCloud容器）
guard let iCloudContainerURL = FileManager.default.url(forUbiquityContainerIdentifier: nil) else {
    print("iCloud Drive未开启或当前不可用")
    return
}
// 拼接Documents目录和目标文件名
let documentsURL = iCloudContainerURL.appendingPathComponent("Documents")
let targetFileURL = documentsURL.appendingPathComponent("你的目标文件名.ext") // 替换成实际文件名

2. 调用系统API打开并定位文件 #

使用UIApplication.shared.open(_:options:completionHandler:)方法，配合openInPlace选项，就能让Files应用直接打开并定位到目标文件：

// 先检查目标文件是否存在
guard FileManager.default.fileExists(atPath: targetFileURL.path) else {
    print("目标文件不存在，请检查路径是否正确")
    return
}

// 设置打开选项：让Files应用直接在原位置打开（即定位到该文件）
let openOptions: [UIApplication.OpenExternalURLOptionsKey: Any] = [.openInPlace: true]

// 发起打开请求
UIApplication.shared.open(targetFileURL, options: openOptions) { didOpenSuccessfully in
    if didOpenSuccessfully {
        print("已成功在Files应用中定位到目标文件")
    } else {
        print("无法打开Files应用定位文件，请检查文件权限或系统设置")
    }
}

3. 必要的权限配置 #

别忘了在Xcode中开启iCloud Documents权限，否则App无法访问iCloud Drive：

• 打开项目的Signing & Capabilities标签页
• 点击+ Capability，添加iCloud服务
• 勾选iCloud Documents选项，确保App拥有访问iCloud Drive的权限

补充说明 #

• 如果你的文件URL是从文件选择器（UIDocumentPickerViewController）返回的，只要是有效的file://格式且App有访问权限，同样可以用这个方法打开。
• 该方案完全适配iPadOS 14和Swift 5.4，符合你的开发环境要求。

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