Cordova iOS应用如何将文件下载至iPhone通用Downloads文件夹？

核心结论 #

iOS沙箱机制下，可以通过cordova-plugin-file配合文件复制操作，将文件转移到系统通用Downloads文件夹，让用户在Files app中直接访问。

具体实现步骤 #

• 配置权限与插件
  确保项目中已安装cordova-plugin-file和cordova-plugin-file-transfer，并在config.xml中添加权限描述：

  <platform name="ios">
      <config-file parent="NSDownloadsUsageDescription" platform="ios" target="*-Info.plist">
          <string>需要访问下载文件夹以保存您的文件</string>
      </config-file>
  </platform>
  

• 下载+复制到Downloads目录
  先通过FileTransfer将文件下载到应用沙箱的可写目录（如cordova.file.dataDirectory），再使用cordova-plugin-file的copyTo方法将文件复制到系统Downloads目录：

  // 1. 下载文件到应用沙箱
  const fileTransfer = new FileTransfer();
  const sourceUrl = "https://example.com/your-file.pdf";
  const sandboxPath = cordova.file.dataDirectory + "temp-file.pdf";
  
  fileTransfer.download(sourceUrl, sandboxPath, (entry) => {
      // 2. 复制到系统Downloads目录
      window.resolveLocalFileSystemURL(cordova.file.downloadsDirectory, (dirEntry) => {
          entry.copyTo(dirEntry, "final-file.pdf", (successEntry) => {
              console.log("文件已保存到Downloads:", successEntry.fullPath);
          }, (error) => {
              console.error("复制失败:", error);
          });
      }, (error) => {
          console.error("无法访问Downloads目录:", error);
      });
  }, (error) => {
      console.error("下载失败:", error);
  });
  

关键说明 #

• cordova.file.downloadsDirectory是插件提供的系统Downloads目录路径，iOS上对应Files app中「On My iPhone」下的Downloads文件夹（若启用iCloud，也可配置保存到iCloud的Downloads目录）。
• 首次访问Downloads目录时，系统会弹出权限请求，用户授权后才能完成复制操作。
• 你提到的符号链接方案不可行：iOS沙箱严格禁止跨沙箱的符号链接创建，Files app也无法直接访问应用沙箱内的链接。

替代方案补充 #

如果不想依赖插件复制，也可以通过原生层的UIDocumentInteractionController让用户手动选择保存到Downloads，但这种方式需要用户手动操作，体验不如自动复制流畅。

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