Выбор правильного SDK Doconut: .NET Standard 2.1, .NET 6 или .NET 8
Начните с хоста приложения
Выбор пакета Doconut начинается с проекта, который будет его запускать. Новый веб‑приложение на .NET 8, устоявшийся сервис на .NET 6 и хост ASP.NET Core, совместимый с библиотеками, могут все требовать встроенного просмотра документов, но их ограничения фреймворка и планы обновления различаются.
Doconut предлагает текущие пути SDK для .NET 8, .NET 6 и совместимых хостов, использующих новый пакет .NET Standard 2.1. Правильный выбор обычно представляет собой пакет, который напрямую соответствует хосту и оставляет минимум неоднозначности фреймворка для команды, поддерживающей приложение.
Обзор SDK Doconut Viewer — отправная точка для возможностей продукта. Используйте документацию, специфичную для фреймворка, чтобы принять решение о пакете.
Поймите, что означают три метки
.NET 8 и .NET 6 — это целевые платформы приложений. Веб‑приложение может быть нацелено на один из этих рантаймов и выбрать соответствующий пакет Doconut.
.NET Standard 2.1 отличается: он определяет контракт API библиотеки, который совместимые хосты .NET могут использовать. Doconut 26.8.0 вводит текущую генерацию Doconut.NETStandard для приложений, нацеленных на .NET Core 3.0 и новее, включая .NET 5‑8. Он не может быть использован в .NET Framework.
Это различие делает решение более обоснованным. Не выбирайте .NET Standard 2.1 только потому, что он звучит более общо; выбирайте его, когда его контракт действительно подходит для хоста и структуры решения.
Практическая таблица выбора
| Ситуация применения | Путь Doconut для оценки | Почему |
|---|---|---|
| Новое приложение, нацеленное на .NET 8 | Doconut.NET8 | Прямое соответствие текущей разработке на .NET и полному пути документации .NET 8. |
| Существующее приложение, которое должно оставаться на .NET 6 | Doconut.NET6 | Сохраняет целевой хост, предоставляя текущие внедрение зависимостей, middleware, асинхронные сессии и опциональную распределённую модель. |
| Совместимый хост ASP.NET Core, где требуется контракт .NET Standard | Doconut.NETStandard 26.8.0+ | Нацелен на .NET Standard 2.1 и предоставляет текущую интеграцию Doconut для поддерживаемых хостов. |
| Существующая интеграция Doconut.NETStandard 26.7.0 или более ранней | Планировать миграцию перед выбором 26.8.0+ | Идентификатор пакета остаётся тем же, но меняются цель и поколение API. |
| Приложение, нацеленное на .NET Framework | Doconut.NETFramework | .NET Framework не может использовать .NET Standard 2.1. |
Эта таблица сужает первое решение. Лицензирование, опциональные плагины, форматы документов, дизайн развертывания и усилия по обновлению всё ещё требуют отдельной проверки.
Выберите Doconut.NET8 для новых приложений на .NET 8
Для нового приложения на .NET 8 выделенный пакет является самым очевидным выбором для оценки. Страница Viewer .NET 8 описывает текущую модель, основанную на внедрении зависимостей, ресурсах, обслуживаемых middleware, асинхронных сессиях документов и опциональных распределённых рабочих процессах.
Прямое соответствие рантайма также упрощает работу с документацией. Установка, конфигурация, устранение неполадок, плагины и примеры могут быть оценены в рамках одного пути, специфичного для фреймворка.
Перед внедрением протестируйте форматы документов и опциональные функции, действительно необходимые продукту. Соответствие пакета не заменяет решения уровня приложения о аутентификации, авторизации, хранении, удержании, мониторинге и ограничениях ресурсов.
Выберите Doconut.NET6, когда хост должен оставаться на .NET 6
Установленное приложение может иметь зависимости или обязательства по поддержке, которые удерживают его на .NET 6. Обновлённый .NET 6 Viewer позволяет приложению сохранить эту цель, переходя к текущей архитектуре интеграции Doconut.
Это полезно, когда обновление среды выполнения и миграция просмотрщика документов не должны происходить в одном выпуске. Команда может модернизировать регистрацию просмотрщика, доставку ресурсов, асинхронное открытие и сеансы документов, при этом оставляя фреймворк хоста стабильным.
Проверьте, использует ли существующий проект классическую или обновлённую интеграцию Doconut .NET 6. Одних только названий пакетов может быть недостаточно, чтобы определить поколение. Официальная документация по миграции описывает сигнатуры API и шаблоны хостинга, которые их различают.
Выберите Doconut.NETStandard, когда контракт подходит решению
Новое Руководство по установке .NET Standard 2.1 определяет границы совместимости. Оно поддерживает хосты .NET Core 3.0 и новее, включая .NET 5, 6, 7 и 8, и исключает .NET Framework.
Этот путь имеет смысл, когда решение явно требует контракта библиотеки .NET Standard. Выбор версии критичен: Doconut.NETStandard 26.7.0 и более ранние ориентированы на .NET Standard 2.0 и используют прежнюю интеграцию, тогда как 26.8.0 и новее ориентированы на .NET Standard 2.1 с текущим API.
Если приложение уже использует более старое поколение пакета, обратитесь к Руководству по миграции .NET Standard перед обновлением. Изменения затрагивают не только компиляцию: старт приложения, жизненный цикл просмотрщика, маршрутизацию ресурсов, открытие документов, лицензирование, плагины и распределённую публикацию — всё это может потребовать внимания.
Сравните полное влияние на приложение
Небольшой прототип должен ответить на больше вопросов, чем просто «устанавливается ли пакет?». Оцените:
- Совместимость хоста: Подтвердите цель приложения и каждый проект, который ссылается на пакет viewer.
- Поколение интеграции: Определите, используется ли текущая или классическая регистрация, создание просмотрщика и шаблоны открытия документов.
- Покрытие документов: Протестируйте представительные файлы PDF, Office, CAD, изображения, электронную почту или медицинские файлы, необходимые продукту.
- Требования к плагинам: Проверьте возможности Search, Annotation, Converter или DICOM по отдельности, когда они входят в рабочий процесс.
- Операционная модель: Проверьте время жизни сеанса, кэширование, доставку ресурсов, очистку и любой одноузловой или распределённый дизайн.
- Затраты на обновление: Разделите изменения фреймворка и изменения Doconut, чтобы ошибки было легче диагностировать.
- Контроль приложения: Проверьте доступ, хранение, удержание и поведение доставки в окружающей системе.
Запишите версию пакета и целевой фреймворк рядом с каждым результатом. Это предотвратит ошибочное восприятие успешного теста одного пути SDK как доказательства для другого.
Сделайте выбор фреймворка явным
Хорошая заметка по архитектуре может быть краткой: укажите цель приложения, выбранный пакет Doconut и его версию, требуемые плагины, модель развертывания и путь к документации, использованный при реализации. Такая запись решения помогает будущим обновлениям начинаться с фактов, а не с предположений о названии пакета.
Для новой разработки под .NET 8 начинайте с выделенного SDK .NET 8. Для приложения, остающегося на .NET 6, оцените обновлённый пакет .NET 6. Используйте Doconut.NETStandard 26.8.0+, когда контракт .NET Standard 2.1 подходит совместимому хосту, а приложения на .NET Framework держите на их выделенном пути пакета.
Изучите центр документации Doconut и скачать пробную версию, чтобы протестировать выбранный путь в своём приложении и с вашими документами.