التثبيت

تثبيت Documentize SDK

يمكن تثبيت Documentize من خلال عدة طرق، كل منها مصمم ليناسب بيئات التطوير المختلفة والتفضيلات. فيما يلي الطرق الموصى بها لتثبيت 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.

28‏/12‏/2024

التثبيت الأقسام الفرعية

تثبيت Documentize عبر NuGet


بقشيش

NuGet هو مدير حزم مجاني ومفتوح المصدر لـ .NET يسهل إضافة وإزالة وتحديث المكتبات في مشاريع Visual Studio. يدير ملفات المكتبات والمراجع والتغييرات في التكوين تلقائيًا.

كيفية التثبيت عبر وحدة تحكم مدير الحزم NuGet

  1. افتح مشروعك:

    • قم بتشغيل Visual Studio وافتح تطبيق .NET الخاص بك.
  2. الوصول إلى وحدة تحكم مدير الحزم:

    • انتقل إلى الأدوات > مدير حزم NuGet > وحدة تحكم مدير الحزم.
  3. تثبيت الحزمة:

    • لتثبيت أحدث إصدار كامل، أدخل الأمر Install-Package Documentize.
    • لتثبيت أحدث إصدار بما في ذلك الإصلاحات العاجلة، استخدم Install-Package Documentize -prerelease.
    • اضغط Enter لتنفيذ الأمر.

كيفية تحديث الحزمة عبر وحدة تحكم مدير الحزم NuGet

إذا كنت قد قمت بالفعل بتثبيت Documentize عبر NuGet وترغب في التحديث إلى أحدث إصدار:

  1. افتح مشروعك:

    • قم بتشغيل Visual Studio وافتح تطبيق .NET الخاص بك.
  2. الوصول إلى وحدة تحكم مدير الحزم:

    • انتقل إلى الأدوات > مدير حزم NuGet > وحدة تحكم مدير الحزم.
  3. تحديث الحزمة:

    • للتحديث إلى أحدث إصدار كامل، أدخل Update-Package Documentize.
    • للتحديث إلى أحدث إصدار بما في ذلك الإصلاحات العاجلة، استخدم Update-Package Documentize -prerelease.
    • اضغط Enter لتنفيذ الأمر.

كيفية التثبيت عبر واجهة المستخدم الرسومية لمدير الحزم NuGet

  1. افتح مشروعك:

    • قم بتشغيل Visual Studio وافتح تطبيق .NET الخاص بك.
  2. انتقل إلى إدارة حزم NuGet:

    • من قائمة المشروع، اختر إدارة حزم NuGet.
  3. بحث عن Documentize:

    • انتقل إلى علامة التبويب تصفح وادخل Documentize في مربع البحث.
  4. تثبيت الحزمة:

    • انقر على تثبيت/تحديث بجانب أحدث إصدار من Documentize.
    • أكد بالضغط على قبول في نافذة منبثقة.

مزايا استخدام NuGet

  • إدارة التبعيات تلقائيًا:

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

    • عملية تحديث الحزم بسيطة مع NuGet، سواء من خلال وحدة تحكم مدير الحزم أو واجهة المستخدم الرسومية. يجعل هذا من السهل الحفاظ على مكتباتك محدثة مع أحدث الميزات وإصلاحات الأخطاء.
  • متكامل مع Visual Studio:

    • يتم دمج NuGet بسلاسة مع Visual Studio، يوفر واجهة مستخدم سهلة لإدارة الحزم دون مغادرة بيئة التطوير.
  • إدارة الإصدارات:

    • يتيح لك NuGet تحديد وإدارة إصدارات مختلفة من المكتبات، مما يمكنك من العودة بسهولة إلى الإصدارات السابقة أو اختبار الإصدارات الجديدة دون تعطيل تطويرك.

عيوب استخدام NuGet

  • مقتصر على Visual Studio:

    • تم تصميم NuGet بشكل أساسي للاستخدام داخل Visual Studio. بالرغم من أنه يمكن استخدامه في بيئات أخرى، إلا أن التكامل هو الأكثر قوة في Visual Studio.
  • احتمالية تعارض الإصدارات:

    • في المشاريع الأكبر ذات العديد من التبعيات، قد تصبح إدارة الإصدارات وحل النزاعات معقدة. يوفر NuGet أدوات لإدارة ذلك، ولكنه يتطلب اهتمامًا دقيقًا.
  • اعتماد على الشبكة:

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

    • بالنسبة للمشاريع الكبيرة جدًا ذات أشجار التبعيات الواسعة، قد يصبح العبء الناتج عن إدارة الحزم عبر NuGet مرهقًا. في مثل هذه الحالات، قد تكون أدوات أو استراتيجيات إضافية مطلوبة لإدارة التبعيات بفعالية.

تثبيت Documentize عبر MSI

بقشيش

مثبت MSI هو خيار مريح وسهل الاستخدام لتثبيت Documentize، خاصة إذا كنت تفضل أن يتم تثبيت المكتبات الديناميكية (DLLs) على مستوى النظام. هذه الطريقة تبسط عملية التثبيت من خلال أتمتة العديد من الخطوات المعنية.

كيفية التثبيت عبر مثبت MSI

  1. تحميل مثبت MSI:

    • انقر على v24.12 MSI لتحميل مثبت MSI لأحدث إصدار من Documentize.
  2. تشغيل المثبت:

    • انقر نقرًا مزدوجًا على ملف MSI الذي تم تحميله لبدء معالج التثبيت.
  3. اتباع معالج التثبيت:

    • اتبع التعليمات الظاهرة على الشاشة التي يقدمها المثبت. قد تحتاج إلى الموافقة على اتفاقية الترخيص واختيار خيارات التثبيت.
  4. إكمال التثبيت:

    • بمجرد اكتمال التثبيت، سيتم تثبيت مكتبات Documentize الديناميكية (DLLs) في ذاكرة التخزين المؤقت العامة (GAC) للنظام أو في موقع محدد آخر.
  5. التحقق من التثبيت:

    • تحقق من أن المكتبات الديناميكية قد تم تثبيتها بشكل صحيح من خلال التحقق من وجودها في دليل التثبيت المحدد أو في GAC.

مزايا استخدام مثبت MSI

  • سهولة الاستخدام:

    • يوفر مثبت MSI عملية تثبيت بسيطة وموجهة. يتولى جميع التكوينات اللازمة ويضع المكتبات الديناميكية في موقع مركزي، مما يسهل استخدام Documentize عبر مشاريع متعددة.
  • تثبيت على مستوى النظام:

    • تثبت طريقة MSI Documentize في ذاكرة التخزين المؤقت العامة (GAC) للنظام أو في موقع مركزي آخر. وهذا يسمح لأي تطبيق على النظام بالوصول إلى المكتبات الديناميكية دون الحاجة إلى الإشارة إليها بشكل فردي في كل مشروع.
  • تحديثات مؤتمتة:

    • إذا قدمت Documentize مثبتًا محدثًا، يمكنك بسهولة تحديث تثبيتك عن طريق تشغيل ملف MSI الجديد، والذي يتولى عادةً عملية التحديث بسلاسة.
  • اتساق:

    • يضمن استخدام مثبت MSI أن جميع الملفات المطلوبة تُثبت بشكل صحيح ومتسق عبر بيئات مختلفة، مما يقلل من خطر فقدان أو عدم مكان المكتبات الديناميكية.

عيوب استخدام مثبت MSI

  • مرونة محدودة:

    • يثبت مثبت MSI Documentize في موقع على مستوى النظام، وهو ما قد لا يكون مناسبًا لجميع بيئات التطوير. قد تفتقر هذه الطريقة إلى المرونة لتلبية تكوينات أو إصدارات خاصة بالمشاريع.
  • العبء المحتمل:

    • يمكن أن يؤدي تثبيت المكتبات الديناميكية في GAC إلى إدخال عبء وتعقيد، خاصة في السيناريوهات التي قد تحتاج فيها إلى نسخ متعددة من Documentize في وقت واحد.
  • إزالة يدوية:

    • إذا كنت بحاجة إلى إلغاء تثبيت Documentize، يجب عليك استخدام برنامج إلغاء التثبيت المقدم من MSI، مما قد يترك ملفات أو تكوينات متبقية إذا لم يتم إدارتها بشكل صحيح.
  • تعارضات الإصدارات:

    • يمكن أن تؤدي التثبيتات على مستوى النظام إلى تعارضات في الإصدارات إذا كانت المشاريع المختلفة تتطلب إصدارات مختلفة من Documentize. قد يتطلب إدارة هذه التعارضات تكوينات أو تنظيف إضافي.

تثبيت Documentize عبر ZIP

بقشيش

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

كيفية التثبيت عبر أرشيف ZIP

  1. تنزيل أرشيف ZIP:

    • انقر على v24.12 ZIP لتنزيل أحدث إصدار من Documentize بتنسيق أرشيف.
  2. استخراج المحتويات:

    • بعد التنزيل، قم باستخراج محتويات ملف ZIP إلى دليل من اختيارك. يمكنك اختيار الاحتفاظ بهذه الملفات في دليل مشترك أو ضمن هيكل مشروعك.
  3. إضافة المراجع إلى مشروعك:

    • افتح مشروعك في بيئة تطويرك (على سبيل المثال، Visual Studio).
    • انتقل إلى مشروع > إضافة مرجع > تصفح وانتقل إلى الدليل حيث قمت باستخراج ملفات DLL.
    • حدد ملفات DLL ذات الصلة وأضفها كمراجع لمشروعك.
  4. التحديثات اليدوية:

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

مزايا استخدام أرشيف ZIP

  • تحكم كامل:

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

    • على عكس NuGet، لا تعتمد على مدير حزم للتعامل مع التثبيتات. يمكن أن يكون ذلك مفيدًا في البيئات التي لا تتوفر فيها مديري الحزم أو لا يُفضل استخدامها.
  • قابلية النقل:

    • يمكن مشاركة أرشيف ZIP بسهولة ونقله عبر أنظمة مختلفة، مما يجعله مثاليًا للمشاريع التي تحتاج إلى أن تكون قابلة للنقل أو التوزيع دون الاعتماد على أدوات خارجية.

عيوب استخدام أرشيف ZIP

  • إدارة يدويه:

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

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

    • لن تتلقى تحديثات تلقائية أو إشعارات عند توفر إصدار جديد. يمكن أن يؤدي ذلك إلى خطر استخدام مكتبات قديمة ما لم تتحقق بانتظام من التحديثات.

بيئة غير ويندوز

العمل مع مكتبات .NET Core DLLs في بيئة غير ويندوز

نظرًا لأن Documentize لـ .NET يوفر دعم .NET Standard 2.0 (.NET Core 2.0)، يمكن استخدامه في تطبيقات Core التي تعمل على أنظمة تشغيل تشبه لينكس. نحن نعمل باستمرار على تحسين دعم .NET Core في واجهة برمجة التطبيقات الخاصة بنا. ومع ذلك، هناك بعض العمليات التي نوصي عملائنا بأدائها للحصول على نتائج أفضل عند استخدام ميزات Documentize لـ .NET. يرجى تثبيت:

  • حزمة libgdiplus
  • حزمة تحتوي على خطوط متوافقة مع Microsoft: ttf-mscorefonts-installer (على سبيل المثال، sudo apt-get install ttf-mscorefonts-installer). يجب وضع هذه الخطوط في دليل /usr/share/fonts/truetype/msttcorefonts حيث يقوم Documentize لـ .NET بفحص هذا المجلد على أنظمة تشغيل تشبه لينكس. في حال كان نظام التشغيل لديه مجلد/دليل افتراضي آخر للخطوط، يجب عليك استخدام السطر التالي من التعليمات البرمجية قبل إجراء أي عملية باستخدام Documentize:
    Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<مسار المستخدم إلى خطوط Microsoft>"));
 عربي