تحسين الأداء

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

ملف موارد 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 يحتوي على نص.

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