Installation

يمكن تثبيت Documentize SDK من خلال طرق متعددة، كل منها مصمم لبيئات تطوير وتفضيلات مختلفة. فيما يلي الطرق الموصى بها لتثبيت Documentize:

1. NuGet (الطريقة المفضلة)

يعد NuGet هو الطريقة الأكثر بساطة والأفضل لتثبيت Documentize، مما يضمن لك دائمًا الحصول على أحدث إصدار والتحديثات مباشرة داخل بيئة التطوير الخاصة بك. تحقق من المزيد من التفاصيل حول هذه الطريقة في التثبيت على كيفية تثبيت Documentize SDKs باستخدام NuGet.

2. مثبت MSI

يعد مثبت MSI خيارًا مريحًا إذا كنت تفضل تثبيت مكتبات Documentize DLL مباشرة على نظامك. هذه الطريقة مثالية للمطورين الذين قد يرغبون في استخدام Documentize عبر مشاريع متعددة دون الحاجة إلى إدارة ملفات DLL يدويًا. تحقق من المزيد من التفاصيل حول هذه الطريقة في التثبيت على كيفية تثبيت Documentize SDKs باستخدام MSI.

3. أرشيف ZIP

بالنسبة للمطورين الذين يفضلون نهجًا يدويًا، يحتوي أرشيف ZIP على مكتبات Documentize DLL، والتي يمكن استخراجها وإضافتها إلى مشروعك مباشرة. تحقق من المزيد من التفاصيل حول هذه الطريقة في التثبيت على كيفية تثبيت Documentize SDKs باستخدام ZIP.

25‏/07‏/2025

Installation الأقسام الفرعية

متطلبات النظام

تم تصميم SDKs الخاصة بـ Documentize للتكامل مع تطبيقات .NET ودعم أنظمة التشغيل وبيئات التطوير المختلفة. فيما يلي المتطلبات الأساسية للنظام:

أنظمة التشغيل المدعومة

ويندوز

  • ويندوز 7 (x64، x86)
  • ويندوز 8، 8.1 (x64، x86)
  • ويندوز 10 (x64، x86)
  • ويندوز 11 (x64، x86)
  • ويندوز سيرفر 2003 إلى ويندوز سيرفر 2022 (x64، x86)
  • سحابة: مايكروسوفت أزور

macOS

  • macOS 10.12 (سييرا) وما بعده

لينكس

  • متوافق مع توزيعات لينكس متعددة:
    • أوبونتو (16.04، 18.04، 20.04، 22.04)
    • سينت أوس (7، 8)
    • ديبيان (9، 10)
    • أوبن سوزي (Leap 15+، SLES 12+)

أندرويد

  • يدعم أندرويد 8.0 (أوريو) وما بعده.

بيئات التطوير

  • مايكروسوفت فيجوال ستوديو:
    • فيجوال ستوديو 2010 وما بعده (بما في ذلك 2019 و2022)
  • يدعم أي بيئة تطوير تستهدف منصات .NET.

إطارات العمل المدعومة .NET

  • .NET Framework 4.0 وما فوق
  • .NET Standard 2.0 (.NET Core 3.1+)
  • .NET 6.0، .NET 7.0، .NET 8.0

ملاحظات إضافية

  • ليس من الضروري وجود أدوبي أكروبات لتشغيل Documentize SDKs، لكن يُوصى به لعرض ملفات PDF.
25‏/07‏/2025

Declaration

تتطلب SDKs الخاصة بـ Documentize مجموعة أذونات الثقة الكاملة عند استخدامها ضمن تطبيقات .NET. مستوى هذا الإذن أساسي لتمكين الـ SDKs من أداء بعض العمليات على مستوى النظام، مثل الوصول إلى إعدادات التسجيل، وملفات النظام، وتحليل الخطوط.

لماذا يتطلب الأمر الثقة الكاملة

تستخدم SDKs الخاصة بـ Documentize فئات نظام .NET الأساسية، والتي تحتاج غالبًا إلى أذونات مرتفعة للأسباب التالية:

  • الوصول إلى التسجيل: قد تتطلب بعض العمليات قراءة أو كتابة إلى سجل النظام.
  • ملفات النظام: قد يكون من الضروري الوصول إلى ملفات النظام بعيدة عن الدليل الافتراضي للتطبيق لبعض المهام، مثل التعامل مع الخطوط أو إجراء عمليات على الملفات.

قيود بيئة الثقة المتوسطة

في بيئات الاستضافة التي تفرض أمان الثقة المتوسطة، يتم تقييد أو عدم توفر عدة أذونات مهمة. يمكن أن يمنع ذلك الـ SDKs من العمل بشكل صحيح في مثل هذه البيئات. تنطبق القيود التالية تحت الثقة المتوسطة:

  • OleDbPermission: لا يمكن استخدام موفر بيانات OLE DB المدارة من ADO.NET للوصول إلى قواعد البيانات.
  • EventLogPermission: الوصول إلى سجل أحداث Windows ممنوع.
  • ReflectionPermission: يمنع استخدام الانعكاس، مما قد يؤثر على بعض العمليات الديناميكية.
  • RegistryPermission: الوصول إلى سجل النظام مرفوض.
  • WebPermission: يتم تقييد الاتصال لتكون ضمن عناوين أو نطاقات محددة مسبقًا كما هو محدد في عنصر <trust>.
  • FileIOPermission: الوصول إلى الملفات محدود بتلك الموجودة ضمن الدليل الافتراضي للتطبيق.
25‏/07‏/2025

Non-Windows Environment

تدعم SDKs الخاصة بـ Documentize .NET Standard 2.0، مما يسمح باستخدامها في تطبيقات .NET Core التي تعمل على Linux أو بيئات غير Windows. لضمان أداء مثالي وعرض نصوص صحيح، اتبع الخطوات أدناه:

الإعداد الموصى به لـ Linux

1. تثبيت حزمة libgdiplus

توفر هذه الحزمة الوظائف الضرورية لـ GDI+، والتي تعد حاسمة لعرض ومعالجة ملفات PDF. يمكنك تثبيتها عن طريق تشغيل الأمر التالي في وحدة التحكم الخاصة بك:

sudo apt-get install libgdiplus

2. تثبيت خطوط متوافقة مع Microsoft

لضمان عرض صحيح للنصوص، قم بتثبيت خطوط Microsoft TrueType باستخدام الأمر:

sudo apt-get install ttf-mscorefonts-installer

يجب وضع هذه الخطوط في الدليل /usr/share/fonts/truetype/msttcorefonts. إذا كانت نظامك يخزن الخطوط في دليل مختلف، قم بتحديث المسار في الكود الخاص بك قبل تنفيذ أي عمليات باستخدام SDKs الخاصة بـ Documentize:

Documentize.Text.FontRepository.Sources.Add(new FolderFontSource("<path to ms fonts>"));

بقشيش

من خلال ضمان اكتمال هذه التثبيتات وتكوين مسار الخط بشكل صحيح، يمكنك تحقيق أقصى أداء لـ SDKs الخاصة بـ Documentize على Linux أو أنظمة غير Windows الأخرى.

25‏/07‏/2025

Evaluation

يمكنك بسهولة تنزيل SDKs الخاصة بـ Documentize لأغراض التقييم. النسخة التجريبية مطابقة تمامًا للنسخة المشتراة، مع الفرق الوحيد في كيفية تطبيق الرخصة.

قيود النسخة التجريبية

بينما توفر النسخة التجريبية وصولاً كاملاً إلى جميع الميزات، إلا أنها تتضمن القيود التالية حتى يتم تطبيق الرخصة:

  • يتم إدراج علامة مائية للتقييم في جميع مستندات الإخراج.
  • يمكن عرض أو تحرير أول أربع صفحات فقط من أي مستند PDF.

لإزالة هذه القيود وفتح النسخة الكاملة، ما عليك سوى تطبيق الرخصة عن طريق إضافة بضع سطور من الكود إلى مشروعك.

 عربي