Вибір правильного Doconut SDK: .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. Правильний вибір, як правило, — це пакет, який безпосередньо відповідає хосту і мінімізує неоднозначність фреймворку для команди, що підтримує застосунок.
Огляд Doconut Viewer SDK — це відправна точка для ознайомлення з можливостями продукту. Використовуйте документацію, специфічну для вашого фреймворку, щоб прийняти рішення про пакет.
Що означають три позначення
.NET 8 і .NET 6 — це цільові платформи застосунків. Веб‑застосунок може орієнтуватися на один із цих рантаймів і вибрати відповідний пакет Doconut.
.NET Standard 2.1 — це інше: він визначає контракт API бібліотеки, який сумісні хости .NET можуть споживати. Doconut 26.8.0 вводить поточне покоління Doconut.NETStandard для застосунків, орієнтованих на .NET Core 3.0 і новіші, включаючи .NET 5‑.NET 8. Він не може бути спожитий .NET Framework.
Це розрізнення допомагає залишатися в рамках рішення. Не обирайте .NET Standard 2.1 лише тому, що звучить загальніше; використовуйте його, коли його контракт підходить саме вашому хосту та структурі рішення.
Практична таблиця вибору
| Ситуація застосунку | Шлях Doconut для оцінки | Чому |
|---|---|---|
| Новий застосунок, орієнтований на .NET 8 | Doconut.NET8 | Пряме відповідність поточній розробці .NET і повний шлях документації .NET 8. |
| Існуючий застосунок, який має залишатися на .NET 6 | Doconut.NET6 | Зберігає цільовий хост, забезпечуючи актуальну ін’єкцію залежностей, проміжне ПЗ, асинхронну сесію та необов’язкову розподілену модель. |
| Сумісний хост 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 спеціалізований пакет є найочевиднішим вибором для оцінки. Сторінка переглядача .NET 8 описує поточну модель, засновану на ін’єкції залежностей, ресурсах, що подаються через проміжне ПЗ, асинхронних сесіях документів та необов’язкових розподілених робочих процесах.
Пряма відповідність рантайму також спрощує роботу з документацією. Встановлення, налаштування, усунення проблем, плагіни та приклади можна оцінювати в межах одного шляху, специфічного для фреймворку.
Перед впровадженням протестуйте формати документів та необов’язкові функції, які дійсно потрібні вашому продукту. Відповідність пакету не замінює рішення на рівні застосунку щодо автентифікації, авторизації, сховища, зберігання, моніторингу та обмежень ресурсів.
Оберіть 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 перед оновленням. Зміна впливає не лише на компіляцію: запуск, життєвий цикл переглядача, маршрутизація ресурсів, відкриття документів, ліцензування, плагіни та розподілене публікування можуть вимагати уваги.
Порівняйте повний вплив на застосунок
Невелика демонстрація концепції має відповісти на більше, ніж «чи встановлюється пакет?». Оцініть:
- Сумісність хоста: Підтвердіть цільову платформу застосунку та кожен проєкт, що посилається на пакет переглядача.
- Покоління інтеграції: Визначте поточну або класичну реєстрацію, створення переглядача та шаблони відкриття документів.
- Покриття документів: Перевірте представницькі PDF, Office, CAD, зображення, електронну пошту або медичні файли, необхідні для продукту.
- Потреби в плагінах: Окремо перевірте можливості Search, Annotation, Converter або DICOM, коли вони входять у робочий процес.
- Операційна модель: Перевірте тривалість сесії, кешування, доставку ресурсів, очистку та будь-який одно- або розподілений дизайн.
- Зусилля оновлення: Відокремте зміни фреймворку від змін Doconut, щоб полегшити діагностику помилок.
- Контроль застосунку: Перевірте доступ, зберігання, утримання та поведінку доставки в оточуючій системі.
Записуйте версію пакету та цільовий фреймворк разом з кожним результатом. Це запобігає помилковому трактуванню успішного тесту для одного шляху SDK як доказу щодо іншого.
Зробіть вибір фреймворку явним
Добра архітектурна нотатка може бути короткою: вкажіть цільову платформу застосунку, обраний пакет Doconut та його версію, потрібні плагіни, модель розгортання та шлях до документації, використаний під час впровадження. Такий запис рішення допомагає майбутнім оновленням починатися з фактів, а не з припущень про назви пакетів.
Для нового розроблення на .NET 8 починайте з спеціального .NET 8 SDK. Для застосунку, що залишатиметься на .NET 6, оцініть оновлений пакет .NET 6. Використовуйте Doconut.NETStandard 26.8.0+, коли контракт .NET Standard 2.1 підходить сумісному хосту, і залишайте застосунки .NET Framework на їхньому спеціальному шляху пакету.
Перегляньте центр документації Doconut та завантажити пробну версію, щоб протестувати обраний шлях у вашому власному застосунку та документах.