Documentation – Commencer

Rust-Cpp: Comment installer Aspose.PDF pour Rust via C++

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

Installation

Installation depuis le site Web d’Aspose

Ce paquet inclut un fichier volumineux qui est stocké sous forme d’archive bzip2.

Télécharger l’archive Aspose.PDF for Rust via C++ sur le site officiel d’Aspose. La version la plus récente (la plus à jour) est affichée en haut et est téléchargée par défaut lorsque vous cliquez sur le bouton Télécharger. Il est recommandé d’utiliser cette dernière version. Téléchargez une version précédente uniquement si nécessaire. Exemple : Aspose.PDF-for-Rust-via-CPP-25.6.zip

Le format du nom de fichier d’archive est : Aspose.PDF-for-Rust-via-CPP-YY.M.zip, où:
- YY = les deux derniers chiffres de l’année (p. ex., 25 pour 2025)
- M = numéro du mois à partir de 1 à 12
Extraire l’archive dans le répertoire de votre choix {path} en utilisant un outil approprié :
- Sur Linux/macOS :
```
unzip Aspose.PDF-for-Rust-via-CPP-YY.M.zip -d {path}
```
- Sur Windows, utilisez l’extraction intégrée de l’Explorateur ou tout outil de décompression (7‑Zip, WinRAR).
Ajouter la bibliothèque en tant que dépendance dans votre projet Rust. Vous pouvez le faire de deux manières :
- Utilisation de la ligne de commande :
```
cargo add asposepdf --path {path}/asposepdf
```
- Modification manuelle de Cargo.toml : Ouvrez le projet de votre Cargo.toml et ajoutez ce qui suit sous [dependencies]:
```
[dependencies]
asposepdf = { path = "{path}/asposepdf" }
```
Construisez votre projet (cargo build). Lors de la première construction, la bibliothèque dynamique appropriée pour votre plateforme sera automatiquement extraite du .bz2 archiver dans le lib dossier et lié à votre projet.

Notes

Le script de compilation tente de créer un lien symbolique vers la bibliothèque dans votre répertoire de sortie (par ex., target/debug/).
Pour Linux et macOS, vous devez également suivre le Configuration d’exécution section ci-dessous pour garantir que l’exécutable puisse trouver la bibliothèque au moment de l’exécution.
Tout .bz2 les archives ont correspondantes .sha256 fichiers de somme de contrôle. Si une somme de contrôle est manquante ou invalide, la construction échouera.

Installation depuis GitHub

Ce package comprend des bibliothèques natives précompilées (".dll, .so, .dylib) qui sont stockés sous forme compressée .bz2 archives dans le dépôt GitHub.

Ajouter la bibliothèque en tant que dépendance dans votre projet Rust. Vous pouvez le faire de deux manières :
- Utilisation de la ligne de commande :
```
cargo add asposepdf --git https://github.com/aspose-pdf/aspose-pdf-rust-cpp.git
```
- Modification manuelle de Cargo.toml :
  
  Ouvrez le projet de votre Cargo.toml et ajoutez ce qui suit sous [dependencies]:
```
[dependencies]
asposepdf = { git = "https://github.com/aspose-pdf/aspose-pdf-rust-cpp.git" }
```
Note : Pour utiliser une version de publication spécifique, vous pouvez spécifier une balise :
```
asposepdf = { git = "https://github.com/aspose-pdf/aspose-pdf-rust-cpp.git", tag = "v1.26.1" }
```
Construisez votre projet (cargo build). Lors de la première construction, la bibliothèque dynamique appropriée pour votre plateforme sera automatiquement extraite du .bz2 archiver dans le lib dossier et lié à votre projet.

Notes

Vous n’avez pas besoin de télécharger ou d’extraire manuellement des fichiers - tout est inclus dans le dépôt GitHub.
Le script de compilation tente de créer un lien symbolique vers la bibliothèque dans votre répertoire de sortie (par ex., target/debug/).
Pour Linux et macOS, vous devez également suivre le Configuration d’exécution section ci-dessous pour garantir que l’exécutable puisse trouver la bibliothèque au moment de l’exécution.
Tout .bz2 les archives correspondent .sha256 fichiers de somme de contrôle. La somme de contrôle est vérifiée avant le déballage.
Si la vérification du checksum échoue ou si l’archive est manquante, la construction échouera avec une erreur détaillée.

Installation depuis crates.io

Ce paquet est disponible sur crates.io. En raison des limites de taille, le crate publié n’inclut pas les bibliothèques binaires natives (.dll, .so, ou .dylib). Vous pouvez obtenir les bibliothèques natives requises soit à partir de l’archive de distribution officielle (voir Installation depuis le site Web d’Aspose) ou depuis le dépôt GitHub (voir Installation depuis GitHub). Le script de construction localisera, vérifiera et extraira la bibliothèque native appropriée d’une archive compressée au format .bz2 pendant le processus de construction.

Ajouter la bibliothèque en tant que dépendance dans votre projet Rust. Vous pouvez le faire de deux manières :
- Utilisation de la ligne de commande :
```
cargo add asposepdf
```
- Modification manuelle Cargo.toml:**
  
  Ouvrez le projet de votre Cargo.toml et ajoutez ce qui suit sous [dependencies]:
```
[dependencies]
asposepdf = "1.26.1"
```
Définir le chemin vers le répertoire contenant les bibliothèques natives et télécharger les fichiers requis :
- Définir la variable d’environnement ASPOSE_PDF_LIB_DIR** pour pointer vers le dossier où vous placerez le natif .bz2 archives, leurs .sha256 fichiers de somme de contrôle, et les bibliothèques natives extraites (.dll, .so, .dylib, et pour Windows aussi .lib):
  - Sur Linux/macOS :
```
export ASPOSE_PDF_LIB_DIR=/path/to/lib
```
  - Sous Windows (Invite de commandes):
```
set ASPOSE_PDF_LIB_DIR=C:\path\to\lib
```
  - Sur Windows (PowerShell) :
```
$env:ASPOSE_PDF_LIB_DIR = "C:\path\to\lib"
```

Note sur ASPOSE_PDF_LIB_DIR

Le ASPOSE_PDF_LIB_DIR la variable d’environnement définit le répertoire de travail pour le script de construction. Elle est utilisée uniquement pendant la compilation pour localiser, vérifier et extraire les archives de bibliothèques natives. La définition de cette variable n’ajoute pas automatiquement le répertoire au chemin de recherche des bibliothèques d’exécution de votre système (voir Configuration d’exécution).

Téléchargez le requis .bz2 archives** et fichiers de somme de contrôle du référentiel GitHub lib/ dossier et placez-les dans le dossier défini dans ASPOSE_PDF_LIB_DIR:
Pour Linux x64, téléchargez :
- libAsposePDFforRust_linux_amd64.so.bz2
- libAsposePDFforRust_linux_amd64.so.bz2.sha256
Pour macOS x86_64, télécharger :
- libAsposePDFforRust_darwin_amd64.dylib.bz2
- libAsposePDFforRust_darwin_amd64.dylib.bz2.sha256
Pour macOS arm64, télécharger :
- libAsposePDFforRust_darwin_arm64.dylib.bz2
- libAsposePDFforRust_darwin_arm64.dylib.bz2.sha256
Pour Windows x64, téléchargez :
- AsposePDFforRust_windows_amd64.dll.bz2
- AsposePDFforRust_windows_amd64.dll.bz2.sha256
- AsposePDFforRust_windows_amd64.lib (bibliothèque d’importation native, non compressée)

Note: Vous devez télécharger manuellement ces fichiers depuis GitHub et les placer dans le répertoire indiqué par ASPOSE_PDF_LIB_DIR.
Le script de construction décompressera automatiquement les bibliothèques natives depuis le .bz2 archives lors du premier build.

Construire votre projet (cargo build). Lors de la première compilation, la bibliothèque native correspondant à votre plateforme sera automatiquement extraite de la .bz2 archiver et lier à votre projet.

Important : Pour Linux et macOS, vous devez également suivre le Configuration d’exécution section ci-dessous pour garantir que l’exécutable puisse trouver la bibliothèque au moment de l’exécution.

Notes

Le ASPOSE_PDF_LIB_DIR la variable est utilisée uniquement pendant le processus de construction pour localiser et extraire les archives.
Le script de construction tente de créer un lien symbolique vers la bibliothèque extraite dans votre répertoire de sortie (par exemple, target/debug/).
Vous devez fournir le dossier contenant le .bz2 et .sha256 fichiers séparément, car ces archives binaires ne sont pas distribuées via crates.io.
Si l’archive requise est manquante ou que la somme de contrôle échoue, le processus de construction échouera avec une erreur détaillée.
Les mêmes fichiers binaires utilisés pour l’installation via GitHub ou le site Web d’Aspose peuvent être réutilisés ici.

Démarrage rapide

Tous les extraits de code sont contenus dans le extrait.

Rust-Cpp: Exigences système

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

Plateformes prises en charge par Aspose.PDF for Rust via C++

Le package asposepdf est un ensemble d’outils puissant qui permet aux développeurs de manipuler directement les fichiers PDF et aide à réaliser diverses tâches liées aux PDF. Contient des fonctionnalités uniques pour convertir le PDF en d’autres formats.

Prise en charge implémentée pour les plateformes Linux x64, macOS x86_64, macOS arm64 et Windows x64.

La version spécifique à la plateforme de la bibliothèque dynamique du dossier ’lib’ dans le répertoire racine du paquet est requise pour distribuer l’application résultante :

libAsposePDFforRust_linux_amd64.so pour la plateforme Linux x64
libAsposePDFforRust_darwin_arm64.dylib pour la plateforme macOS arm64
libAsposePDFforRust_darwin_amd64.dylib pour la plateforme macOS x86_64
AsposePDFforRust_windows_amd64.dll pour la plateforme Windows x64.

Rust-Cpp: Exemple de Hello World utilisant le langage Rust

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

Un exemple “Hello World” est traditionnellement utilisé pour introduire les fonctionnalités d’un langage de programmation ou d’un logiciel avec un cas d’utilisation simple.

Aspose.PDF for Rust est une API PDF riche en fonctionnalités qui permet aux développeurs d’intégrer la création, la manipulation et les capacités de conversion de documents PDF avec Rust. Elle prend en charge de nombreux formats de fichiers populaires, notamment PDF, TXT, XLSX, EPUB, TEX, DOC, DOCX, PPTX, les formats d’image, etc. Dans cet article, nous créons un document PDF contenant le texte “Hello World!” Après avoir installé Aspose.PDF for Rust dans votre environnement, vous pouvez exécuter l’exemple de code pour voir comment fonctionne l’API Aspose.PDF. Le fragment de code ci‑dessous suit ces étapes :

Créer une nouvelle instance de document PDF.
Ajouter une nouvelle page au document PDF en utilisant page_add fonction.
Définir la taille de la page en utilisant page_set_size.
Ajouter le texte “Hello World!” à la première page en utilisant page_add_text.
Enregistrer le document PDF en utilisant save_as méthode.

Le fragment de code suivant est un programme Hello World pour illustrer le fonctionnement de l’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: Formats de fichiers pris en charge

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

Le tableau suivant indique les formats de fichiers que Aspose.PDF for Rust peut charger et enregistrer.

Format	Description	Charger	Enregistrer	Remarques
PDF	Format de document portable
EPUB	format de fichier e-book
TeX	format de fichier LaTex
SVG	Scalable Vector Graphics (un format d’image vectorielle basé sur XML)
XPS	Documents XPS
XLSX	Enregistre le document au format Microsoft Excel 2007
PPTX	Enregistre le document au format Microsoft PowerPoint Presentations
DOC	Enregistre le document au format Microsoft Word
DOCX	Enregistre le document au format Microsoft Word
JPEG	Enregistre le document au format JPEG
PNG	Enregistre le document au format PNG
BMP	Enregistre le document au format BMP
TIFF	Enregistre le document en tant qu’image TIFF simple ou multi‑pages
Texte	Enregistrez le document au format texte
DICOM	Enregistrez le document au format texte DICOM

Rust-Cpp: Principales fonctionnalités d'Aspose.PDF pour Rust

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

Logiciel multiplateforme

Prend en charge diverses plates‑formes et versions de Rust. Voir Exigences système pour plus de détails.

Fonctionnalités générales

Prend en charge le chargement depuis et l’enregistrement vers une large liste de formats de fichier.

Normes PDF prises en charge

Aspose.PDF for Rust prend en charge les versions PDF 1.2, 1.3, 1.4, 1.5, 1.6 et 1.7.

Fonctionnalités par type de fonction

Opérations principales

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

Organisation

optimize
optimize_resource
grayscale
rotate
set_background
repair
page_add_text
page_set_size
page_rotate
page_grayscale

Conversion et enregistrement

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

Rust-Cpp: Licence Aspose PDF

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

Licence

Le code source Rust est licencié sous la licence MIT.
La bibliothèque partagée (AsposePDFforRust_windows_amd64.dll, libAsposePDFforRust_linux_amd64.so, libAsposePDFforRust_darwin_amd64.dylib, libAsposePDFforRust_darwin_arm64.dylib) est propriétaire et nécessite une licence commerciale. Pour utiliser toutes les fonctionnalités, vous devez obtenir une licence.

Version d’évaluation

Vous pouvez utiliser Aspose.PDF for Rust via C++ gratuitement pour l’évaluation. La version d’évaluation offre presque toutes les fonctionnalités du produit avec certaines limitations. La même version d’évaluation devient sous licence lorsque vous achetez une licence et ajoutez quelques lignes de code pour appliquer la licence.

Si vous souhaitez tester Aspose.PDF for Rust sans les limitations de la version d’évaluation, vous pouvez également demander une licence temporaire de 30 jours. Veuillez vous référer à Comment obtenir une licence temporaire ??

Limitation d’une version d’évaluation

Nous voulons que nos clients testent nos composants en profondeur avant d’acheter, ainsi la version d’évaluation vous permet de l’utiliser comme vous le feriez normalement.

Documents créés avec un filigrane d’évaluation. La version d’évaluation d’Aspose.PDF for Rust offre toutes les fonctionnalités du produit, mais toutes les pages des fichiers générés sont filigranées avec le texte “Evaluation Only. Created with Aspose.PDF. Copyright 2002-2025 Aspose Pty Ltd.” en haut.
Limiter le nombre de pages pouvant être traitées. Dans la version d’évaluation, vous ne pouvez traiter que les quatre premières pages d’un document.

Utilisation en production

Une clé de licence commerciale est requise dans un environnement de production. Veuillez nous contacter pour acheter une licence commerciale.

Appliquer la licence

Application d’une licence pour activer toutes les fonctionnalités d’Aspose.PDF pour Rust à l’aide d’un fichier de licence (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: Configuration d'exécution Aspose.PDF pour Rust via C++

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

Il s’agit d’une exigence standard lors de l’utilisation de bibliothèques dynamiques natives en Rust.

Sous Linux et macOS, le chargeur dynamique du système ne recherche pas automatiquement le répertoire de l’exécutable à moins que RPATH ne soit configuré. Pour garantir que votre application puisse trouver la bibliothèque native Aspose.PDF à l’exécution, vous devez configurer le RPATH (Run-time Search Path).

Notre script de génération extrait la bibliothèque et tente de créer un lien symbolique vers celle-ci dans votre répertoire de sortie (par exemple, target/debug/). Pour permettre à l’exécutable de le trouver, choisissez l’une des options suivantes :

Option 1 : Configuration au niveau du projet (recommandée)

Créer un dossier nommé .cargo dans le répertoire racine de votre projet (s’il n’existe pas) et créez un fichier nommé config.toml à l’intérieur :

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

Option 2 : variable d’environnement RUSTFLAGS

Construisez votre projet avec le drapeau suivant :

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

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

Option 3 : Installation système (non recommandée pour le développement)

Si vous préférez installer la bibliothèque globalement :

Linux: Copier le .so fichier à /usr/local/lib et exécuter sudo ldconfig.
macOS: Copier le .dylib fichier à /usr/local/lib.

Windows Aucune action n’est généralement requise parce que la bibliothèque se trouve dans le même dossier que le .exe. Alternativement, vous pouvez ajouter le répertoire contenant le .dll à votre système PATH variable d’environnement.

Rust-Cpp: Support Aspose.PDF pour Rust

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

Aspose fournit un support technique gratuit illimité pour tous ses produits. Le support est disponible pour tous les utilisateurs, y compris les évaluations. Le principal canal de support est Aspose.Forums.

Veuillez noter qu’Aspose ne fournit pas d’assistance technique par téléphone. L’assistance téléphonique n’est disponible que pour les questions de vente et d’achat.

Forum d’assistance gratuite Aspose

Aspose.PDF vous permet d’utiliser une assistance technique gratuite pour tous ses produits. Si vous avez des questions sur Aspose.PDF, consultez l’article suivant :

La source d’assistance la plus populaire est Aspose.Forums. Dans le Aspose.PDF forum section, vous pouvez poser votre question et obtenir une réponse dès que possible.
Vous devez savoir que Aspose ne fournit pas de support technique par téléphone. Vous ne pouvez appeler que pour des questions de vente et d’achat.
Veuillez vous rappeler que nous avons des différences de fuseau horaire, cela peut affecter la rapidité de nos réponses.

Signaler un problème ou une demande de fonctionnalité

Si vous avez besoin d’aide pour un problème avec Aspose.PDF, suivez les prochaines recommandations pour vous assurer qu’il soit résolu de la manière la plus efficace:

Tout d’abord, vérifiez que vous utilisez la dernière version d’Aspose.PDF avant de signaler le problème, voir Télécharger Aspose.PDF for Rust pour connaître la dernière version.
Il se peut que la solution à votre problème ait déjà été discutée et dispose d’une solution, pour cela, étudiez le forum et la documentation, vérifiez Référence de l’API avant de signaler le problème.
Lorsque vous formulez votre question, veuillez inclure le document original et éventuellement un fragment de votre code qui cause le problème. Vous pouvez zipper ces fichiers dans un seul document s’il y en a plusieurs.
Ne vous inquiétez pas, seuls vous et les développeurs d’Aspose avez accès aux fichiers temporaires.

Documentation – Commencer

Rust-Cpp: Comment installer Aspose.PDF pour Rust via C++

Installation

Installation depuis le site Web d’Aspose

Installation depuis GitHub

Installation depuis crates.io

Démarrage rapide

Rust-Cpp: Exigences système

Plateformes prises en charge par Aspose.PDF for Rust via C++

Rust-Cpp: Exemple de Hello World utilisant le langage Rust

Rust-Cpp: Formats de fichiers pris en charge

Rust-Cpp: Principales fonctionnalités d'Aspose.PDF pour Rust

Logiciel multiplateforme

Fonctionnalités générales

Normes PDF prises en charge

Fonctionnalités par type de fonction

Opérations principales

Organisation

Conversion et enregistrement

Rust-Cpp: Licence Aspose PDF

Licence

Version d’évaluation

Limitation d’une version d’évaluation

Utilisation en production

Appliquer la licence

Rust-Cpp: Configuration d'exécution Aspose.PDF pour Rust via C++

Option 1 : Configuration au niveau du projet (recommandée)

Option 2 : variable d’environnement RUSTFLAGS

Option 3 : Installation système (non recommandée pour le développement)

Rust-Cpp: Support Aspose.PDF pour Rust

Forum d’assistance gratuite Aspose

Signaler un problème ou une demande de fonctionnalité

Option 1 : Configuration au niveau du projet (recommandée)

Option 2 : variable d’environnement RUSTFLAGS