Εγκατάσταση
Προσθέστε το Doconut στο .NET Standard 2.1 έργο σας
Ο βασικός προβολέας Doconut για .NET Standard διανέμεται ως ένα πακέτο NuGet που ενσωματώνεται σε οποιαδήποτε εφαρμογή ASP.NET Core. Τα προαιρετικά πρόσθετα χρησιμοποιούν ξεχωριστά πακέτα. Αυτή η σελίδα εγκαθιστά το βασικό πακέτο, επιβεβαιώνει ότι ο κεντρικός υπολογιστής σας μπορεί να το καταναλώσει, και καταχωρίζει το middleware — το ελάχιστο που απαιτείται πριν από την πρώτη σας απόδοση.
Ελέγξτε πρώτα το πλαίσιο του κεντρικού υπολογιστή
Η βιβλιοθήκη στοχεύει στο netstandard2.1. Αυτό είναι ένα πιο περιορισμένο συμβόλαιο από την προηγούμενη έκδοση netstandard2.0, και είναι το πρώτο πράγμα που πρέπει να επαληθευτεί:
| Κεντρικός υπολογιστής | Υποστηρίζεται |
|---|---|
| .NET Core 3.0 ή νεότερο, συμπεριλαμβανομένων των .NET 5/6/7/8 | Ναι |
| .NET Framework (οποιαδήποτε έκδοση) | Όχι — netstandard2.1 δεν μπορεί να καταναλωθεί από .NET Framework |
Το πακέτο λειτουργεί μόνο σε Windows. Για κεντρικό υπολογιστή Linux, χρησιμοποιήστε Doconut.NET8 ή Doconut.NET6.
Εάν η εφαρμογή εκτελείται σε .NET Framework, αυτό δεν είναι το σωστό πακέτο. Χρησιμοποιήστε το Doconut.NETFramework αντ' αυτού· από την έκδοση 26.9.0 απαιτεί .NET Framework 4.7.2.
Εγκατάσταση του πακέτου
dotnet add package Doconut.NETStandardΗ εντολή χωρίς έκδοση εγκαθιστά την πιο πρόσφατη σταθερή έκδοση. Για να κλειδώσετε την έκδοση που περιγράφει αυτή η τεκμηρίωση, περάστε την έκδοση ως ξεχωριστή επιλογή:
dotnet add package Doconut.NETStandard --version 26.10.0Doconut.NETStandard είναι το αναγνωριστικό του πακέτου. Το επίθημα έκδοσης ανήκει στο ληφθέν Doconut.NETStandard.<version>.nupkg όνομα αρχείου και δεν αποτελεί μέρος του αναγνωριστικού.
Ο αριθμός έκδοσης είναι η γενιά
Αυτό έχει μεγαλύτερη σημασία εδώ από το όνομα του πακέτου. Και οι δύο γενιές της βιβλιοθήκης .NET Standard δημοσιεύονται κάτω από το ίδιο αναγνωριστικό πακέτου, και μόνο η έκδοση τις διακρίνει:
| Έκδοση | Στόχος | API |
|---|---|---|
| 26.7.0 και κάτω | netstandard2.0 | η προηγούμενη ενσωμάτωση |
| 26.8.0 και πάνω | netstandard2.1 | η ενσωμάτωση που τεκμηριώνεται εδώ |
Δεν υπάρχει shim συμβατότητας και δεν υπάρχει πακέτο παράλληλης εγκατάστασης. Η αύξηση της έκδοσης είναι η αναβάθμιση, και ο μεταγλωττιστής θα αναφέρει αμέσως τις διαφορές API.
Μην επιλέγετε τεκμηρίωση μόνο από το όνομα του πακέτου:
new Viewer(_cache, _accessor, …),UnSafeMode, synchronousOpenDocument(...),viewer.InitCache(),UseDoconutWebFarm, και τα χειροκίνητα αντιγραμμένα σενάρια προβολέα προσδιορίζουν την προηγούμενη ενσωμάτωση;AddDoconut(),UseDoconutResources(), ένα ενσωματωμένοViewer, καιOpenDocumentAsync(...)προσδιορίζουν την τρέχουσα ενσωμάτωση που τεκμηριώνεται εδώ.
Το μεταφρασμένο προηγούμενο εγχειρίδιο εγκατάστασης παραμένει διαθέσιμο. Χρησιμοποιήστε τον οδηγό μετάβασης για να αλλάξετε γενιές· μια ενημέρωση πακέτου δεν μετατρέπει αυτόματα την εκκίνηση, τη διάρκεια ζωής του προβολέα ή τους πόρους του προγράμματος περιήγησης.
Καταχώρηση του Doconut
AddDoconut() είναι το μοναδικό σημείο εισόδου καταχώρησης — υπάρχει μία μόνο υπερφόρτωση, και συνδέει την υπηρεσία Viewer, την υπηρεσία άδειας, και την υποδομή απόδοσης στο DI container.
Δύο κλήσεις middleware ολοκληρώνουν τη ρύθμιση, και η σειρά τους έχει σημασία: UseDoconutResources() πρέπει να εκτελείται πριν από UseDoconut(). UseDoconut() είναι τελικό middleware, έτσι η κλήση του πρώτα σημαίνει ότι κάθε αίτημα σε ένα περιουσιακό στοιχείο /doconut-res δεν φτάνει ποτέ στον διαχειριστή πόρων και επιστρέφει 404. UseDoconut() απαντά σε κάθε αίτημα που το φθάνει, έτσι τοποθετήστε το σε ξεχωριστό κλάδο με app.Map. Η σύνδεση της συνεδρίας απαιτείται επίσης — η προεπιλεγμένη ασφάλεια εγγράφων του Doconut επικυρώνει κάθε αίτημα σελίδας έναντι της κατάστασης συνεδρίας ASP.NET.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // Το session state χρειάζεται μια cache (MVC/Razor Pages ήδη προσθέτουν μία)
builder.Services.AddSession(); // Η ασφάλεια εγγράφων Doconut βασίζεται στο ASP.NET session state
app.UseSession(); // Καλέστε το UseSession() πριν το UseDoconut()
app.UseDoconutResources(); // Πρέπει να εγγραφεί πριν το UseDoconut()
app.Map("/doconut", branch => branch.UseDoconut());Χώροι ονομάτων
Οι τύποι διαμόρφωσης δεν διασπείρονται πλέον σε τέσσερις χώρους ονομάτων. Σε αυτήν την έκδοση σχεδόν όλα ζουν στον ριζικό χώρο ονομάτων Doconut:
using Doconut; // Viewer, DoconutOptions, DocOptions, όλες οι ρυθμίσεις μορφής
using Doconut.Middleware; // AddDoconut, UseDoconut, UseDoconutResources
using Doconut.Clouds; // ρυθμίσεις cloud και file-share
using Doconut.Configs.Conversion; // ConversionTargetΤα ίδια τα ονόματα τύπων δεν άλλαξαν — PdfConfig, WordConfig, ExcelConfig, CssConfig, ScriptConfig και τα υπόλοιπα είναι ακόμη εκεί. Εάν μετακινείτε μια υπάρχουσα εφαρμογή, τα περισσότερα αρχεία χρειάζονται μόνο δύο διαγραμμένες γραμμές using· δείτε τον οδηγό μετάβασης.
Όλες οι επιλογές
DoconutOptions δέχεται τις ακόλουθες ρυθμιζόμενες ιδιότητες. Κάθε μία είναι προαιρετική — οι προεπιλογές παρακάτω ισχύουν όταν μια ιδιότητα παραμείνει ακαθορισμένη.
| Ιδιότητα | Προεπιλογή | Περιγραφή |
|---|---|---|
ShowDoconutInfo | false | Όταν true, ένα αίτημα χωρίς token επιστρέφει μια ετικέτα έκδοσης αντί για 404. Χρήσιμο ως έλεγχος καπνού· αφαιρέστε το στην παραγωγή. |
UnsafeMode | false | Όταν true, παραλείπει τον έλεγχο ασφαλείας ASP.NET-session στα αιτήματα σελίδας. Αφαιρέστε το στην παραγωγή. Σημειώστε την ορθογραφία — η προηγούμενη βιβλιοθήκη το ονόμαζε UnSafeMode. |
MiddlewarePath | "/doconut" | Τιμή συντονισμού για το άκρο page-image. Επικυρώνεται, αλλά δεν δημιουργεί κλάδο από μόνη της· διατηρήστε την ευθυγραμμισμένη με την πραγματική αντιστοίχιση UseDoconut() και τον πελάτη BasePath. |
ResourcesPath | "/doconut-res" | Από πού σερβίρονται οι ενσωματωμένοι πόροι JS/CSS/εικόνας. |
LicensePath | "" (empty string) | Διαδρομή προς το αρχείο άδειας. Κενό σημαίνει μετάβαση στην επόμενη πηγή, έπειτα αυτόματη αναζήτηση. |
LicenseContent | "" (empty string) | Ακατέργαστο περιεχόμενο άδειας — από μεταβλητή περιβάλλοντος, διαχειριστή μυστικών ή βάση δεδομένων. |
LicenseStream | null | Άδεια ως ροή, διαβάζεται μία φορά κατά την εκκίνηση. |
ResetLicense | false | Δεσμευμένη σημαία συμβατότητας. Η άδεια διαβάζεται κατά τη διάρκεια AddDoconut()· επανεκκινήστε την εφαρμογή μετά την αντικατάσταση άδειας. |
MaxConcurrentEditorSessions | 200 | Μέγιστος αριθμός ενεργών συνεδριών επεξεργαστή (έγγραφα ανοιγμένα με DocOptions.EditMode). Πάνω από αυτό, η λιγότερο πρόσφατα χρησιμοποιημένη αδρανής συνεδρία επεξεργαστή κλείνει. Οι κανονικές συνεδρίες προβολέα δεν μετρώνται ποτέ. 0 ή μια αρνητική τιμή σημαίνει χωρίς όριο. |
EditorSnapshotEveryOps | 50 | Με ενεργοποιημένη τη διατήρηση επεξεργαστή (AddDoconutEditorPersistence), δημιουργήστε στιγμιότυπο του ζωντανού εγγράφου κάθε N καταγεγραμμένες αλλαγές. 0 ή μια αρνητική τιμή δεν δημιουργεί ποτέ στιγμιότυπα κατά τη διάρκεια της συνεδρίας. Δεν έχει αποτέλεσμα όταν η διατήρηση είναι απενεργοποιημένη. |
Προτεραιότητα άδειας όταν ορίζονται περισσότερες από μία πηγές: LicenseStream υπερισχύει του LicenseContent, υπερισχύει του LicensePath, υπερισχύει της αυτόματης αναζήτησης — δείτε το Ρύθμιση Άδειας.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.MiddlewarePath = "/doconut"; // συντονίστε με την αντιστοίχηση εφαρμογής και το BasePath του πελάτη
options.ResourcesPath = "/doconut-res"; // από πού σερβίρονται τα JS/CSS/εικόνες του viewer
options.UnsafeMode = false; // διατηρήστε το session security ενεργό
options.ShowDoconutInfo = false;
});Επόμενα βήματα
- Γρήγορη Εκκίνηση — ανοίξτε το πρώτο σας έγγραφο και αποδώστε το στο πρόγραμμα περιήγησης.
- Ρύθμιση Άδειας — όπου το Doconut αναζητά το αρχείο άδειας σας.
Ήταν αυτή η σελίδα χρήσιμη;