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

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.

Licence Aspose PDF