Documentation – 入门

Rust-Cpp: 如何通过 C++ 为 Rust 安装 Aspose.PDF

Mon, 20 Jul 2026 00:00:00 +0000

安装

从 Aspose 网站安装

此软件包包括一个大型文件，存储为 bzip2 存档。

下载存档 Aspose.PDF for Rust via C++，来源于官方 Aspose 网站。最新（最近）的版本列在顶部，默认情况下点击 Download 按钮时会下载该版本。建议使用此最新版本。如有需要，仅下载之前的版本。示例： Aspose.PDF-for-Rust-via-CPP-25.6.zip

存档文件名的格式是： Aspose.PDF-for-Rust-via-CPP-YY.M.zip，其中：
- YY = 年份的最后两位（例如， 25 用于 2025)
- M = 月号来自 1 到 12
提取存档到您选择的目录 {path} 使用合适的工具：
- 在 Linux/macOS 上：
```
unzip Aspose.PDF-for-Rust-via-CPP-YY.M.zip -d {path}
```
- 在 Windows 上，使用内置的 Explorer 解压功能或任何解压工具（7-Zip、WinRAR）。
添加库作为依赖到你的 Rust 项目中。你可以通过两种方式实现：
- 使用命令行:
```
cargo add asposepdf --path {path}/asposepdf
```
- 手动编辑 Cargo.toml: 打开你的项目 Cargo.toml 并在以下位置添加 [dependencies]:
```
[dependencies]
asposepdf = { path = "{path}/asposepdf" }
```
构建你的项目 (cargo build). 在第一次构建时，适用于您平台的相应动态库将自动从 lib 文件夹中的 .bz2 存档中提取并链接到您的项目。

注释

构建脚本尝试在您的输出目录中创建一个 符号链接 指向库（例如， target/debug/).
对于 Linux 和 macOS，您还必须遵循运行时配置下面的章节确保可执行文件在运行时能够找到库。
全部 .bz2 档案具有对应的 .sha256 校验和文件。如果校验和缺失或无效，构建将失败。

从 GitHub 安装

此软件包包含预编译的本机库（.dll, .so, .dylib) 这些被压缩存储 .bz2 GitHub 仓库内的归档。

添加库作为依赖到你的 Rust 项目中。你可以通过两种方式实现：
- 使用命令行:
```
cargo add asposepdf --git https://github.com/aspose-pdf/aspose-pdf-rust-cpp.git
```
- 手动编辑 Cargo.toml:
  
  打开你的项目 Cargo.toml 并在以下位置添加 [dependencies]:
```
[dependencies]
asposepdf = { git = "https://github.com/aspose-pdf/aspose-pdf-rust-cpp.git" }
```
注意: 要使用特定的发布版本，您可以指定标签:

asposepdf = { git = “https://github.com/aspose-pdf/aspose-pdf-rust-cpp.git", tag = “v1.26.1” } > ```

构建你的项目 (cargo build). 在第一次构建时，适用于您平台的相应动态库将自动从 lib 文件夹中的 .bz2 存档中提取并链接到您的项目。

注释

您无需手动下载或提取任何文件——所有内容都已包含在 GitHub 仓库中。
构建脚本尝试在您的输出目录中创建一个 符号链接 指向库（例如， target/debug/).
对于 Linux 和 macOS，您还必须遵循运行时配置下面的章节确保可执行文件在运行时能够找到库。
全部 .bz2 档案匹配 .sha256 校验文件。校验和在解压前进行验证。
如果校验和验证失败或归档缺失，构建将以详细错误信息失败。

从 crates.io 安装

此软件包可在 crates.io. 由于大小限制，已发布的 crate 不包含本机二进制库 (".dll, .so, 或 .dylib). 您可以从官方分发档案（请参见从 Aspose 网站安装) 或从 GitHub 仓库（参见从 GitHub 安装). 构建脚本将在构建过程中定位、验证并从压缩的 .bz2 存档中提取适当的本机库。

添加库作为依赖到你的 Rust 项目中。你可以通过两种方式实现：
- 使用命令行:
```
cargo add asposepdf
```
- 手动编辑 Cargo.toml:
  
  打开你的项目 Cargo.toml 并在以下位置添加 [dependencies]:
```
[dependencies]
asposepdf = "1.26.1"
```
设置路径 到包含本机库的目录，并下载所需文件：
- 设置环境变量 ASPOSE_PDF_LIB_DIR 指向您将放置本机文件的文件夹 .bz2 档案，它们的 .sha256 校验和文件，以及提取的本机库（.dll, .so, .dylib，以及 Windows 同样适用 .lib):
  - 在 Linux/macOS 上:
```
export ASPOSE_PDF_LIB_DIR=/path/to/lib
```
  - 在 Windows（命令提示符）:
```
set ASPOSE_PDF_LIB_DIR=C:\path\to\lib
```
  - 在 Windows (PowerShell)：
```
$env:ASPOSE_PDF_LIB_DIR = "C:\path\to\lib"
```

关于 ASPOSE_PDF_LIB_DIR 的注释

该 ASPOSE_PDF_LIB_DIR 环境变量定义了构建脚本的工作目录。它仅在编译期间用于定位、验证和提取本机库归档。设置此变量不会自动将该目录添加到系统的运行时库搜索路径（见运行时配置).

下载所需的 .bz2 archives** 和 checksum 文件来自 GitHub 仓库的 lib/ 文件夹并将它们放入已设置的文件夹中 ASPOSE_PDF_LIB_DIR:
对于 Linux x64，下载：
- libAsposePDFforRust_linux_amd64.so.bz2
- libAsposePDFforRust_linux_amd64.so.bz2.sha256
对于 macOS x86_64，下载:
- libAsposePDFforRust_darwin_amd64.dylib.bz2
- libAsposePDFforRust_darwin_amd64.dylib.bz2.sha256
对于 macOS arm64，下载：
- libAsposePDFforRust_darwin_arm64.dylib.bz2
- libAsposePDFforRust_darwin_arm64.dylib.bz2.sha256
对于 Windows x64，下载：
- AsposePDFforRust_windows_amd64.dll.bz2
- AsposePDFforRust_windows_amd64.dll.bz2.sha256
- AsposePDFforRust_windows_amd64.lib （本机导入库，未压缩）

注意： 您需要手动从 GitHub 下载这些文件，并将它们放入所指向的目录中 ASPOSE_PDF_LIB_DIR.
构建脚本将自动从中解压本机库 .bz2 首次构建时的归档。

构建你的项目 (cargo build). 在第一次构建时，将自动从该提取与您的平台匹配的本机库 .bz2 归档并链接到您的项目。

重要： 对于 Linux 和 macOS，您还必须遵循运行时配置下面的章节确保可执行文件在运行时能够找到库。

注释

该 ASPOSE_PDF_LIB_DIR 变量仅在构建过程中用于定位和提取存档。
构建脚本尝试在您的输出目录中创建指向已提取库的 符号链接（例如， target/debug/).
您必须提供包含的文件夹 .bz2 和 .sha256 将文件单独处理，因为这些二进制归档未通过 crates.io 分发。
如果所需的归档缺失或校验和不通过，构建将因详细错误而失败。
通过 GitHub 或 Aspose 网站用于安装的相同二进制文件可以在此处重复使用。

快速入门

所有代码片段都包含在代码片段.

Rust-Cpp: 系统要求

Mon, 20 Jul 2026 00:00:00 +0000

Aspose.PDF for Rust via C++ 的支持平台

asposepdf 包是一个强大的工具包，允许开发人员直接操作 PDF 文件并帮助完成各种 PDF 任务。包含将 PDF 转换为其他格式的独特功能。

已实现对 Linux x64、macOS x86_64、macOS arm64 和 Windows x64 平台的支持。

在包根目录的 ’lib’ 文件夹中，需要平台特定版本的动态库来分发生成的应用程序：

适用于 Linux x64 平台的 libAsposePDFforRust_linux_amd64.so
适用于 macOS arm64 平台的 libAsposePDFforRust_darwin_arm64.dylib
适用于 macOS x86_64 平台的 libAsposePDFforRust_darwin_amd64.dylib
AsposePDFforRust_windows_amd64.dll 用于 Windows x64 平台。

Rust-Cpp: 使用 Rust 语言的 Hello World 示例

Mon, 20 Jul 2026 00:00:00 +0000

传统上，"Hello World" 示例用于通过一个简单的用例来介绍编程语言或软件的特性。

Aspose.PDF for Rust 是一个功能丰富的 PDF API，允许开发人员使用 Rust 嵌入 PDF 文档的创建、操作和转换功能。它支持许多流行的文件格式，包括 PDF、TXT、XLSX、EPUB、TEX、DOC、DOCX、PPTX、图像格式等。在本文中，我们将创建一个包含文本 “Hello World!” 的 PDF 文档。安装 Aspose.PDF for Rust 后，您可以运行代码示例，了解 Aspose.PDF API 的工作方式。下面的代码片段遵循以下步骤：

创建一个新的 PDF 文档实例。
使用以下方式向 PDF 文档添加新页面 page_add 函数。
使用以下方式设置页面大小 page_set_size.
使用以下方式在第一页添加 “Hello World!” 文本 page_add_text.
使用以下方式保存 PDF 文档 save_as 方法。

以下代码片段是一个 Hello World 程序，用于展示 Aspose.PDF for Rust API 的工作原理。


    use asposepdf::{Document, PageSize};
    use std::error::Error;

    fn main() -> Result<(), Box<dyn Error>> {
        // Create a new PDF-document
        let pdf = Document::new()?;

        // Add a new page
        pdf.page_add()?;

        // Set the size of the first page to A4
        pdf.page_set_size(1, PageSize::A4)?;

        // Add "Hello World!" text to the first page
        pdf.page_add_text(1, "Hello World!")?;

        // Save the PDF-document as "hello.pdf"
        pdf.save_as("hello.pdf")?;

        println!("Saved PDF-document: hello.pdf");

        Ok(())
}

Rust-Cpp: 受支持的文件格式

Mon, 20 Jul 2026 00:00:00 +0000

以下表格指示了 Aspose.PDF for Rust 能够加载和保存的文件格式。

格式	描述	加载	保存	备注
PDF	可移植文档格式
EPUB	电子书文件格式
TeX	LaTex 排版文件格式
SVG	可扩展矢量图形（基于 XML 的矢量图像格式）
XPS	XPS 文档
XLSX	将文档保存为 Microsoft Excel 2007 格式
PPTX	将文档保存为 Microsoft PowerPoint 演示文稿格式
DOC	将文档保存为 Microsoft Word 格式
DOCX	将文档保存为 Microsoft Word 格式
JPEG	以 JPEG 格式保存文档
PNG	以 PNG 格式保存文档
BMP	将文档保存为 BMP 格式
TIFF	将文档保存为单页或多页 TIFF 图像
文本	将文档保存为文本格式
DICOM	将文档保存为 DICOM 文本格式

Rust-Cpp: Aspose.PDF for Rust 的关键特性

Mon, 20 Jul 2026 00:00:00 +0000

跨平台软件

支持各种平台和 Rust 版本。请参阅系统要求详情请参阅。

通用功能

支持从广泛的列表中加载和保存文件格式.

支持的 PDF 标准

Aspose.PDF for Rust 支持 PDF 版本 1.2、1.3、1.4、1.5、1.6 和 1.7。

依功能類型分類

核心操作

new PDF
open PDF
save PDF
save_as
page_insert
page_add
page_count
page_delete
extract_text
set_license

整理

optimize
optimize_resource
grayscale
rotate
set_background
repair
page_add_text
page_set_size
page_rotate
page_grayscale

轉換與儲存

PDF, DOC, DOCX, XLSX, PPTX, JPEG, PNG, BMP, TIFF, EPUB, DICOM, SVG, XPS, TEX, TXT

Rust-Cpp: Aspose PDF 许可证

Mon, 20 Jul 2026 00:00:00 +0000

许可证

该 Rust 源代码 在 MIT 许可证下授权。
该 共享库 (AsposePDFforRust_windows_amd64.dll, libAsposePDFforRust_linux_amd64.so, libAsposePDFforRust_darwin_amd64.dylib, libAsposePDFforRust_darwin_arm64.dylib) 为专有软件，需要商业许可证。要使用全部功能，您必须获取许可证。

评估版

您可以免费使用 Aspose.PDF for Rust via C++ 进行评估。评估版提供了几乎全部产品功能，但有一定限制。当您购买许可证并添加少量代码以应用许可证后，同一评估版即转为正式授权版。

如果您想在没有评估版限制的情况下测试 Aspose.PDF for Rust，您也可以申请 30 天的临时许可证。请参阅如何获取临时许可证？?

评估版的限制

我们希望客户在购买之前彻底测试我们的组件，因此评估版允许您像平常一样使用它。

带有评估水印的文档。Aspose.PDF for Rust 的评估版提供完整的产品功能，但生成文件的所有页面顶部都会加上文字“Evaluation Only. Created with Aspose.PDF. Copyright 2002-2025 Aspose Pty Ltd.”的水印。
可处理页面数量的限制。在评估版中，您只能处理文档的前四页。

在生产环境中使用

在生产环境中需要商业许可证密钥。请联系我们购买商业许可证。

应用许可证

通过使用许可证文件 (Aspose.PDF.RustViaCPP.lic) 为 Aspose.PDF for Rust 应用许可证，以启用其完整功能。


    use asposepdf::Document;

    fn main() -> Result<(), Box<dyn std::error::Error>> {
        // Open a PDF-document with filename
        let pdf = Document::open("sample.pdf")?;

        // Set license with filename
        pdf.set_license("Aspose.PDF.RustViaCPP.lic")?;

        // Now you can work with the licensed PDF document
        // ...

        Ok(())
    }

Rust-Cpp: Aspose.PDF for Rust 支持

Mon, 20 Jul 2026 00:00:00 +0000

Aspose 为其所有产品提供无限制的免费技术支持。所有用户（包括试用用户）均可获得支持。主要的支持渠道是 Aspose.Forums。

请注意，Aspose 不提供电话技术支持。电话支持仅限于销售和购买问题。

Aspose 免费支持论坛

Aspose.PDF 允许您免费获得其所有产品的技术支持。如果您对 Aspose.PDF 有疑问，请查看下一篇文章：

最受欢迎的支持渠道是 Aspose.Forums. 在 Aspose.PDF 论坛部分，您可以提出您的问题并尽快得到答案。
您应该知道，Aspose 并不提供电话技术支持。电话仅用于销售和购买问题。
请记住，我们有时区差异，这可能会影响我们对您的响应速度。

报告问题或功能请求

如果您需要关于 Aspose.PDF 的问题帮助，请遵循以下建议，以确保以最高效的方式解决问题：

首先，在报告问题之前，请检查您使用的是最新的 Aspose.PDF 版本，参见下载 Aspose.PDF for Rust 以了解最新版本。
也许您的问题的解决方案已经在论坛或文档中讨论过并有了解决方案，为此，请查看论坛和文档，检查 API 参考在报告问题之前。
在提出问题时，请包括原始文档以及可能导致问题的代码片段。如果有多个文件，您可以将这些文件压缩成一个文档。
别担心，只有您和 Aspose 的开发者可以访问这些粘性文件。

Rust-Cpp: 运行时配置 Aspose.PDF for Rust via C++

Mon, 20 Jul 2026 00:00:00 +0000

在 Rust 中使用本机动态库时，这是一个标准要求。

在 Linux 和 macOS 上，系统动态加载器不会自动搜索可执行文件目录，除非已配置 RPATH。为了确保您的应用程序在运行时能够找到 Aspose.PDF 本机库，您需要配置 RPATH（运行时搜索路径）。

我们的构建脚本会提取该库，并尝试在您的输出目录中为其创建符号链接（例如， target/debug/). 为了使可执行文件能够找到它，请选择以下选项之一：

选项 1：项目级别配置（推荐）

在您的项目根目录创建名为 .cargo 的目录（如果不存在），并在其中创建 config.toml：

[target.'cfg(target_os = "linux")']
rustflags = ["-C", "link-arg=-Wl,-rpath,$ORIGIN"]

[target.'cfg(target_os = "macos")']
rustflags = ["-C", "link-arg=-Wl,-rpath,@loader_path"]

选项 2：RUSTFLAGS 环境变量

使用以下标志构建你的项目：

# Linux
RUSTFLAGS="-C link-arg=-Wl,-rpath,\$ORIGIN" cargo build

# macOS
RUSTFLAGS="-C link-arg=-Wl,-rpath,@loader_path" cargo build

选项 3：系统范围安装（不推荐用于开发）

如果您更倾向于全局安装该库：

Linux: 复制 .so 文件到 /usr/local/lib 并运行 sudo ldconfig.
macOS: 复制 .dylib 文件到 /usr/local/lib.

Windows 通常不需要任何操作，因为库位于相同的文件夹中 .exe. 或者，您可以添加包含该目录的 .dll 到您的系统 PATH 环境变量。