Εγκατάσταση

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

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

Απαιτήσεις

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

ΠλατφόρμαΥποστηρίζεται
Windows x64 / x86Ναι
Linux x64, glibc-based (Debian, Ubuntu, the official mcr.microsoft.com/dotnet/aspnet:6.0-bookworm-slim image)Ναι
Alpine and other musl-based distributionsΌχι
macOSΌχι

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

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

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

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

bash
dotnet add package Doconut.NET6

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

bash
dotnet add package Doconut.NET6 --version 26.10.0

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

Αναγνώριση της ενσωμάτωσης πριν από την αναβάθμιση

Το αναγνωριστικό πακέτου Doconut.NET6 έχει χρησιμοποιηθεί τόσο από την κλασική όσο και από την τρέχουσα ενσωμάτωση .NET 6. Μην επιλέγετε τεκμηρίωση μόνο από το όνομα του πακέτου:

  • DocImage.axd, new Viewer(_cache, _accessor, ...), συγχρονισμένα OpenDocument(...), και τα χειροκίνητα αντιγραμμένα σενάρια προβολέα προσδιορίζουν την κλασική ενσωμάτωση;
  • AddDoconut(), UseDoconutResources(), ένα ενσωματωμένο Viewer, και OpenDocumentAsync(...) προσδιορίζουν την τρέχουσα ενσωμάτωση που τεκμηριώνεται εδώ.

Το μεταφρασμένο εγχειρίδιο κλασικής εγκατάστασης παραμένει διαθέσιμο. Χρησιμοποιήστε τον οδηγό μετάβασης για να αλλάξετε γενιές· μια κανονική ενημέρωση πακέτου δεν μετατρέπει αυτόματα την εκκίνηση, τη διάρκεια ζωής του προβολέα ή τους πόρους του προγράμματος περιήγησης.

Καταχώριση του 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"Τιμή συντονισμού για το άκρο page-image. Επικυρώνεται, αλλά δεν δημιουργεί κλάδο από μόνη της· διατηρήστε την ευθυγραμμισμένη με την πραγματική αντιστοίχηση UseDoconut() και τον πελάτη BasePath.
ResourcesPath"/doconut-res"Από πού σερβίρονται οι ενσωματωμένοι πόροι JS/CSS/εικόνας.
LicensePath"" (empty string)Διαδρομή προς το αρχείο άδειας. Κενό σημαίνει μετάβαση στην επόμενη πηγή, έπειτα αυτόματη αναζήτηση.
LicenseContent"" (empty string)Ακατέργαστο περιεχόμενο άδειας — από μεταβλητή περιβάλλοντος, διαχειριστή μυστικών ή βάση δεδομένων.
LicenseStreamnullΆδεια ως ροή, διαβάζεται μία φορά κατά την εκκίνηση.
ResetLicensefalseΚρατημένη σημαία συμβατότητας. Οι τρέχουσες υπηρεσίες .NET 6 διαβάζουν την άδεια κατά τη διάρκεια 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;
});

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

  • Γρήγορη Έναρξη — ανοίξτε το πρώτο σας έγγραφο και αποδώστε το στο πρόγραμμα περιήγησης.
  • Ρύθμιση Άδειας — όπου το Doconut αναζητά το αρχείο άδειας σας.

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