Documentation – Начало работы

Rust-Cpp: Как установить Aspose.PDF для Rust via C++

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 используйте встроенную функцию извлечения в Проводнике или любой инструмент для разархивирования (7-Zip, WinRAR).
Добавьте библиотеку как зависимость в ваш проект на Rust. Вы можете сделать это двумя способами:
- Использование командной строки:
```
cargo add asposepdf --path {path}/asposepdf
```
- Ручное редактирование Cargo.toml: Откройте свой проект Cargo.toml и добавьте следующее под [dependencies]:
```
[dependencies]
asposepdf = { path = "{path}/asposepdf" }
```
Соберите ваш проект (cargo build). При первой сборке соответствующая динамическая библиотека для вашей платформы будет автоматически извлечена из .bz2 архив в lib папка и привязана к вашему проекту.

Примечания

Скрипт сборки пытается создать символическую ссылку на библиотеку в вашем каталоге вывода (например, 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). При первой сборке соответствующая динамическая библиотека для вашей платформы будет автоматически извлечена из .bz2 архив в lib папка и привязана к вашему проекту.

Примечания

Вам не нужно вручную загружать или извлекать какие-либо файлы - всё включено в репозиторий 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 указывает на папку, где вы разместите native .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 архивы** и файлы контрольных сумм из репозитория 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’ в корневом каталоге пакета, для распространения полученного приложения:

libAsposePDFforRust_linux_amd64.so для платформы Linux x64
libAsposePDFforRust_darwin_arm64.dylib для платформы macOS arm64
libAsposePDFforRust_darwin_amd64.dylib для платформы macOS x86_64
AsposePDFforRust_windows_amd64.dll для платформы Windows x64.

Rust-Cpp: Пример Hello World с использованием языка Rust

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

Пример «Hello World» традиционно используется для представления возможностей языка программирования или программного обеспечения на простом примере.

Aspose.PDF for Rust — это полнофункциональный API для PDF, позволяющий разработчикам внедрять возможности создания, манипулирования и конвертации PDF‑документов с помощью Rust. Он поддерживает многие популярные форматы файлов, включая PDF, TXT, XLSX, EPUB, TEX, DOC, DOCX, PPTX, форматы изображений и т.д. В этой статье мы создаём PDF‑документ, содержащий текст “Hello World!”. После установки Aspose.PDF for Rust в вашей среде вы можете выполнить пример кода, чтобы увидеть, как работает API Aspose.PDF. Следующий фрагмент кода выполняет такие шаги:

Создайте новый экземпляр PDF‑документа.
Добавьте новую страницу в PDF‑документ с помощью функции page_add.
Установите размер страницы с помощью page_set_size.
Добавьте текст “Hello World!” на первую страницу с помощью page_add_text.
Сохраните PDF‑документ с помощью метода save_as.

Следующий фрагмент кода — это программа Hello World, демонстрирующая работу API Aspose.PDF for Rust.


    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	Scalable Vector Graphics (векторный графический формат на основе 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 для 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 для Rust с использованием файла лицензии (Aspose.PDF.RustViaCPP.lic).


    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 для Rust via C++

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

Это стандартное требование при использовании нативных динамических библиотек в Rust.

В Linux и macOS системный динамический загрузчик не ищет автоматически каталог исполняемого файла, если не настроен RPATH. Чтобы ваше приложение могло найти нативную библиотеку Aspose.PDF во время выполнения, необходимо настроить RPATH (Run-time Search Path).

Наш скрипт сборки извлекает библиотеку и пытается создать символическую ссылку на неё в вашем выходном каталоге (например, 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 переменная среды.

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 для Rust чтобы узнать о последней версии.
Возможно, решение вашей проблемы уже обсуждалось и имеется; для этого изучите форум и документацию, проверьте Справочник API прежде чем сообщать о проблеме.
Когда формулируете свой вопрос, пожалуйста, включите оригинальный документ и, возможно, фрагмент вашего кода, вызывающего проблему. Вы можете упаковать эти файлы в один архив, если их несколько.
Не волнуйтесь, только вы и разработчики Aspose имеют доступ к липким файлам.