Предыдущая интеграция

Используйте этот раздел, когда существующее приложение .NET Standard всё ещё вручную создает Viewer, передаёт параметры в middleware, координирует веб‑ферму через общую папку или копирует скрипты просмотрщика в приложение. Эта архитектура остаётся задокументированной для клиентов, которые не мигрировали.

Версия пакета определяет поколение

Одного идентификатора пакета недостаточно. Оба поколения публикуются как Doconut.NETStandard:

Проверьте версию в файле проекта, файле блокировки или кэшированном .nupkg, прежде чем выбирать руководство. Ссылка на пакет, содержащая только Doconut.NETStandard, не сообщает, к какому API написан код.

Определите предыдущую интеграцию

Приложение использует предыдущую интеграцию, если в нём присутствует одна или несколько из следующих сигнатур:

var viewer = new Viewer(_cache, _accessor);
var viewer = new Viewer(_cache, _accessor, licenseFilePath);

var token = viewer.OpenDocument(path, config, documentOptions);
viewer.InitCache();

appBranch.UseDoconut(new DoconutOptions { UnSafeMode = false, ShowDoconutInfo = false });

appBranch.UseDoconutWebFarm(new WebFarmOptions { Path = sharedFolder });

Viewer.DoconutLicense(licenseStream);
Viewer.SetLicensePlugin(pluginLicenseStream);

var converter = viewer.Converter.GetConverter();

Блок using также является надёжным сигналом — типы конфигурации были распределены по нескольким пространствам имён:

using Doconut.Configs;
using Doconut.Configs.View;
using Doconut.Configs.Cloud;
using Doconut.Models;

На предыдущих страницах также часто загружаются копии, управляемые приложением:

docViewer.js
documentLinks.js
docViewer.UI.js

и объявляют обратные вызовы просмотрщика как глобальные переменные, названные по идентификатору контейнера, например ctlDoc_OnViewerReady().

Текущая интеграция, наоборот, определяется AddDoconut(), UseDoconutResources(), UseDoconut() без аргументов, внедрённым Viewer, OpenDocumentAsync() и упрощённым пространством имён Doconut.

Откройте сохранённое руководство

Переведённое историческое руководство доступно по адресу Унаследованная настройка .NET Standard. Его URL не был перенаправлен или заменён, поскольку он описывает реальное поколение интеграции, которое всё ещё используют существующие приложения.

Не смешивайте фрагменты из того руководства с текущей документацией AddDoconut(). Конструирование Viewer, маршрутизация middleware, лицензии, ресурсы, конвертация, координация веб‑фермы и владение сессией — всё это различно.

Планируйте миграцию

Используйте Миграция на .NET Standard 2.1 для проверенного сопоставления от ручного создания и синхронного открытия документов к DI, текущему middleware, асинхронным сессиям, сгенерированным ресурсам, распределённому публикации и плагинам с ограничением возможностей.

Два момента требуют внимания перед началом:

• Хостовая платформа. netstandard2.1 требует .NET Core 3.0 или новее. Хост на .NET Framework не может использовать текущий пакет вовсе.
• Изменения на клиентской стороне. Два из них завершаются без ошибок — сервер продолжает работать, а консоль браузера остаётся пустой. Они описаны в руководстве по миграции.

Сохраняйте прежнее развертывание до тех пор, пока текущее приложение не пройдёт тесты документа, лицензии, Search, Annotation, Converter, DICOM, безопасности и отката.