如何用Swift编程创建共享iCloud Drive文件夹并生成外部访问链接？

核心结论 #

可以通过Apple提供的CloudKit框架和FileProvider API实现，但有严格限制：必须获得用户明确授权，且共享操作不能静默执行——系统会强制弹出权限确认弹窗，用户同意后才能继续。

具体实现步骤 #

1. 配置应用iCloud权限 #

先在Xcode项目的Info.plist中添加必要配置：

• 新增NSUbiquitousContainers键，填入你的iCloud容器ID（格式如iCloud.com.yourcompany.myApp）
• 新增NSiCloudDriveUsageDescription，说明应用访问iCloud Drive的用途（比如“用于同步和共享应用文件”）

2. 定位目标文件夹 #

用FileManager找到iCloud Drive里的“myApp”文件夹，不存在则创建：

import Foundation
import CloudKit

func getMyAppFolderURL() -> URL? {
    guard let iCloudRootURL = FileManager.default.url(forUbiquityContainerIdentifier: nil) else {
        return nil // 未开启iCloud或无权限
    }
    let myAppFolderURL = iCloudRootURL.appendingPathComponent("myApp")
    
    do {
        try FileManager.default.createDirectory(at: myAppFolderURL, withIntermediateDirectories: true)
    } catch {
        print("创建文件夹失败：\(error.localizedDescription)")
        return nil
    }
    return myAppFolderURL
}

3. 创建只读共享链接 #

借助CKShare类生成共享链接，注意必须触发系统授权弹窗：

func createReadOnlyShareLink(for folderURL: URL, completion: @escaping (URL?, Error?) -> Void) {
    CKContainer.default().share(url: folderURL, share: nil, container: nil) { share, _, error in
        guard let share = share, error == nil else {
            completion(nil, error)
            return
        }
        
        // 设置为只读权限
        share[CKSharePermissionKey] = CKSharePermission.readOnly.rawValue as CKRecordValue
        
        // 保存共享记录到CloudKit数据库
        CKContainer.default().publicCloudDatabase.save(share) { savedShare, saveError in
            guard let savedShare = savedShare, saveError == nil else {
                completion(nil, saveError)
                return
            }
            
            // 生成外部可访问的链接
            completion(savedShare.url, nil)
        }
    }
}

关键限制与注意事项 #

• 用户授权不可跳过：调用share(url:...)时，系统会自动弹出权限弹窗，用户必须点击同意才能生成链接，无法后台静默操作
• 外部访问规则：只读链接无需登录Apple ID即可查看，但外部用户无法修改、删除文件夹内的文件
• 范围限制：只能共享应用容器内的文件夹，不能访问用户iCloud Drive根目录下的其他非应用文件夹
• 系统版本要求：上述代码适配iOS 13+/macOS 10.15+，旧版本系统需调整API调用方式

常见问题解答 #

• Q: 为什么调用共享接口没有弹出授权弹窗？
  A: 检查应用是否已获得iCloud Drive访问权限，且必须在真机上测试——模拟器的权限模拟可能存在异常
• Q: 生成的链接有效期是多久？
  A: 默认永久有效，用户可在iCloud设置中手动取消共享或修改权限

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