iOS17下如何从iCloud Downloads迁移AirDrop固件文件至应用目录？

一、权限配置要求 #

要让应用读取iCloud Downloads目录，必须在info.plist中添加两类权限配置：

• iCloud容器配置：声明应用对iCloud的访问权限，示例代码如下：

  <key>NSUbiquitousContainers</key>
  <dict>
      <key>iCloud.你的应用BundleID</key>
      <dict>
          <key>NSUbiquitousContainerIsDocumentScopePublic</key>
          <true/>
          <key>NSUbiquitousContainerSupportedFolderLevels</key>
          <string>Any</string>
          <key>NSUbiquitousContainerName</key>
          <string>你的应用名称</string>
      </dict>
  </dict>
  

• 权限描述字段：添加用户授权提示文案，避免被系统拒绝访问：

  <key>NSDownloadsFolderUsageDescription</key>
  <string>需要访问iCloud下载目录，获取AirDrop传输的固件文件</string>
  <key>NSDocumentsFolderUsageDescription</key>
  <string>需要将固件文件迁移至应用专属目录，用于设备固件更新</string>
  

二、程序化迁移文件到自定义目录 #

iOS 17完全支持通过代码将iCloud Downloads中的文件迁移到应用自建的Firmware目录，具体实现步骤：

1. 获取iCloud Downloads目录的URL：

   guard let cloudContainerURL = FileManager.default.url(forUbiquityContainerIdentifier: nil),
         let cloudDownloadsURL = cloudContainerURL.appendingPathComponent("Downloads") as? URL else {
       print("无法访问iCloud容器")
       return
   }
   

2. 筛选并迁移目标XML固件文件：

   do {
       // 获取目录下所有文件
       let allFiles = try FileManager.default.contentsOfDirectory(at: cloudDownloadsURL, includingPropertiesForKeys: nil)
       // 筛选XML格式的固件文件
       let firmwareFiles = allFiles.filter { $0.pathExtension.lowercased() == "xml" }
       
       // 准备应用内的Firmware目录
       let docDir = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0]
       let firmwareDir = docDir.appendingPathComponent("Firmware")
       try FileManager.default.createDirectory(at: firmwareDir, withIntermediateDirectories: true)
       
       // 逐个迁移文件
       for file in firmwareFiles {
           let targetPath = firmwareDir.appendingPathComponent(file.lastPathComponent)
           // 处理重名：如果目标文件已存在，可添加时间戳或其他标识重命名
           if FileManager.default.fileExists(atPath: targetPath.path) {
               let timestamp = String(Int(Date().timeIntervalSince1970))
               let fileName = "\(file.deletingPathExtension().lastPathComponent)_\(timestamp).xml"
               let newTargetPath = firmwareDir.appendingPathComponent(fileName)
               try FileManager.default.moveItem(at: file, to: newTargetPath)
           } else {
               try FileManager.default.moveItem(at: file, to: targetPath)
           }
       }
       print("固件文件迁移完成")
   } catch {
       print("迁移失败：\(error.localizedDescription)")
   }
   

3. 关键注意点：
   • 必须先获取用户对iCloud和下载目录的授权，否则会触发权限错误
   • 若文件还在iCloud同步中，需监听文件下载状态，完成后再执行迁移
   • 迁移时务必处理文件重名场景，避免覆盖用户已有的固件文件

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