# @config-plugins/react-native-pdf 中文文档

规范地址：https://npmcn.com/package/%40config-plugins/react-native-pdf/

版本：14\.0\.2
npm 元数据更新时间：2026-09-23T11:26:03.624Z
中文译文更新时间：2026-11-10T15:16:55.867Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40config-plugins/react-native-pdf
原文对照：https://npmcn.com/package/%40config-plugins/react-native-pdf/?lang=original
项目主页：https://github.com/expo/config-plugins#readme
源码仓库：https://github.com/expo/config-plugins

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：6.4 kB，5 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：expo \>=56
- 首次发布：2021-11-30T21:00:13.702Z
- 最新版本发布：2026-08-15T09:57:36.265Z
- 近 30 天下载量：634834（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 4 个）

## 中文简介

预建时用于自动配置的配置插件

## 安装

```sh
npm install @config-plugins/react-native-pdf
```

也可以使用：`pnpm add @config-plugins/react-native-pdf`、`yarn add @config-plugins/react-native-pdf`、`bun add @config-plugins/react-native-pdf`

## README

# 配置- 插件/ 反应- 本地化- pdf

> 考虑使用WebView或Web浏览器在您的应用中快速显示PDF. 读取替代部分以学习更多.

自动配置的配置插件 [`react-native-pdf`](https://www.npmjs.com/package/react-native-pdf) 当本地代码生成时( w)`npx expo prebuild`) (中文(简体) ).

## 版本

确保您使用共同工作的版本 !

| `expo` | `react-native-pdf` | `@config-plugins/react-native-pdf` |
| --- | --- | --- |
| 56.0.0 (单位:千美元) | 7.0.4 (中文(简体) ) | 14.0.0 (中文(简体) ) |
| 55.0.0 (简体中文) | 7.0.4 (中文(简体) ) | 13.0.0 (单位:千美元) |
| 54.0.0 (单位:千美元) | 6.7.7 国家 | 12.0.0 (单位:千美元) |
| 53.0.0 (韩语) | 6.7.7 国家 | 11.0.0 国家 |
| 52.0.0 (简体中文) | 6.7.6 (中文(简体) ) | 9.0.0 (单位:千美元) |
| 51.0.0 (单位:千美元) | 6.7.5 (单位:千美元) | 8.0.0 (单位:千美元) |
| 50.0.0 (中文(简体) ) | 6.7.4 (中文(简体) ) | 7.0.0 (单位:千美元) |
| 49.0.0 (单位:千美元) | 6.7.1 国家 | 6.0.0 (单位:千美元) |
| 48.0.0 (简体中文) | 6.6.2 国家 | 5.0.0 (单位:千美元) |

### 将软件包添加到您的 npm 依赖性

> 此软件包不能用于“ Expo Go” 应用程序, 因为 [它需要自定义本地代码](https://docs.expo.io/workflow/customizing/)。 。 。 .

首先用纱线、 npm 或 [`npx expo install`](https://docs.expo.io/workflow/expo-cli/#expo-install)。 。 。 .

```
npx expo install react-native-pdf react-native-blob-util @config-plugins/react-native-pdf @config-plugins/react-native-blob-util
```

安装此 npm 软件包后, 添加 [配置插件](https://docs.expo.io/guides/config-plugins/) 页:1 [`plugins`](https://docs.expo.io/versions/latest/config/app/#plugins) 您的数组 `app.json` 或者说 `app.config.js`数字 :

```json
{
  "plugins": [
    "@config-plugins/react-native-blob-util",
    "@config-plugins/react-native-pdf"
  ]
}
```

接下来,重建您的应用程序,如 ["添加风俗本土代码"](https://docs.expo.io/workflow/customizing/) 向导.

### 替代品

考虑打开网页浏览器以显示 PDF :

```js
import * as WebBrowser from "expo-web-browser";
import { Text } from "react-native";

export default function HomeScreen() {
  return (
    <Text
      onPress={() => {
        WebBrowser.openBrowserAsync(
          "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf"
        );
      }}
    >
      Open in-app browser
    </Text>
  );
}
```

或内 `WebView` 对包含的视图:

```js
import { WebView } from "react-native-webview";

export default function HomeScreen() {
  return (
    <WebView
      style={{ width: 100, height: 100 }}
      source={{
        uri: "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
      }}
    />
  );
}
```

或者,如果用户拥有比考虑使用更受欢迎的 PDF 查看器应用程序 `Share` API允许用户在其首选的应用中打开PDF. 这简直就是 `UIDocumentInteractionController` 用于iOS.

终于,你可以使用 [DOM 组件](https://docs.expo.dev/guides/dom-components/) 用于自定义网络体验.

## 常见问题

### @config-plugins/react-native-pdf 是什么？

预建时用于自动配置的配置插件

### 如何安装 @config-plugins/react-native-pdf？

在项目目录运行 npm install @config-plugins/react-native-pdf，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：expo（\>=56）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @config-plugins/react-native-pdf 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @config-plugins/react-native-pdf 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @config-plugins/react-native-pdf 可以商用吗？

@config-plugins/react-native-pdf 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @config-plugins/react-native-pdf 的下载量有多少？

根据 npm 官方下载统计，@config-plugins/react-native-pdf 在 2026/10/11 – 2026/11/09 这 30 天内被下载 634,834 次，日均约 21,161 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @config-plugins/react-native-pdf 还在维护吗？

最新版本 14\.0\.2 发布于 2026/08/15（2 个月前）；至今共发布 18 个版本，其中过去 12 个月发布了 4 个；首次发布于 2021/12/01。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。