Documentation – ابدأ

Rust-Cpp: كيفية تثبيت Aspose.PDF لـ Rust عبر C++

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

التثبيت

التثبيت من موقع Aspose

تتضمن هذه الحزمة ملفًا كبيرًا مخزنًا كأرشيف bzip2.

تحميل الأرشيف Aspose.PDF for Rust عبر 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 ملفات checksum. إذا كان checksum مفقودًا أو غير صالح، سيفشل عملية البناء.

التثبيت من 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. نظرًا لقيود الحجم، لا يتضمن الصندوق المنشور مكتبات الثنائيات الأصلية (.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 الأرشيفات** وملفات التحقق من المجموع من مستودع 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 عبر 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 هو واجهة برمجة تطبيقات PDF غنية بالميزات تسمح للمطورين بدمج إنشاء وثائق PDF، ومعالجتها، وقدرات التحويل باستخدام Rust. يدعم العديد من صيغ الملفات الشائعة، بما في ذلك PDF، TXT، XLSX، EPUB، TEX، DOC، DOCX، PPTX، صيغ الصور وغيرها. في هذه المقالة، نقوم بإنشاء مستند PDF يحتوي على النص “Hello World!” بعد تثبيت 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 لـ 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	يحفظ المستند بتنسيق عروض مايكروسوفت باوربوينت
DOC	يحفظ المستند بتنسيق مايكروسوفت وورد
DOCX	يحفظ المستند بتنسيق مايكروسوفت وورد
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.

الميزات حسب نوع الوظيفة

العملية الأساسية	PDF جديد.
فتح PDF.
حفظ 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 for 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

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 لـ Rust عبر 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 متغير البيئة.