React Native Expo下载.vcf/.pdf文件遇权限与Asset错误求助

1. 权限问题修复 #

先处理「Missing MEDIA_LIBRARY permissions」错误：

• Expo 项目中使用 expo-media-library 模块申请权限，需区分 Android 版本：
  • Android 12 及以下：申请 MEDIA_LIBRARY 权限
  • Android 13+：申请 READ_MEDIA_IMAGES（若涉及媒体文件），若需访问公共目录存储文档，可能额外需要引导用户开启「所有文件访问权限」
• 权限申请代码示例：

import * as MediaLibrary from 'expo-media-library';
import { Platform } from 'react-native';

async function requestStoragePermissions() {
  const targetPermission = Platform.OS === 'android' && Platform.Version >= 33 
    ? MediaLibrary.Permissions.READ_MEDIA_IMAGES 
    : MediaLibrary.Permissions.MEDIA_LIBRARY;
  
  const { status } = await MediaLibrary.requestPermissionsAsync(targetPermission);
  if (status !== 'granted') {
    alert('需要授予存储权限才能完成下载');
    return false;
  }
  return true;
}

2. 非媒体文件（.vcf/.pdf）下载方案 #

MediaLibrary.createAlbumAsync 仅支持图片、视频、音频等媒体资产，无法直接处理 .vcf/.pdf 这类文档，需改用 expo-file-system 实现下载存储：

• 核心步骤：
  1. 先通过上述方法获取存储权限
  2. 用 FileSystem.downloadAsync 将文件下载到临时缓存目录
  3. 创建目标目录并将文件移动到指定路径（如 Android 的 Pictures/xFolderName）
  4. 可选：调用 MediaLibrary.createAssetAsync 将文件纳入媒体库，让系统可识别
• 完整下载代码示例：

import * as FileSystem from 'expo-file-system';
import * as MediaLibrary from 'expo-media-library';
import { Platform } from 'react-native';

async function downloadDocument(url, fileName) {
  const hasPermission = await requestStoragePermissions();
  if (!hasPermission) return;

  // 定义Android下的目标存储目录
  const targetFolder = `${FileSystem.documentDirectory}Pictures/xFolderName/`;
  // 确保目录存在，不存在则创建
  await FileSystem.makeDirectoryAsync(targetFolder, { intermediates: true });

  // 下载文件到缓存目录
  const downloadResult = await FileSystem.downloadAsync(
    url,
    `${FileSystem.cacheDirectory}${fileName}`
  );

  // 将文件移动到目标目录
  await FileSystem.moveAsync({
    from: downloadResult.uri,
    to: `${targetFolder}${fileName}`
  });

  // 可选：将文件加入自定义相册（让系统媒体库能找到）
  if (Platform.OS === 'android') {
    const asset = await MediaLibrary.createAssetAsync(`${targetFolder}${fileName}`);
    let album = await MediaLibrary.getAlbumAsync('xFolderName');
    if (!album) {
      album = await MediaLibrary.createAlbumAsync('xFolderName', asset);
    } else {
      await MediaLibrary.addAssetsToAlbumAsync([asset], album, false);
    }
  }

  alert('文件下载完成');
}

关键注意事项 #

• 不要直接给 MediaLibrary.createAlbumAsync 传入非媒体文件的URI，必须先通过 MediaLibrary.createAssetAsync 将文档转为媒体库可识别的资产
• Android 13+ 对公共目录访问限制严格，若需要让文件在系统文件管理器中可见，可能需要用 expo-intent-launcher 引导用户手动开启「所有文件访问权限」
• 测试时确保远程文件URL可正常访问，且服务器配置了正确的跨域规则

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