如何用cordova-plugin-advanced-http在iPhone文件/照片应用查看下载文件？

核心原因 #

iOS的cordova.file.documentsDirectory属于应用私有沙盒目录，默认不会暴露给系统的Files应用，所以你下载的文件会存在但无法被用户直接看到。

解决方案步骤 #

1. 更换存储目录 #

改用cordova.file.sharedDocumentsDirectory或者cordova.file.externalDataDirectory（iOS上对应系统可识别的共享目录），这些目录的内容会被Files应用扫描到：

await cordova.plugin.http.downloadFile(
    imageUrl,
    {},
    {},
    cordova.file.sharedDocumentsDirectory + fileName, // 替换为共享目录
    function(entry, response) {
        console.info(entry.name + ' saved successfully.');
    },
    function(response) {
        console.log(response.error);
    }
);

2. 配置应用权限（关键） #

在config.xml中添加iOS平台的配置，开启文件共享能力，让Files应用能访问你的应用目录：

<platform name="ios">
    <!-- 开启应用文件共享 -->
    <config-file parent="UIFileSharingEnabled" target="*-Info.plist">
        <true/>
    </config-file>
    <!-- 允许Files应用直接打开应用内的文件 -->
    <config-file parent="LSSupportsOpeningDocumentsInPlace" target="*-Info.plist">
        <true/>
    </config-file>
</platform>

• UIFileSharingEnabled：让应用的共享目录对Files应用开放
• LSSupportsOpeningDocumentsInPlace：允许Files应用直接访问文件，无需复制副本

3. 验证效果 #

重新编译并安装应用，下载文件后打开Files应用，在「浏览」标签页找到你的应用名称，进入后就能看到下载的图片文件。

额外：同步到Photos应用（可选） #

如果需要让图片出现在Photos应用中，可搭配cordova-plugin-photo-library插件，在下载完成后将文件导入相册：

// 下载成功回调中添加相册导入逻辑
function(entry, response) {
    console.info(entry.name + ' saved successfully.');
    // 导入到相册
    window.PhotoLibrary.saveImage(entry.nativeURL, {
        album: "我的应用相册" // 可选，自定义相册名称
    }, function() {
        console.log("图片已保存到相册");
    }, function(error) {
        console.log("相册导入失败：", error);
    });
}

同时需要在config.xml中添加相册权限说明：

<platform name="ios">
    <config-file parent="NSPhotoLibraryAddUsageDescription" target="*-Info.plist">
        <string>需要访问相册来保存下载的图片</string>
    </config-file>
</platform>

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