הצופה הבסיסי של Doconut עבור .NET 8 מגיע כחבילה אחת של NuGet שניתן לשלב בכל אפליקציית ASP.NET Core. תוספים אופציונליים משתמשים בחבילות נפרדות. דף זה מתקין את החבילה הבסיסית ורושם את ה‑middleware — המינימום הדרוש לפני הרינדור הראשון שלך.

התקנת החבילה

bash

dotnet add package Doconut.NET8

הפקודה ללא גרסה מתקינה את הגרסה היציבה האחרונה. כדי לשחזר בדיוק את הגרסה 26.7.0 הנוכחית, העבר את הגרסה כאופציה נפרדת:

bash

dotnet add package Doconut.NET8 --version 26.7.0

Doconut.NET8 הוא מזהה החבילה. הסיומת .26.7.0 שייכת לשם הקובץ שהורד Doconut.NET8.26.7.0.nupkg ואינה חלק מהמזהה.

רישום Doconut

AddDoconut() הוא נקודת הכניסה היחידה לרישום — יש עומס אחד בלבד, והוא מחבר את שירות ה‑Viewer, שירות הרישיון ותשתית הרינדור למיכל ה‑DI.

שני קריאות middleware משלים את ההגדרה, והסדר שלהן חשוב: UseDoconutResources() חייב לרוץ לפני UseDoconut(). UseDoconut() הוא middleware סופי, ולכן קריאה אליו ראשון גורמת לכך שכל בקשה למשאב /doconut-res לא תגיע למטפל המשאבים ותחזיר 404. חיבור ה‑session נדרש גם הוא — האבטחה המוגדרת של Doconut מאמתת כל בקשת עמוד מול מצב ה‑session של ASP.NET.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddSession(); // Doconut document security rides on ASP.NET session state

app.UseSession();          // call UseSession() before UseDoconut()
app.UseDoconutResources(); // must be registered before UseDoconut()
app.UseDoconut();

כל האפשרויות

DoconutOptions מקבל את המאפיינים הניתנים להגדרה הבאים. כל אחד מהם אופציונלי — ברירות המחדל שלהלן חלות כאשר מאפיין נשאר ללא ערך.

מאפיין	ברירת מחדל	תיאור
`ShowDoconutInfo`	`false`	כאשר `true`, בקשה ללא `token` מחזירה באנר גרסה במקום 404. שימושי לבדיקת עישון; השאר כבוי בייצור.
`UnsafeMode`	`false`	כאשר `true`, מדלג על בדיקת האבטחה של ASP.NET‑session בבקשות עמוד. השאר כבוי בייצור.
`MiddlewarePath`	`"/doconut"`	ערך תיאום לנקודת הקצה של דף‑תמונה. הוא מאומת, אך אינו יוצר ענף בעצמו; שמור אותו תואם למיפוי האמיתי של `UseDoconut()` ול‑`BasePath` של הלקוח.
`ResourcesPath`	`"/doconut-res"`	היכן המשאבים המוטמעים של JS/CSS/תמונה מוגשים.
`LicensePath`	`""` (empty string)	נתיב לקובץ הרישיון. ריק משמעותו לעבור למקור הבא, ואז חיפוש אוטומטי.
`LicenseContent`	`""` (empty string)	תוכן רישיון גולמי — ממשתנה סביבתי, מנהל סודות, או מסד נתונים.
`LicenseStream`	`null`	רישיון כ‑stream, נקרא פעם אחת בעת האתחול.
`ResetLicense`	`false`	דגל תאימות שמור. שירותי .NET 8 הנוכחיים קוראים את הרישיון במהלך `AddDoconut()`; יש לאתחל את האפליקציה לאחר החלפת רישיון.

העדיפות של הרישיון כאשר מוגדר יותר ממקור אחד: LicenseStream גובר על LicenseContent, שמגבר על LicensePath, שמגבר על חיפוש אוטומטי — ראה הגדרת רישיון.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // coordinate with app mapping and client BasePath
    options.ResourcesPath   = "/doconut-res"; // where the viewer's JS/CSS/images are served from
    options.UnsafeMode      = false;          // keep session security on
    options.ShowDoconutInfo = false;
});

הצעדים הבאים

התחלה מהירה — פתח את המסמך הראשון שלך והצג אותו בדפדפן.
הגדרת רישיון — המקום שבו Doconut מחפש את קובץ הרישיון שלך.