Documentation – Comenzar

Rust-Cpp: Cómo instalar Aspose.PDF para Rust mediante C++

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

Instalación

Instalación desde el sitio web de Aspose

Este paquete incluye un archivo grande que se almacena como un archivo bzip2.

Descargar el archivo Aspose.PDF for Rust via C++ del sitio web oficial de Aspose. La versión más reciente (más actual) está listada en la parte superior y se descarga por defecto cuando haces clic en el botón Download. Se recomienda usar esta última versión. Sólo descargue una versión anterior si es necesario. Ejemplo: Aspose.PDF-for-Rust-via-CPP-25.6.zip

El formato del nombre de archivo del archivo es: Aspose.PDF-for-Rust-via-CPP-YY.M.zip, donde:
- YY = últimos dos dígitos del año (p.ej., 25 para 2025)
- M = número de mes de 1 a 12
Extraer el archivo a tu directorio elegido {path} usando una herramienta adecuada:
- En Linux/macOS:
```
unzip Aspose.PDF-for-Rust-via-CPP-YY.M.zip -d {path}
```
- En Windows, use la extracción incorporada del Explorador o cualquier herramienta de descompresión (7-Zip, WinRAR).
Agregar la biblioteca como dependencia en tu proyecto Rust. Puedes hacerlo de dos maneras:
- Usando la línea de comandos:
```
cargo add asposepdf --path {path}/asposepdf
```
- Edición manual Cargo.toml: Abre el proyecto de Cargo.toml y añada lo siguiente bajo [dependencies]:
```
[dependencies]
asposepdf = { path = "{path}/asposepdf" }
```
Compila tu proyecto (cargo build). En la primera compilación, la biblioteca dinámica apropiada para su plataforma será extraída automáticamente de la .bz2 archivar en el lib carpeta y vinculada a tu proyecto.

Notas

El script de compilación intenta crear un enlace simbólico a la biblioteca en su directorio de salida (p. ej., target/debug/).
Para Linux y macOS, también debe seguir el Configuración de tiempo de ejecución sección a continuación para garantizar que el ejecutable pueda encontrar la biblioteca en tiempo de ejecución.
Todo .bz2 los archivos tienen correspondiente .sha256 archivos de suma de verificación. Si falta una suma de verificación o es inválida, la compilación fallará.

Instalación desde GitHub

Este paquete incluye bibliotecas nativas precompiladas (".dll, .so, .dylib) que se almacenan como comprimidos .bz2 archivos dentro del repositorio de GitHub.

Agregar la biblioteca como dependencia en tu proyecto Rust. Puedes hacerlo de dos maneras:
- Usando la línea de comandos:
```
cargo add asposepdf --git https://github.com/aspose-pdf/aspose-pdf-rust-cpp.git
```
- Edición manual Cargo.toml:
  
  Abre el proyecto de Cargo.toml y añada lo siguiente bajo [dependencies]:
```
[dependencies]
asposepdf = { git = "https://github.com/aspose-pdf/aspose-pdf-rust-cpp.git" }
```
Nota: Para usar una versión de lanzamiento específica, puedes especificar una etiqueta:
```
asposepdf = { git = "https://github.com/aspose-pdf/aspose-pdf-rust-cpp.git", tag = "v1.26.1" }
```
Compila tu proyecto (cargo build). En la primera compilación, la biblioteca dinámica apropiada para su plataforma será extraída automáticamente de la .bz2 archivar en el lib carpeta y vinculada a tu proyecto.

Notas

No necesitas descargar ni extraer manualmente ningún archivo - todo está incluido en el repositorio de GitHub.
El script de compilación intenta crear un enlace simbólico a la biblioteca en su directorio de salida (p. ej., target/debug/).
Para Linux y macOS, también debe seguir el Configuración de tiempo de ejecución sección a continuación para garantizar que el ejecutable pueda encontrar la biblioteca en tiempo de ejecución.
Todo .bz2 los archivos tienen coincidencia .sha256 archivos de suma de verificación. La suma de verificación se verifica antes de desempaquetar.
Si la verificación de la suma de verificación falla o el archivo está ausente, la compilación fallará con un error detallado.

Instalación desde crates.io

Este paquete está disponible en crates.io. Debido a limitaciones de tamaño, el crate publicado no incluye las bibliotecas binarias nativas (.dll, .so, o .dylib). Puedes obtener las bibliotecas nativas requeridas ya sea del archivo de distribución oficial (ver Instalación desde el sitio web de Aspose) o desde el repositorio de GitHub (ver Instalación desde GitHub). El script de compilación localizará, verificará y extraerá la biblioteca nativa apropiada de un archivo comprimido .bz2 durante el proceso de compilación.

Agregar la biblioteca como dependencia en tu proyecto Rust. Puedes hacerlo de dos maneras:
- Usando la línea de comandos:
```
cargo add asposepdf
```
- Edición manual Cargo.toml:
  
  Abre el proyecto de Cargo.toml y añada lo siguiente bajo [dependencies]:
```
[dependencies]
asposepdf = "1.26.1"
```
Establecer la ruta al directorio que contiene las bibliotecas nativas y descargar los archivos requeridos:
- Establecer la variable de entorno ASPOSE_PDF_LIB_DIR para apuntar a la carpeta donde colocarás el nativo .bz2 archivos, su .sha256 archivos de suma de verificación, y las bibliotecas nativas extraídas (.dll, .so, .dylib, y también para Windows .lib):
  - En Linux/macOS:
```
export ASPOSE_PDF_LIB_DIR=/path/to/lib
```
  - En Windows (Símbolo del sistema):
```
set ASPOSE_PDF_LIB_DIR=C:\path\to\lib
```
  - En Windows (PowerShell):
```
$env:ASPOSE_PDF_LIB_DIR = "C:\path\to\lib"
```

Nota sobre ASPOSE_PDF_LIB_DIR

El ASPOSE_PDF_LIB_DIR la variable de entorno define el directorio de trabajo para el script de compilación. Se usa solo durante la compilación para localizar, verificar y extraer los archivos de biblioteca nativos. Configurar esta variable no agrega automáticamente el directorio a la ruta de búsqueda de bibliotecas en tiempo de ejecución de su sistema (ver Configuración de tiempo de ejecución).

Descargar lo necesario .bz2 archivos** y archivos de suma de verificación del repositorio de GitHub lib/ carpeta y colócalos en la carpeta establecida en ASPOSE_PDF_LIB_DIR:
Para Linux x64, descargar:
- libAsposePDFforRust_linux_amd64.so.bz2
- libAsposePDFforRust_linux_amd64.so.bz2.sha256
Para macOS x86_64, descarga:
- libAsposePDFforRust_darwin_amd64.dylib.bz2
- libAsposePDFforRust_darwin_amd64.dylib.bz2.sha256
Para macOS arm64, descarga:
- libAsposePDFforRust_darwin_arm64.dylib.bz2
- libAsposePDFforRust_darwin_arm64.dylib.bz2.sha256
Para Windows x64, descargar:
- AsposePDFforRust_windows_amd64.dll.bz2
- AsposePDFforRust_windows_amd64.dll.bz2.sha256
- AsposePDFforRust_windows_amd64.lib (biblioteca de importación nativa, sin comprimir)

Nota: Necesitas descargar manualmente estos archivos desde GitHub y colocarlos en el directorio indicado por ASPOSE_PDF_LIB_DIR.
El script de compilación desempaquetará automáticamente las bibliotecas nativas del .bz2 archivos en la primera compilación.

Compilar tu proyecto (cargo build). En la primera compilación, la biblioteca nativa que coincida con su plataforma se extraerá automáticamente de la .bz2 archivar y vincular a su proyecto.

Importante: Para Linux y macOS, también debe seguir la Configuración de tiempo de ejecución sección a continuación para garantizar que el ejecutable pueda encontrar la biblioteca en tiempo de ejecución.

Notas

El ASPOSE_PDF_LIB_DIR la variable se usa solo durante el proceso de compilación para localizar y extraer los archivos.
El script de compilación intenta crear un enlace simbólico a la biblioteca extraída en su directorio de salida (por ejemplo, target/debug/).
Debe proporcionar la carpeta que contiene el .bz2 y .sha256 archivos por separado, ya que estos archivos binarios no se distribuyen a través de crates.io.
Si el archivo requerido falta o la suma de verificación falla, la compilación fallará con un error detallado.
Los mismos archivos binarios utilizados para la instalación a través de GitHub o del sitio web de Aspose pueden reutilizarse aquí.

Inicio rápido

Todos los fragmentos de código están contenidos en el fragmento.

Rust-Cpp: Requisitos del sistema

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

Plataformas compatibles de Aspose.PDF for Rust vía C++

El paquete asposepdf es un kit de herramientas potente que permite a los desarrolladores manipular archivos PDF directamente y ayuda a realizar diversas tareas con PDF. Contiene características únicas para convertir PDF a otros formatos.

Se implementó soporte para las plataformas Linux x64, macOS x86_64, macOS arm64 y Windows x64.

Se requiere la versión específica de la plataforma de la biblioteca dinámica de la carpeta ‘lib’ en el directorio raíz del paquete para distribuir la aplicación resultante:

libAsposePDFforRust_linux_amd64.so para la plataforma Linux x64
libAsposePDFforRust_darwin_arm64.dylib para la plataforma macOS arm64
libAsposePDFforRust_darwin_amd64.dylib para la plataforma macOS x86_64
AsposePDFforRust_windows_amd64.dll para la plataforma Windows x64.

Rust-Cpp: Ejemplo de Hello World usando el lenguaje Rust

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

Un ejemplo “Hello World” se usa tradicionalmente para introducir características de un lenguaje de programación o software con un caso de uso sencillo.

Aspose.PDF for Rust es una API de PDF con muchas funciones que permite a los desarrolladores incrustar la creación, manipulación y conversión de documentos PDF con Rust. Soporta muchos formatos de archivo populares, incluyendo PDF, TXT, XLSX, EPUB, TEX, DOC, DOCX, PPTX, formatos de imagen, etc. En este artículo, estamos creando un documento PDF que contiene el texto “Hello World!”. Después de instalar Aspose.PDF for Rust en su entorno, puede ejecutar el ejemplo de código para ver cómo funciona la API de Aspose.PDF. El fragmento de código a continuación sigue estos pasos:

Cree una nueva instancia de documento PDF.
Agregue una nueva página al documento PDF usando page_add función.
Establecer el tamaño de la página usando page_set_size.
Agregar el texto “Hello World!” a la primera página usando page_add_text.
Guardar el documento PDF usando save_as método.

El siguiente fragmento de código es un programa Hello World para exhibir el funcionamiento de 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: Formatos de archivo compatibles

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

La siguiente tabla indica los formatos de archivo que Aspose.PDF for Rust puede cargar y guardar.

Formato	Descripción	Cargar	Guardar	Observaciones
PDF	Formato de Documento Portátil
EPUB	Formato de archivo de libro electrónico
TeX	Formato de archivo de composición tipográfica LaTex
SVG	Gráficos vectoriales escalables (un formato de imagen vectorial basado en XML)
XPS	Documentos XPS
XLSX	Guarda el documento en el formato Microsoft Excel 2007
PPTX	Guarda el documento en el formato de presentaciones de Microsoft PowerPoint
DOC	Guarda el documento en el formato de Microsoft Word
DOCX	Guarda el documento en el formato de Microsoft Word
JPEG	Guarda el documento en formato JPEG
PNG	Guarda el documento en formato PNG
BMP	Guarda el documento en formato BMP
TIFF	Guarda el documento como imagen TIFF de una sola página o de varias páginas
Texto	Guardar el documento en formato Texto
DICOM	Guardar el documento en formato de Texto DICOM

Rust-Cpp: Características clave de Aspose.PDF para Rust

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

Software multiplataforma

Admite varias plataformas y versiones de Rust. Ver Requisitos del sistema para obtener más detalles.

Características generales

Admite la carga y el guardado de una amplia lista de formatos de archivo.

Estándares PDF compatibles

Aspose.PDF for Rust admite versiones PDF 1.2, 1.3, 1.4, 1.5, 1.6 y 1.7.

Funcionalidades por tipo de función

Operaciones principales

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

Organizar

optimize
optimize_resource
grayscale
rotate
set_background
repair
page_add_text
page_set_size
page_rotate
page_grayscale

Convertir y guardar

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

Rust-Cpp: Licencia Aspose PDF

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

Licencia

El código fuente de Rust está licenciado bajo la Licencia MIT.
La biblioteca compartida (AsposePDFforRust_windows_amd64.dll, libAsposePDFforRust_linux_amd64.so, libAsposePDFforRust_darwin_amd64.dylib, libAsposePDFforRust_darwin_arm64.dylib) es propietaria y requiere una licencia comercial. Para usar la funcionalidad completa, debe obtener una licencia.

Versión de evaluación

Puede usar Aspose.PDF for Rust via C++ sin costo para la evaluación.La versión de evaluación proporciona casi toda la funcionalidad del producto con ciertas limitaciones. La misma versión de evaluación se convierte en una licencia cuando compra una licencia y agrega un par de líneas de código para aplicar la licencia.

Si desea probar Aspose.PDF for Rust sin las limitaciones de la versión de evaluación, también puede solicitar una Licencia Temporal de 30 días. Por favor, consulte ¿Cómo obtener una Licencia Temporal??

Limitación de una versión de evaluación

Queremos que nuestros clientes prueben nuestros componentes a fondo antes de comprar, por lo que la versión de evaluación le permite usarla como lo haría normalmente.

Documentos creados con una marca de agua de evaluación. La versión de evaluación de Aspose.PDF for Rust ofrece toda la funcionalidad del producto, pero todas las páginas de los archivos generados llevan una marca de agua con el texto “Evaluation Only. Created with Aspose.PDF. Copyright 2002-2025 Aspose Pty Ltd.” en la parte superior.
Limitar la cantidad de páginas que pueden procesarse. En la versión de evaluación, solo puede procesar las primeras cuatro páginas de un documento.

Uso en producción

Se requiere una clave de licencia comercial en un entorno de producción. Por favor, contáctenos para adquirir una licencia comercial.

Aplicar licencia

Aplicar una licencia para habilitar la funcionalidad completa de Aspose.PDF para Rust usando un archivo de licencia (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: Configuración de tiempo de ejecución Aspose.PDF para Rust vía C++

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

Este es un requisito estándar al usar bibliotecas dinámicas nativas en Rust.

En Linux y macOS, el cargador dinámico del sistema no busca automáticamente el directorio del ejecutable a menos que RPATH esté configurado. Para garantizar que su aplicación pueda encontrar la biblioteca nativa de Aspose.PDF en tiempo de ejecución, debe configurar el RPATH (Ruta de búsqueda en tiempo de ejecución).

Nuestro script de compilación extrae la biblioteca y trata de crear un enlace simbólico a ella en su directorio de salida (p. ej., target/debug/). Para que el ejecutable lo encuentre, elija una de las siguientes opciones:

Opción 1: Configuración a nivel de proyecto (Recomendado)

Crear una carpeta llamada .cargo en el directorio raíz de tu proyecto (si no existe) y crea un archivo llamado config.toml dentro de él:

[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"]

Opción 2: Variable de entorno RUSTFLAGS

Construye tu proyecto con la siguiente bandera:

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

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

Opción 3: Instalación a nivel del sistema (No recomendada para desarrollo)

Si prefieres instalar la biblioteca globalmente:

Linux: Copiar el .so archivo a /usr/local/lib y ejecutar sudo ldconfig.
macOS: Copiar el .dylib archivo a /usr/local/lib.

Windows Normalmente no se requiere ninguna acción porque la biblioteca está ubicada en la misma carpeta que el .exe. Alternativamente, puede agregar el directorio que contiene el .dll a su sistema PATH variable de entorno.

Rust-Cpp: Soporte de Aspose.PDF para Rust

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

Aspose brinda soporte técnico gratuito ilimitado para todos sus productos. El soporte está disponible para todos los usuarios, incluida la evaluación. La principal vía de soporte es Aspose.Forums

Tenga en cuenta que Aspose no brinda soporte técnico por teléfono. El soporte telefónico solo está disponible para preguntas de ventas y compras.

Foro de Soporte Gratuito de Aspose

Aspose.PDF le permite usar soporte técnico gratuito para todos sus productos. Si tiene preguntas sobre Aspose.PDF, consulte el siguiente artículo:

La fuente de soporte más popular es Aspose.Forums. En el Aspose.PDF foro sección, puedes hacer tu pregunta y obtener una respuesta lo antes posible.
Debes saber que Aspose no brinda soporte técnico por teléfono. La llamada solo está disponible para preguntas de ventas y compras.
Por favor, recuerda que tenemos diferencias de zona horaria, lo que puede afectar la rapidez de nuestras respuestas.

Informar de un problema o solicitud de característica

Si necesitas ayuda con un problema con Aspose.PDF, sigue las siguientes recomendaciones para asegurarte de que se resuelva de la manera más eficiente:

Primero, verifica que estés usando la última versión de Aspose.PDF antes de informar el problema, consulta Descargar Aspose.PDF for Rust para averiguar la última versión.
Tal vez la solución a tu problema ya se ha discutido y tiene una solución, para ello, estudia el foro y la documentación, verifica Referencia de API antes de reportar el problema.
Cuando formule su pregunta, incluya el documento original y posiblemente un fragmento de su código que causa el problema. Puede comprimir estos archivos en un solo documento si hay varios.
No se preocupe, solo usted y los desarrolladores de Aspose tienen acceso a los archivos pegajosos.