Wybór odpowiedniego Doconut SDK: .NET Standard 2.1, .NET 6 lub .NET 8
Zacznij od hosta aplikacji
Wybór pakietu Doconut zaczyna się od projektu, który go uruchomi. Nowa aplikacja internetowa .NET 8, ustalona usługa .NET 6 oraz host ASP.NET Core kompatybilny z biblioteką mogą wszystkie wymagać wbudowanego przeglądania dokumentów, ale ich ograniczenia frameworka i plany aktualizacji różnią się.
Doconut oferuje aktualne ścieżki SDK dla .NET 8, .NET 6 oraz kompatybilnych hostów, które konsumują nowy pakiet .NET Standard 2.1. Odpowiedni wybór to zazwyczaj pakiet, który bezpośrednio pasuje do hosta i pozostawia jak najmniej niejasności frameworkowych dla zespołu utrzymującego aplikację.
Przegląd SDK przeglądarki Doconut jest punktem wyjścia do możliwości produktu. Skorzystaj z dokumentacji specyficznej dla frameworka, aby podjąć decyzję o pakiecie.
Zrozum, co oznaczają trzy etykiety
.NET 8 i .NET 6 są celami aplikacji. Aplikacja internetowa może celować w jeden z tych środowisk uruchomieniowych i wybrać pasujący pakiet Doconut.
.NET Standard 2.1 jest inny: definiuje kontrakt API biblioteki, który kompatybilne hosty .NET mogą konsumować. Doconut 26.8.0 wprowadza bieżącą generację Doconut.NETStandard dla aplikacji celujących w .NET Core 3.0 lub nowszy, w tym .NET 5 do .NET 8. Nie może być konsumowany przez .NET Framework.
Ta rozróżnienie utrzymuje decyzję w rzeczywistości. Nie wybieraj .NET Standard 2.1, ponieważ brzmi bardziej ogólnie; wybierz go, gdy jego kontrakt jest odpowiedni dla hosta i struktury rozwiązania.
Praktyczna tabela wyboru
| Sytuacja aplikacji | Ścieżka Doconut do oceny | Powód |
|---|---|---|
| Nowa aplikacja celująca w .NET 8 | Doconut.NET8 | Bezpośrednie dopasowanie do bieżącego rozwoju .NET i pełna ścieżka dokumentacji .NET 8. |
| Istniejąca aplikacja, która musi pozostać na .NET 6 | Doconut.NET6 | Utrzymuje docelowy host, zapewniając bieżącą wstrzykiwanie zależności, middleware, sesję asynchroniczną i opcjonalny model rozproszony. |
| Kompatybilny host ASP.NET Core, gdzie wymagany jest kontrakt .NET Standard | Doconut.NETStandard 26.8.0+ | Celuje w .NET Standard 2.1 i udostępnia bieżącą integrację Doconut dla obsługiwanych hostów. |
| Istniejąca integracja Doconut.NETStandard 26.7.0 lub wcześniejsza | Zaplanować migrację przed wyborem 26.8.0+ | Identyfikator pakietu pozostaje ten sam, ale zmienia się docelowa wersja i generacja API. |
| Aplikacja celująca w .NET Framework | Doconut.NETFramework | .NET Framework nie może konsumować .NET Standard 2.1. |
Ta tabela zawęża pierwszą decyzję. Licencjonowanie, opcjonalne wtyczki, formaty dokumentów, projekt wdrożenia i wysiłek aktualizacji nadal wymagają oddzielnej weryfikacji.
Wybierz Doconut.NET8 dla nowych aplikacji .NET 8
Dla nowej aplikacji .NET 8 dedykowany pakiet jest najjaśniejszym wyborem do oceny. Strona przeglądarki .NET 8 opisuje bieżący model oparty na wstrzykiwaniu zależności, zasobach serwowanych przez middleware, asynchronicznych sesjach dokumentów oraz opcjonalnych przepływach pracy rozproszonych.
Bezpośrednie dopasowanie środowiska uruchomieniowego również ułatwia śledzenie dokumentacji. Instalacja, konfiguracja, rozwiązywanie problemów, wtyczki i przykłady mogą być oceniane w jednej ścieżce specyficznej dla frameworka.
Przed przyjęciem przetestuj formaty dokumentów i opcjonalne funkcje, których produkt faktycznie potrzebuje. Dopasowanie pakietu nie zastępuje decyzji na poziomie aplikacji dotyczących uwierzytelniania, autoryzacji, przechowywania, retencji, monitorowania i limitów zasobów.
Wybierz Doconut.NET6, gdy host musi pozostać na .NET 6
Ustalona aplikacja może mieć zależności lub zobowiązania wsparcia, które utrzymują ją na .NET 6. Zaktualizowany .NET 6 Viewer pozwala aplikacji zachować ten cel, jednocześnie przechodząc na bieżącą architekturę integracji Doconut.
Jest to przydatne, gdy aktualizacja środowiska uruchomieniowego i migracja przeglądarki dokumentów nie powinny odbywać się w tym samym wydaniu. Zespół może modernizować rejestrację przeglądarki, dostarczanie zasobów, asynchroniczne otwieranie oraz sesje dokumentów, zachowując stabilność frameworka hosta.
Sprawdź, czy istniejący projekt używa klasycznej, czy zaktualizowanej integracji Doconut .NET 6. Same nazwy pakietów mogą nie ujawniać generacji. Oficjalna dokumentacja migracji identyfikuje sygnatury API i wzorce hostowania, które je odróżniają.
Wybierz Doconut.NETStandard, gdy kontrakt pasuje do rozwiązania
Nowy przewodnik instalacji .NET Standard 2.1 definiuje granicę kompatybilności. Obsługuje hosty .NET Core 3.0 i nowsze, w tym .NET 5, 6, 7 i 8, oraz wyklucza .NET Framework.
Ta ścieżka ma sens, gdy rozwiązanie wymaga konkretnie kontraktu biblioteki .NET Standard. Wybór wersji jest kluczowy: Doconut.NETStandard 26.7.0 i wcześniejsze celują w .NET Standard 2.0 i używają poprzedniej integracji, natomiast 26.8.0 i późniejsze celują w .NET Standard 2.1 z bieżącym API.
Jeśli aplikacja już używa starszej generacji pakietu, skonsultuj się z przewodnikiem migracji .NET Standard przed aktualizacją. Zmiana wpływa na więcej niż kompilację: uruchamianie, żywotność przeglądarki, routowanie zasobów, otwieranie dokumentów, licencjonowanie, wtyczki i publikację rozproszoną, które mogą wymagać uwagi.
Porównaj pełny wpływ na aplikację
Mały dowód koncepcji powinien odpowiedzieć na więcej niż „czy pakiet się instaluje?”. Oceń:
- Kompatybilność hosta: Potwierdź docelowy framework aplikacji oraz każdy projekt, który odwołuje się do pakietu przeglądarki.
- Generacja integracji: Zidentyfikuj bieżącą lub klasyczną rejestrację, tworzenie przeglądarki i wzorce otwierania dokumentów.
- Zakres dokumentów: Przetestuj reprezentatywne pliki PDF, Office, CAD, obrazy, e‑maile lub pliki medyczne wymagane przez produkt.
- Potrzeby wtyczek: Zweryfikuj indywidualnie możliwości Search, Annotation, Converter lub DICOM, gdy są częścią przepływu pracy.
- Model operacyjny: Przetestuj czas życia sesji, buforowanie, dostarczanie zasobów, czyszczenie oraz każdy projekt jednowęzłowy lub rozproszony.
- Wysiłek aktualizacji: Oddziel zmiany frameworka od zmian Doconut, aby usterki były łatwiejsze do diagnozy.
- Kontrole aplikacji: Zweryfikuj dostęp, przechowywanie, retencję i zachowanie dostarczania w otaczającym systemie.
Zapisz wersję pakietu i docelowy framework wraz z każdym wynikiem. Zapobiega to myleniu udanego testu jednej ścieżki SDK z dowodem dotyczącym innej.
Uczyń wybór frameworka wyraźnym
Dobra notatka architektoniczna może być krótka: określ docelowy framework aplikacji, wybrany pakiet Doconut i wersję, wymagane wtyczki, model wdrożenia oraz ścieżkę dokumentacji używaną podczas implementacji. Ten zapis decyzji pomaga późniejszym aktualizacjom opierać się na faktach, a nie na założeniach dotyczących nazw pakietów.
Dla nowego rozwoju .NET 8 rozpocznij od dedykowanego SDK .NET 8. Dla aplikacji pozostającej na .NET 6 oceń zaktualizowany pakiet .NET 6. Użyj Doconut.NETStandard 26.8.0+, gdy kontrakt .NET Standard 2.1 jest odpowiedni dla kompatybilnego hosta, i utrzymuj aplikacje .NET Framework na ich dedykowanej ścieżce pakietu.
Przejrzyj centrum dokumentacji Doconut oraz pobierz wersję próbną, aby przetestować wybraną ścieżkę w swojej aplikacji i dokumentach.