安装react-native-pdf-lib后Android构建失败求助

云上老周

2026-6-29

解决react-native-pdf-lib Android构建依赖缺失问题及PDF功能替代方案

一、修复当前依赖找不到的问题

1. 添加缺失的Maven仓库

打开项目根目录下的build.gradle文件，找到allprojects -> repositories代码块，添加Tom Roush的专属Maven仓库：

allprojects {
    repositories {
        google()
        mavenCentral()
        // 新增以下仓库
        maven { url "https://maven.tomroush.com/" }
    }
}

2. 清理缓存并重新构建

在项目根目录执行命令：

./gradlew clean
npx react-native run-android

3. 强制替换依赖版本（若上述步骤无效）

如果仍找不到指定版本，可在app/build.gradle中强制使用最新稳定版的pdfbox-android：

dependencies {
    // 其他已有依赖
    implementation("com.tom_roush:pdfbox-android:2.0.27") {
        force = true
    }
}

再次执行./gradlew clean和构建命令。

二、替代库方案（若react-native-pdf-lib仍无法使用）

如果上述修复无效，可考虑以下维护更活跃的库实现PDF创建、编辑与合并：

1. react-native-pdf-utils

专注于PDF文件操作，支持合并、拆分、加密等功能，使用步骤简单：

安装：npm install react-native-pdf-utils --save

合并PDF示例：

import PDFUtils from 'react-native-pdf-utils';

const mergePDFs = async () => {
  const pdfPaths = ['/path/to/pdf1.pdf', '/path/to/pdf2.pdf'];
  const outputPath = '/path/to/merged.pdf';
  await PDFUtils.merge(pdfPaths, outputPath);
};

2. jsPDF + react-native-blob-util

jsPDF用于创建PDF文档，支持添加文本、图片等内容：

import jsPDF from 'jspdf';

const createPDF = () => {
  const doc = new jsPDF();
  doc.text('Hello World!', 10, 10);
  const pdfBlob = doc.output('blob');
  // 通过react-native-blob-util将Blob保存到本地
};