בחירת 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 היא נקודת ההתחלה להבנת היכולות של המוצר. השתמש בתיעוד המותאם למסגרת כדי לקבל את החלטת החבילה.
הבנת משמעות שלושת התוויות
.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 | שומר על יעד המארח תוך מתן ה‑DI, middleware, async‑session והמודל המבוזר האופציונלי העדכניים. |
| מארח 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 מתאר את המודל הנוכחי המבוסס על הזרקת תלויות, משאבים המוגשים דרך middleware, מושבי מסמכים אסינכרוניים, וזרימות עבודה מבוזרות אופציונליות.
התאמה ישירה של זמן הריצה גם מקלה על מעקב אחרי התיעוד. התקנה, קונפיגורציה, פתרון בעיות, תוספים ודוגמאות ניתנים להערכה במסגרת נתיב ייחודי למסגרת.
לפני האימוץ, בדוק את פורמטי המסמכים והתכונות האופציונליות שהמוצר באמת דורש. התאמת חבילה אינה מחליפה החלטות ברמת היישום בנוגע לאימות, הרשאות, אחסון, שמירה, ניטור והגבלות משאבים.
בחר ב‑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 חדש, התחל עם ערכת הפיתוח המיועדת ל‑.NET 8. עבור יישום השומר על .NET 6, הערך את חבילת .NET 6 המעודכנת. השתמש ב‑Doconut.NETStandard 26.8.0+ כאשר חוזה .NET Standard 2.1 הוא ההתאמה הנכונה למארח תואם, ושמור על יישומי .NET Framework בנתיב החבילה המיועד להם.
סקור את מרכז התיעוד של Doconut והורד גרסת ניסיון כדי לבדוק את הנתיב שנבחר עם היישום והמסמכים שלך.