Εγκατάσταση

Προσθέστε το Doconut στο .NET 8 έργο σας

Ο βασικός προβολέας Doconut για .NET 8 διανέμεται ως ένα πακέτο NuGet που ενσωματώνεται σε οποιαδήποτε εφαρμογή ASP.NET Core. Προαιρετικά πρόσθετα χρησιμοποιούν ξεχωριστά πακέτα. Αυτή η σελίδα εγκαθιστά το βασικό πακέτο και καταχωρίζει το middleware — το ελάχιστο που απαιτείται πριν από την πρώτη σας απόδοση.

Απαιτήσεις

Το πακέτο λειτουργεί σε αυτές τις πλατφόρμες:

ΠλατφόρμαΥποστηρίζεται
Windows x64 / x86Ναι
Linux x64, glibc-based (Debian, Ubuntu, the official mcr.microsoft.com/dotnet/aspnet:8.0 image)Ναι
Alpine και άλλες διανομές βασισμένες σε muslΌχι
macOSΌχι

Στο Linux, εγκαταστήστε τη βιβλιοθήκη ρύθμισης γραμματοσειρών πριν ανοίξει το πρώτο έγγραφο:

bash
apt-get update && apt-get install -y libfontconfig1

Σε διανομές RHEL, Fedora και παρόμοιες, το πακέτο είναι fontconfig (dnf install -y fontconfig). Αυτό είναι το μόνο σύστημα πακέτο που χρειάζεται το Doconut: οι εγγενείς βιβλιοθήκες που χρησιμοποιεί περιλαμβάνονται μέσα στο πακέτο NuGet, και το libgdiplus δεν απαιτείται. Οι σελίδες σχεδιάζονται με τις γραμματοσειρές που είναι εγκατεστημένες στον διακομιστή, οπότε δείτε Αντιμετώπιση προβλημάτων για τις γραμματοσειρές και τα μηνύματα σφάλματος του Linux.

Εγκατάσταση πακέτου

bash
dotnet add package Doconut.NET8

Η εντολή χωρίς έκδοση εγκαθιστά την πιο πρόσφατη σταθερή έκδοση. Για να κλειδώσετε την έκδοση που περιγράφει αυτή η τεκμηρίωση, περάστε την έκδοση ως ξεχωριστή επιλογή:

bash
dotnet add package Doconut.NET8 --version 26.10.0

Doconut.NET8 είναι το αναγνωριστικό του πακέτου. Το επίθημα έκδοσης ανήκει στο ληφθέν όνομα αρχείου Doconut.NET8.<version>.nupkg και δεν αποτελεί μέρος του αναγνωριστικού.

Καταχώρηση Doconut

AddDoconut() είναι το μοναδικό σημείο εγγραφής — υπάρχει μία μόνο υπερφόρτωση, και συνδέει την υπηρεσία Viewer, την υπηρεσία άδειας, και την υποδομή απόδοσης στο DI container.

Δύο κλήσεις middleware ολοκληρώνουν τη ρύθμιση, και η σειρά τους έχει σημασία: UseDoconutResources() πρέπει να εκτελείται πριν από UseDoconut(). UseDoconut() είναι τελικό middleware, έτσι η κλήση του πρώτα σημαίνει ότι κάθε αίτημα σε έναν πόρο /doconut-res δεν φτάνει ποτέ στον διαχειριστή πόρων και επιστρέφει 404. UseDoconut() απαντά σε κάθε αίτημα που το φθάνει, οπότε τοποθετήστε το σε ξεχωριστό κλάδο με app.Map. Η σύνδεση της συνεδρίας απαιτείται επίσης — η προεπιλεγμένη ασφάλεια εγγράφου του Doconut επικυρώνει κάθε αίτημα σελίδας έναντι της κατάστασης συνεδρίας ASP.NET.

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // η κατάσταση της συνεδρίας χρειάζεται μια κρυφή μνήμη (MVC/Razor Pages ήδη προσθέτουν μία)
builder.Services.AddSession(); // Η ασφάλεια εγγράφου Doconut βασίζεται στην κατάσταση συνεδρίας ASP.NET

app.UseSession();          // καλέστε το UseSession() πριν το UseDoconut()
app.UseDoconutResources(); // πρέπει να εγγραφεί πριν το UseDoconut()
app.Map("/doconut", branch => branch.UseDoconut());

Όλες οι επιλογές

DoconutOptions δέχεται τις ακόλουθες ρυθμιζόμενες ιδιότητες. Κάθε μία είναι προαιρετική — οι προεπιλογές παρακάτω ισχύουν όταν μια ιδιότητα παραμείνει ακαθορισμένη.

ΙδιότηταΠροεπιλογήΠεριγραφή
ShowDoconutInfofalseΌταν true, ένα αίτημα χωρίς token επιστρέφει μια μπάνερ έκδοσης αντί για 404. Χρήσιμο ως έλεγχος καπνού· απενεργοποιήστε το στην παραγωγή.
UnsafeModefalseΌταν true, παραλείπει τον έλεγχο ασφαλείας συνεδρίας ASP.NET στα αιτήματα σελίδας. Απενεργοποιήστε το στην παραγωγή.
MiddlewarePath"/doconut"Τιμή συντονισμού για το endpoint page-image. Επικυρώνεται, αλλά δεν δημιουργεί κλάδο από μόνη της· διατηρήστε την ευθυγραμμισμένη με την πραγματική αντιστοίχιση UseDoconut() και τον πελάτη BasePath.
ResourcesPath"/doconut-res"Από πού σερβίρονται οι ενσωματωμένοι πόροι JS/CSS/εικόνας.
LicensePath"" (κενή συμβολοσειρά)Διαδρομή προς το αρχείο άδειας. Κενό σημαίνει μετάβαση στην επόμενη πηγή, μετά αυτόματη αναζήτηση.
LicenseContent"" (κενή συμβολοσειρά)Ακατέργαστο περιεχόμενο άδειας — από μεταβλητή περιβάλλοντος, διαχειριστή μυστικών ή βάση δεδομένων.
LicenseStreamnullΆδεια ως ροή, διαβάζεται μία φορά κατά την εκκίνηση.
ResetLicensefalseΔεσμευμένη σημαία συμβατότητας. Οι τρέχουσες υπηρεσίες .NET 8 διαβάζουν την άδεια κατά τη διάρκεια AddDoconut()· επανεκκινήστε την εφαρμογή μετά την αντικατάσταση μιας άδειας.
MaxConcurrentEditorSessions200Μέγιστος αριθμός ενεργών συνεδριών επεξεργαστή (έγγραφα ανοιχτά με DocOptions.EditMode). Πάνω από αυτό, η λιγότερο πρόσφατα χρησιμοποιημένη αδρανής συνεδρία επεξεργαστή κλείνει. Οι κανονικές συνεδρίες προβολέα δεν μετρώνται. 0 ή μια αρνητική τιμή σημαίνει χωρίς όριο.
EditorSnapshotEveryOps50Με την ενεργοποίηση της διατήρησης επεξεργαστή (AddDoconutEditorPersistence), δημιουργήστε στιγμιότυπο του ενεργού εγγράφου κάθε N καταγεγραμμένες αλλαγές. 0 ή μια αρνητική τιμή δεν δημιουργεί στιγμιότυπα κατά τη διάρκεια της συνεδρίας. Δεν έχει επίδραση όταν η διατήρηση είναι απενεργοποιημένη.

Προτεραιότητα άδειας όταν ορίζονται περισσότερες από μία πηγές: LicenseStream υπερισχύει του LicenseContent, που υπερισχύει του LicensePath, που υπερισχύει της αυτόματης αναζήτησης — δείτε Ρύθμιση Άδειας.

csharp
builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // συντονίστε με τη χαρτογράφηση της εφαρμογής και το BasePath του πελάτη
    options.ResourcesPath   = "/doconut-res"; // από πού εξυπηρετούνται τα JS/CSS/εικόνες του viewer
    options.UnsafeMode      = false;          // διατηρήστε ενεργή την ασφάλεια της συνεδρίας
    options.ShowDoconutInfo = false;
});

Επόμενα βήματα

Ήταν αυτή η σελίδα χρήσιμη;