Podstawowa przeglądarka Doconut dla .NET 6 jest dostarczana jako pojedynczy pakiet NuGet, który integruje się z dowolną aplikacją ASP.NET Core. Opcjonalne wtyczki korzystają z oddzielnych pakietów. Ta strona instaluje podstawowy pakiet i rejestruje middleware — minimalne wymagania przed pierwszym renderowaniem.

Zainstaluj pakiet

bash

dotnet add package Doconut.NET6

Polecenie bez wersji instaluje najnowsze stabilne wydanie. Aby dokładnie odtworzyć bieżące wydanie 26.7.0, przekaż wersję jako oddzielną opcję:

bash

dotnet add package Doconut.NET6 --version 26.7.0

Doconut.NET6 jest identyfikatorem pakietu. Przyrostek .26.7.0 należy do pobranego pliku Doconut.NET6.26.7.0.nupkg i nie jest częścią identyfikatora.

Zidentyfikuj integrację przed aktualizacją

Identyfikator pakietu Doconut.NET6 był używany zarówno w klasycznej, jak i bieżącej integracji .NET 6. Nie wybieraj dokumentacji wyłącznie na podstawie nazwy pakietu:

DocImage.axd, new Viewer(_cache, _accessor, ...), synchroniczne OpenDocument(...) oraz ręcznie skopiowane skrypty przeglądarki identyfikują klasyczną integrację;
AddDoconut(), UseDoconutResources(), wstrzyknięty Viewer oraz OpenDocumentAsync(...) identyfikują bieżącą integrację opisaną tutaj.

Przetłumaczona klasyczna instrukcja konfiguracji jest nadal dostępna. Skorzystaj z poradnika migracji, aby zmienić generacje; zwykła aktualizacja pakietu nie konwertuje automatycznie uruchamiania, czasu życia przeglądarki ani zasobów przeglądarki.

Zarejestruj Doconut

AddDoconut() jest jedynym punktem wejścia rejestracji — istnieje tylko jedna przeciążona metoda, która podłącza usługę Viewer, usługę licencji oraz infrastrukturę renderowania do kontenera DI.

Dwa wywołania middleware kończą konfigurację i ich kolejność ma znaczenie: UseDoconutResources() musi zostać wywołane przed UseDoconut(). UseDoconut() jest middleware terminalnym, więc wywołanie go jako pierwszego powoduje, że każde żądanie zasobu /doconut-res nie dociera do obsługi zasobów i kończy się 404. Połączenie sesji jest również wymagane — domyślne zabezpieczenie dokumentu Doconut weryfikuje każde żądanie strony względem stanu sesji ASP.NET.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath = "Doconut.Viewer.lic";
});
builder.Services.AddSession(); // Zabezpieczenie dokumentu Doconut działa na sesji ASP.NET

app.UseSession();          // wywołaj UseSession() przed UseDoconut()
app.UseDoconutResources(); // musi być zarejestrowane przed UseDoconut()
app.UseDoconut();

Wszystkie opcje

DoconutOptions przyjmuje następujące konfigurowalne właściwości. Każda z nich jest opcjonalna — poniższe wartości domyślne mają zastosowanie, gdy właściwość nie zostanie ustawiona.

Właściwość	Domyślnie	Opis
`ShowDoconutInfo`	`false`	Gdy `true`, żądanie bez `token` zwraca baner wersji zamiast 404. Przydatne jako szybka kontrola; wyłącz w środowisku produkcyjnym.
`UnsafeMode`	`false`	Gdy `true`, pomija sprawdzanie bezpieczeństwa sesji ASP.NET przy żądaniach stron. Wyłącz w produkcji.
`MiddlewarePath`	`"/doconut"`	Wartość koordynująca dla punktu końcowego obrazu strony. Jest walidowana, ale nie montuje własnej gałęzi; utrzymuj ją zgodną z rzeczywistym mapowaniem `UseDoconut()` oraz `BasePath` po stronie klienta.
`ResourcesPath`	`"/doconut-res"`	Miejsce, z którego serwowane są osadzone zasoby JS/CSS/obrazki.
`LicensePath`	`""` (empty string)	Ścieżka do pliku licencji. Pusty ciąg oznacza przejście do następnego źródła, a następnie automatyczne wyszukiwanie.
`LicenseContent`	`""` (empty string)	Surowa zawartość licencji — z zmiennej środowiskowej, menedżera sekretów lub bazy danych.
`LicenseStream`	`null`	Licencja jako strumień, odczytywana raz przy uruchomieniu.
`ResetLicense`	`false`	Zarezerwowany znacznik kompatybilności. Aktualne usługi .NET 6 odczytują licencję podczas `AddDoconut()`; po wymianie licencji uruchom aplikację ponownie.

Priorytet źródeł licencji, gdy ustawiono więcej niż jedno: LicenseStream ma pierwszeństwo przed LicenseContent, które ma pierwszeństwo przed LicensePath, które ma pierwszeństwo przed automatycznym wyszukiwaniem — zobacz Ustawienia licencji.

csharp

builder.Services.AddDoconut(options =>
{
    options.LicensePath     = "Doconut.Viewer.lic";
    options.MiddlewarePath  = "/doconut";     // koordynuj z mapowaniem aplikacji i BasePath klienta
    options.ResourcesPath   = "/doconut-res"; // gdzie serwowane są zasoby JS/CSS/obrazy przeglądarki
    options.UnsafeMode      = false;          // zachowaj włączone zabezpieczenie sesji
    options.ShowDoconutInfo = false;
});

Kolejne kroki

Szybki start — otwórz swój pierwszy dokument i wyświetl go w przeglądarce.
Ustawienia licencji — gdzie Doconut szuka pliku licencji.