انتخاب مناسب‌ترین 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 را مصرف می‌کنند، ارائه می‌دهد. انتخاب صحیح معمولاً بسته‌ای است که مستقیماً با میزبان مطابقت داشته باشد و کمترین ابهام چارچوبی را برای تیم نگهدارنده برنامه باقی بگذارد.

نمای کلی SDK نمایشگر Doconut (نمای کلی SDK نمایشگر Doconut) نقطه شروع برای قابلیت‌های محصول است. از مستندات مخصوص هر چارچوب برای تصمیم‌گیری درباره بسته استفاده کنید.

درک معنای سه برچسب

.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 نسخهٔ ۲۶.۷.۰ و قبلی هدف .NET Standard 2.0 را دارند و از ادغام قبلی استفاده می‌کنند، در حالی که ۲۶.۸.۰ و بعدها هدف .NET Standard 2.1 را با API فعلی دارند.

اگر برنامه قبلاً از نسل قدیمی بسته استفاده می‌کند، پیش از به‌روزرسانی، به راهنمای مهاجرت .NET Standard مراجعه کنید. این تغییر بیش از کامپایل تأثیر می‌گذارد: راه‌اندازی، طول عمر نمایشگر، مسیریابی منابع، باز کردن سند، مجوزها، افزونه‌ها و انتشار توزیع‌شده ممکن است نیاز به توجه داشته باشند.

مقایسهٔ تأثیر کامل برنامه

یک اثبات مفهوم کوچک باید بیش از «آیا بسته نصب می‌شود؟» پاسخ دهد. ارزیابی کنید:

1. سازگاری میزبان: هدف برنامه و هر پروژه‌ای که به بستهٔ نمایشگر ارجاع می‌دهد را تأیید کنید.
2. نسل ادغام: ثبت‌نام جاری یا کلاسیک، ایجاد نمایشگر و الگوهای باز کردن سند را شناسایی کنید.
3. پوشش سند: فایل‌های نمایشی PDF، Office، CAD، تصویر، ایمیل یا پزشکی مورد نیاز محصول را تست کنید.
4. نیازهای افزونه: قابلیت‌های Search، Annotation، Converter یا DICOM را به‌صورت جداگانه اعتبارسنجی کنید هنگامی که جزئی از جریان کار هستند.
5. مدل عملیاتی: طول عمر جلسه، کش، تحویل منابع، پاک‌سازی و هر طراحی تک‌نودی یا توزیعی را تست کنید.
6. تلاش ارتقاء: تغییرات چارچوب را از تغییرات Doconut جدا کنید تا خطاها راحت‌تر تشخیص داده شوند.
7. کنترل‌های برنامه: دسترسی، ذخیره‌سازی، نگهداری و رفتار تحویل را در سیستم پیرامونی تأیید کنید.

نسخهٔ بسته و هدف چارچوب را همراه با هر نتیجه ثبت کنید. این کار از اشتباه‌گیری تست موفق در یک مسیر SDK به‌عنوان شواهد برای مسیر دیگر جلوگیری می‌کند.

صریح‌سازی انتخاب چارچوب

یک یادداشت معماری خوب می‌تواند مختصر باشد: هدف برنامه، بستهٔ Doconut انتخاب‌شده و نسخهٔ آن، افزونه‌های مورد نیاز، مدل استقرار و مسیر مستنداتی که در حین پیاده‌سازی استفاده شده‌اند را بیان کنید. این رکورد تصمیم‌گیری به ارتقاءهای بعدی کمک می‌کند تا بر پایهٔ واقعیت‌ها نه فرضیات مبتنی بر نام بسته آغاز شوند.

برای توسعهٔ جدید .NET 8، با SDK اختصاصی .NET 8 شروع کنید. برای برنامه‌ای که بر .NET 6 می‌ماند، بستهٔ به‌روز شدهٔ .NET 6 را ارزیابی کنید. از Doconut.NETStandard 26.8.0+ استفاده کنید وقتی که قرارداد .NET Standard 2.1 برای میزبان سازگار مناسب است و برنامه‌های .NET Framework را در مسیر بستهٔ اختصاصی خود نگه دارید.

مرور کنید مرکز مستندات Doconut و یک نسخه آزمایشی دانلود کنید تا مسیر انتخاب‌شده را با برنامه و اسناد خود تست کنید.