اختيار SDK Doconut المناسب: .NET Standard 2.1، .NET 6، أو .NET 8
ابدأ بمضيف التطبيق
اختيار حزمة Doconut يبدأ بالمشروع الذي سيشغلها. يمكن لتطبيق ويب جديد على .NET 8، أو خدمة .NET 6 القائمة، أو مضيف ASP.NET Core المتوافق مع المكتبة أن يحتاج جميعًا إلى عرض مستندات مدمج، لكن قيود الإطار وخطط الترقية تختلف.
توفر Doconut مسارات SDK الحالية لـ .NET 8 و .NET 6 والمضيفين المتوافقين الذين يستهلكون حزمة .NET Standard 2.1 الجديدة. الاختيار الصحيح عادةً ما يكون الحزمة التي تتطابق مباشرة مع المضيف وتقلل من غموض الإطار للفريق الذي يصون التطبيق.
تُعد نظرة عامة على Doconut Viewer SDK نقطة الانطلاق لفهم قدرات المنتج. استخدم الوثائق المخصصة للإطار لاتخاذ قرار الحزمة.
فهم ما تعنيه الثلاثة تسميات
.NET 8 و .NET 6 هما أهداف تطبيقية. يمكن لتطبيق ويب أن يستهدف أحد هذه الأوقات التشغيلية ويختار حزمة Doconut المطابقة.
.NET Standard 2.1 مختلف: فهو يحدد عقد API للمكتبة يمكن للمضيفين المتوافقين مع .NET استهلاكه. يقدم Doconut 26.8.0 الجيل الحالي من Doconut.NETStandard للتطبيقات التي تستهدف .NET Core 3.0 أو أحدث، بما في ذلك .NET 5 حتى .NET 8. لا يمكن استهلاكه بواسطة .NET Framework.
هذا التمييز يبقي القرار ثابتًا. لا تختَر .NET Standard 2.1 لأنه يبدو أكثر عمومية؛ اختره عندما يكون عقده هو الأنسب للمضيف وبنية الحل.
جدول اختيار عملي
| حالة التطبيق | مسار Doconut للتقييم | السبب |
|---|---|---|
| تطبيق جديد يستهدف .NET 8 | Doconut.NET8 | مطابقة مباشرة لتطوير .NET الحالي ومسار الوثائق الكامل لـ .NET 8. |
| تطبيق موجود يجب أن يبقى على .NET 6 | Doconut.NET6 | يحافظ على هدف المضيف مع توفير حقن الاعتمادية الحالي، والوسطية، وجلسة غير متزامنة، والنموذج الموزع الاختياري. |
| مضيف ASP.NET Core متوافق حيث يتطلب عقد .NET Standard | Doconut.NETStandard 26.8.0+ | يستهدف .NET Standard 2.1 ويكشف عن تكامل Doconut الحالي للمضيفين المدعومين. |
| تكامل Doconut.NETStandard 26.7.0 أو أقدم موجود | خطط للترحيل قبل اختيار 26.8.0+ | معرّف الحزمة يبقى نفسه، لكن الهدف وتوليد API يتغيران. |
| تطبيق يستهدف .NET Framework | Doconut.NETFramework | لا يمكن لـ .NET Framework استهلاك .NET Standard 2.1. |
يقصر هذا الجدول القرار الأول. لا يزال يتعين التحقق من الترخيص، والإضافات الاختيارية، وصيغ المستندات، وتصميم النشر، وجهد الترقية بشكل منفصل.
اختر Doconut.NET8 للتطبيقات الجديدة على .NET 8
لتطبيق .NET 8 جديد، الحزمة المخصصة هي الخيار الأكثر وضوحًا للتقييم. صفحة عارض .NET 8 تصف النموذج الحالي القائم على حقن الاعتمادية، والموارد المقدمة عبر الوسطية، وجلسات المستندات غير المتزامنة، وسير العمل الموزع الاختياري.
المطابقة المباشرة للوقت التشغيلي تجعل الوثائق أسهل في المتابعة. يمكن تقييم التثبيت، والتكوين، واستكشاف الأخطاء، والإضافات، والعينات جميعًا ضمن مسار واحد مخصص للإطار.
قبل الاعتماد، اختبر صيغ المستندات والميزات الاختيارية التي يحتاجها المنتج فعليًا. مطابقة الحزمة لا تحل محل قرارات مستوى التطبيق بشأن المصادقة، والتفويض، والتخزين، والاحتفاظ، والمراقبة، وحدود الموارد.
اختر Doconut.NET6 عندما يجب أن يبقى المضيف على .NET 6
قد يحتوي تطبيق مستقر على تبعيات أو التزامات دعم تجعله يبقى على .NET 6. يتيح المشاهد المحدث لـ .NET 6 للتطبيق الحفاظ على هذا الهدف مع الانتقال إلى بنية التكامل الحالية لـ Doconut.
هذا مفيد عندما لا ينبغي أن يحدث ترقية وقت التشغيل وترحيل عارض المستندات في نفس الإصدار. يمكن للفريق تحديث تسجيل العارض، تسليم الموارد، الفتح غير المتزامن، وجلسات المستندات مع الحفاظ على استقرار إطار عمل المضيف.
تحقق مما إذا كان المشروع الحالي يستخدم التكامل الكلاسيكي أو المحدث لـ Doconut .NET 6. قد لا تكشف أسماء الحزم وحدها عن الجيل. تحدد وثائق الترحيل الرسمية توقيعات API وأنماط الاستضافة التي تميز بينها.
اختر Doconut.NETStandard عندما يتناسب العقد مع الحل
الدليل الجديد لتثبيت .NET Standard 2.1 يحدد حدود التوافق. يدعم مضيفات .NET Core 3.0 وما بعدها، بما في ذلك .NET 5، 6، 7، و8، ويستثني .NET Framework.
يمكن أن يكون هذا المسار منطقيًا عندما يتطلب الحل تحديدًا عقد مكتبة .NET Standard. اختيار الإصدار أمر حاسم: Doconut.NETStandard 26.7.0 وما قبله يستهدف .NET Standard 2.0 ويستخدم التكامل السابق، بينما 26.8.0 وما بعده يستهدف .NET Standard 2.1 مع API الحالي.
إذا كان التطبيق يستخدم بالفعل جيل الحزمة الأقدم، راجع دليل ترحيل .NET Standard قبل التحديث. التغيير يؤثر على أكثر من عملية التجميع: بدء التشغيل، عمر العارض، توجيه الموارد، فتح المستندات، الترخيص، الإضافات، والنشر الموزع قد يحتاج إلى اهتمام.
قارن تأثير التطبيق الكامل
يجب أن يجيب نموذج إثبات مفهوم صغير على أكثر من سؤال "هل يتم تثبيت الحزمة؟" قيم:
- توافق المضيف: تأكد من هدف التطبيق وكل مشروع يشير إلى حزمة العارض.
- جيل التكامل: حدد التسجيل الحالي أو الكلاسيكي، إنشاء العارض، وأنماط فتح المستندات.
- تغطية المستندات: اختبر ملفات PDF، Office، CAD، الصور، البريد الإلكتروني، أو الملفات الطبية النموذجية المطلوبة من المنتج.
- احتياجات الإضافات: تحقق من قدرات البحث، التعليقات التوضيحية، التحويل، أو DICOM بشكل فردي عندما تكون جزءًا من سير العمل.
- نموذج التشغيل: اختبر عمر الجلسة، التخزين المؤقت، تسليم الموارد، التنظيف، وأي تصميم عقدة واحدة أو موزع.
- جهد الترقية: افصل تغييرات الإطار عن تغييرات Doconut لتسهيل تشخيص الأخطاء.
- ضوابط التطبيق: تحقق من الوصول، التخزين، الاحتفاظ، وسلوك التسليم في النظام المحيط.
سجّل إصدار الحزمة وإطار العمل المستهدف جنبًا إلى جنب مع كل نتيجة. هذا يمنع اعتبار اختبار ناجح لمسار SDK واحد دليلًا على مسار آخر.
اجعل اختيار الإطار واضحًا
يمكن أن تكون ملاحظة الهندسة المعمارية جيدة مختصرة: حدد هدف التطبيق، حزمة Doconut المختارة وإصدارها، الإضافات المطلوبة، نموذج النشر، ومسار الوثائق المستخدم أثناء التنفيذ. سجل القرار هذا يساعد الترقيات المستقبلية على الانطلاق من حقائق بدلاً من افتراضات اسم الحزمة.
لتطوير .NET 8 جديد، ابدأ باستخدام SDK المخصص لـ .NET 8. لتطبيق يبقى على .NET 6، قيم الحزمة المحدثة لـ .NET 6. استخدم Doconut.NETStandard 26.8.0+ عندما يكون عقد .NET Standard 2.1 هو الأنسب لمضيف متوافق، واحتفظ بتطبيقات .NET Framework على مسار الحزمة المخصص لها.
راجع محور وثائق Doconut وحمّل نسخة تجريبية لاختبار المسار المختار مع تطبيقك ومستنداتك.