React Native(Expo)离线打开下载PDF文件的方案咨询

你完全不用eject Expo就能实现离线打开下载好的PDF，下面给你几个靠谱的方案，都是社区验证过的实用方法：

方案1：用Expo Linking调用设备自带PDF应用打开（最简便） #

Expo的Linking并不只支持在线URL，它完全可以打开本地文件——只要你拿到正确的本地文件URI，全程不需要eject。

步骤如下：

1. 下载PDF到Expo有权访问的目录（比如FileSystem.documentDirectory，这是Expo专门给APP分配的文件存储目录，权限无问题）：

import * as FileSystem from 'expo-file-system';
import * as Linking from 'expo-linking';

const downloadAndOpenPDF = async () => {
  const pdfUrl = '你的PDF下载源地址';
  const localPath = FileSystem.documentDirectory + 'downloaded.pdf';

  // 执行下载
  const { uri } = await FileSystem.downloadAsync(pdfUrl, localPath);
  
  // 转换为适配Linking的URI（自动处理iOS/Android的格式差异）
  const contentUri = await FileSystem.getContentUriAsync(uri);
  
  // 调用设备上的PDF应用打开文件
  await Linking.openURL(contentUri);
};

2. 注意事项：
   • Expo会自动处理大部分权限，Android端如果遇到访问问题，可以在app.json中添加READ_EXTERNAL_STORAGE权限声明
   • iOS会自动弹出可选PDF应用列表，Android则会调用默认应用或让用户选择打开方式

方案2：在APP内用WebView打开PDF（无需跳转外部应用） #

如果你想让用户在APP内直接查看PDF，不用离开应用，可以用Expo的WebView组件，它支持加载本地PDF文件：

import { WebView } from 'react-native-webview';
import * as FileSystem from 'expo-file-system';

// 假设已完成PDF下载，localPath为文件本地路径
const LocalPDFViewer = ({ localPath }) => {
  // Expo的FileSystem返回的uri已经是file://开头的格式，可直接传给WebView
  return (
    <WebView
      source={{ uri: localPath }}
      style={{ flex: 1 }}
    />
  );
};

这个方案的优势是快速实现、用户无需离开APP，缺点是WebView渲染PDF的性能和原生体验略有差距。

方案3：用Expo官方PDF组件（原生体验，无需eject） #

如果想要更接近原生的PDF查看体验，可以使用expo-pdf库（已整合到Expo官方生态，无需eject）：

1. 先安装依赖：

npx expo install expo-pdf

2. 使用组件渲染本地PDF：

import { PDFView } from 'expo-pdf';
import * as FileSystem from 'expo-file-system';

// 传入已下载好的PDF本地路径
const NativePDFViewer = ({ localPath }) => {
  return (
    <PDFView
      style={{ flex: 1 }}
      source={{ uri: localPath }}
    />
  );
};

这个组件基于原生PDF渲染引擎，体验比WebView好很多，完全符合离线、无需eject的需求。

关于你对Linking的疑问 #

你之前看到的React Native官方文档里的Linking，确实支持本地文件URI——Expo的Linking是基于React Native Linking的扩展，完全兼容本地文件打开，而且不需要eject。只要文件存在于Expo有权访问的目录（比如documentDirectory、cacheDirectory），就能正常调用设备应用打开。

总结一下，三个方案都不需要eject Expo，且支持离线场景：

• 想要简便、利用设备自带应用：选方案1
• 想要APP内快速实现：选方案2
• 想要原生级体验：选方案3

内容的提问来源于stack exchange，提问作者Алексей Передерий