跳到主要内容

安装

bkhtmltopdf 基于 Java 21 开发，因此在安装前，您必须确保已安装 JDK 21 或更高版本。本指南将一步步指导您完成 JDK 安装、项目下载和启动操作。

JDK 21​

您可以选择任意 OpenJDK 21 发行版。这里推荐使用 Azul Zulu JDK（开源、稳定），并选择便携式版本（无需系统级安装）。

下载与安装步骤​

  1. 访问 Azul Zulu JDK 下载页面。
  2. 选择适合您操作系统的版本（例如，Windows x64、macOS 或 Linux），下载 ZIP/TAR.GZ 包。
  3. 解压到任意目录，例如：
    • Windows：C:\java\zulu21
    • macOS/Linux：/opt/java/zulu21
  4. 可选）设置环境变量：
    • 将 JDK 的 bin 目录添加到系统 PATH 中。
    • 设置 JAVA_HOME 环境变量指向 JDK 根目录（例如：export JAVA_HOME=/opt/java/zulu21）。

验证安装​

打开终端/命令提示符，运行以下命令验证：

java -version

输出应类似：

openjdk version "21.0.x" 2023-xx-xx
OpenJDK Runtime Environment (build 21.0.x+xx-Zulu21.xx.xx-CA)
提示

如果您使用其他 JDK（如 Oracle JDK 或 Amazon Corretto），确保版本 ≥ 21。

下载 bkhtmltopdf​

  1. 访问 GitHub Release 页面。
  2. 下载最新的 JAR 文件，例如 bkhtmltopdf-x.y.z.jar（其中 x.y.z 为版本号，如 1.0.0）。

将 JAR 文件保存到您的工作目录，例如：

  • Windows：C:\tools\bkhtmltopdf-x.y.z.jar
  • macOS/Linux：~/tools/bkhtmltopdf-x.y.z.jar

启动 bkhtmltopdf​

假设您已完成上述两个步骤，现在可以启动应用。

启动命令​

在终端/命令提示符中，导航到 JAR 文件所在目录，运行以下命令（替换 JDK_PATH 为您的 JDK 安装路径，例如 C:\java\zulu21）：

JDK_PATH/bin/java -jar bkhtmltopdf-x.y.z.jar

示例​

  • Windows：
C:\java\zulu21\bin\java -jar C:\tools\bkhtmltopdf-1.0.0.jar
  • macOS/Linux：
/opt/java/zulu21/bin/java -jar ~/tools/bkhtmltopdf-1.0.0.jar

首次启动说明​

  • 首次运行时，应用会 自动下载 JCEF（Java Chromium Embedded Framework） 依赖。这可能需要几分钟，取决于网络速度。
  • 启动成功后，您将看到类似以下日志：
Tomcat started on port 8080 (http) with context path '/'
Started Application in 0.792 seconds (process running for 1.195)

后续步骤​

启动成功后，您可以参考快速上手文档开始使用 bkhtmltopdf 生成 PDF。如果遇到问题，请查看 GitHub Issues 或提供日志反馈。