React Native Expo项目中expo-print生成PDF，Android无法直接下载仅显示分享界面

问题原因 #

iOS端的shareAsync提供了直接保存到本地的选项，但Android端的shareAsync默认只会唤起系统分享界面，不会自动将文件保存到下载文件夹。要实现Android端自动保存到下载目录，需要单独处理文件复制和权限申请。

解决方案步骤 #

1. 安装依赖
   需要额外安装expo-file-system用于文件操作，以及对应权限模块来申请存储权限：

   # 适用于SDK 43及以下版本
   expo install expo-file-system expo-permissions
   # 适用于SDK 44+版本（expo-permissions已拆分）
   expo install expo-file-system expo-media-library
   

2. 配置Android权限
   在项目根目录的app.json中添加Android存储权限：

   {
     "expo": {
       "android": {
         "permissions": [
           "WRITE_EXTERNAL_STORAGE",
           "MANAGE_EXTERNAL_STORAGE"
         ]
       }
     }
   }
   

3. 修改代码实现跨平台保存逻辑
   针对Android平台，将生成的PDF从临时目录复制到系统下载文件夹；iOS平台可保留原有的分享逻辑：

   import * as Print from 'expo-print';
   import * as Sharing from 'expo-sharing';
   import * as FileSystem from 'expo-file-system';
   import { Platform, Alert } from 'react-native';
   // SDK 43及以下用此导入
   import * as Permissions from 'expo-permissions';
   // SDK 44+替换为下面的导入
   // import * as MediaLibrary from 'expo-media-library';
   
   const downloadFromUrl = async (activityLogs) => {
     const htmlContent = createHtmlContent(activityLogs);
   
     // 生成PDF文件
     const file = await Print.printToFileAsync({
       html: htmlContent,
       base64: true
     });
   
     if (Platform.OS === 'android') {
       // 申请存储权限（SDK 43及以下写法）
       const { status } = await Permissions.askAsync(Permissions.WRITE_EXTERNAL_STORAGE);
       // SDK 44+替换为下面的权限申请代码
       // const { status } = await MediaLibrary.requestPermissionsAsync();
       
       if (status !== 'granted') {
         Alert.alert('权限不足', '需要存储权限才能将PDF保存到下载文件夹');
         return;
       }
   
       // 构造下载文件夹的目标路径，添加时间戳避免文件名重复
       const timestamp = new Date().getTime();
       const targetPath = `${FileSystem.downloadDirectory}ActivityLogs_${timestamp}.pdf`;
       
       try {
         // 将临时PDF文件复制到下载目录
         await FileSystem.copyAsync({
           from: file.uri,
           to: targetPath
         });
         Alert.alert('保存成功', `PDF已保存到下载文件夹：${targetPath.split('/').pop()}`);
       } catch (error) {
         console.error('保存PDF失败:', error);
         Alert.alert('保存失败', '无法将PDF保存到下载文件夹，请重试');
       }
     } else {
       // iOS平台保留原分享逻辑，用户可选择保存到本地
       await Sharing.shareAsync(file.uri);
     }
   };
   

注意事项 #

• 必须在真实Android设备上测试，模拟器可能存在存储权限或目录访问的异常
• Android 10+启用了分区存储，FileSystem.downloadDirectory会指向系统默认的下载文件夹，无需额外路径配置
• 添加时间戳是为了避免重复文件名导致的文件覆盖问题

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