تحسين الأداء

تحسين العرض والذاكرة

ملف موارد Doconut يهيمن عليه ثلاثة أشياء: دقة العرض DPI، ما يبقى مخزنًا مؤقتًا، ومدة بقاء الجلسات. يشرح هذا الدليل الرافعات بترتيب الأثر.

الدقة — الرافعة الأكبر

ImageResolution (25–300 DPI) يحدد كلًا من وقت العرض وحجم الصورة. معظم الصيغ الافتراضية 200 DPI؛ الصور وPSD الافتراضية 100.

csharp
// معاينة قائمة المستندات لا تحتاج إلى جودة الطباعة
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { ImageResolution = 100 });

تقسيم DPI إلى النصف يقلل عدد البكسلات في الصفحة تقريبًا إلى الربع — عروض أسرع، نقل أصغر، ذاكرة تخزين مؤقت أقل. احجز 250–300 DPI للحالات التي تتطلب تكبيرًا كبيرًا (CAD، الرسومات الهندسية).

بالنسبة لملفات PDF التي تحتوي على صور مدمجة بكثافة، PdfConfig يضيف ضبطًا أدق: CompressImages + CompressQuality، ResizeImages + ResizeResolution، وCompressFast. بالنسبة للصور العادية، ImageConfig.MaxImagePixelSize (الافتراضي 3000 بكسل) يحد من حجم الإخراج.

التخزين المؤقت للصفحات — الذاكرة مقابل إعادة العرض

BaseConfig.CachePages (الافتراضي true) يحتفظ بكل صفحة مُعروضة في الذاكرة طوال مدة الجلسة. هذا هو الإعداد الافتراضي المناسب للعرض التفاعلي — المستخدمون يتنقلون للأمام والخلف. قم بإيقافه عندما:

  • الوثائق ضخمة وتُعرض مرة واحدة من البداية إلى النهاية،
  • عدد كبير من الجلسات المتزامنة سيضاعف الصفحات المخزنة مؤقتًا،
  • تفضل استهلاك وحدة المعالجة المركزية لكل عرض بدلاً من احتفاظ بالذاكرة.
csharp
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { CachePages = false });

على العميل، ViewerConfig.CacheEnabled = true يحمّل مسبقًا نافذة صغيرة متحركة من صور الصفحات القادمة في ذاكرة المتصفح. إنها ذاكرة تخزين مؤقت مسبقة للعرض، ليست localStorage مستمرة.

الجلسات — الذاكرة التي لا تراها

كل جلسة مفتوحة تحتفظ بنموذج المستند المُحلل بالإضافة إلى (مع CachePages) صفحاته المعروضة، حتى ينقضي الـ TimeOut المتحرك (الافتراضي 60 دقيقة) منذ آخر طلب. عادتان تحافظان على التحكم في ذلك:

  • أغلق ما انتهيت منه. viewer.CloseDocument(token) يحرّر المحرك فورًا بدلاً من الانتظار حتى انتهاء نافذة الخمول.
  • اضبط مهلة الجلسة بشكل مناسب. المعاينة التي يطّلع عليها المستخدمون لمدة دقيقتين لا تحتاج إلى جلسة ساعة:
csharp
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });

تذكر المقايضة: بعد انتهاء الصلاحية يظهر الودجت Document session not found. Please re-open document. — اختر مهلة تتناسب مع جلسات القراءة الفعلية.

مفاتيح خاصة بالصيغة

  • Excel: MemoryOptimizationPreference مفعل افتراضيًا ويقلل استهلاك الذاكرة عند عرض دفاتر عمل ضخمة جدًا — اتركه مفعلاً، أو اضبطه إلى false إذا كنت ترغب في مقايضة الذاكرة مقابل زيادة سرعة صغيرة؛ SheetNames / PrintArea يقيّد العرض إلى ما هو مهم.
  • وضع التحويل لديه تكلفة مسبقة: DefaultRender = false يحول الوثيقة بأكملها إلى PDF عند الفتح. يتيح بحثًا نصيًا أصليًا، لكن على مستند من 500 صفحة يحمل استدعاء الفتح تلك التحويلة — لا تقم بتمكينه تلقائيًا.
  • Word/PPT على Linux/Docker: الخطوط المفقودة تسبب فحصًا بطيئًا للبدائل ومقاييس خاطئة؛ وجه FontFolders إلى دليل يحتوي على خطوطك.
  • العروض التقديمية على Linux: لا حاجة لمفتاح libgdiplus أو System.Drawing.EnableUnixSupport — راجع الخطوط على Linux.

استراتيجيات جانب العميل

  • LargeDoc = true — استراتيجية التحميل الكسول للوثائق الضخمة جدًا؛ تُحمّل الصفحات عندما يقترب المستخدم منها.
  • AutoLoad = false (الافتراضي) — لا تقم بالعرض حتى تستدعي فعليًا View(token).
  • ShowThumbs = false — تخطى إنشاء/طلب الصور المصغرة للمعاينات ذات الصفحة الواحدة أو المدمجة.
  • تمكين FixedZoom يتجنب تغييرات التكبير الحرّة؛ عندما تربط C# ViewerConfig، اضبط FixedZoomPercentMobile (الافتراضي C# 75) للشاشات الصغيرة.

بدء التشغيل مرة واحدة، لا لكل طلب

Encoding.RegisterProvider(CodePagesEncodingProvider.Instance) ينتمي إلى Program.cs — تسجيل الترميزات لكل طلب هو عمل مهدور؛ نسيانه تمامًا يكسر مستندات صفحات الشيفرة القديمة.

توزيع العمل عبر العقد

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

قائمة فحص التحسين

  1. حدد أدنى ImageResolution يقبله تجربة المستخدم لديك.
  2. احتفظ بـ CachePages مفعلاً للعرض التفاعلي؛ أوقفه للمرور الواحد أو السيناريوهات ذات التزامن العالي.
  3. أغلق الجلسات صراحةً؛ قلل TimeOut حيث يكون الاستخدام متقطعًا.
  4. استخدم LargeDoc + الافتراضي AutoLoad = false على العميل للوثائق الكبيرة.
  5. استخدم DefaultRender = false فقط عندما تحتاج إلى إسقاط PDF يحتوي على نص.

هل كانت هذه الصفحة مفيدة؟