Миграция на .NET Standard 2.1

Переместить существующее приложение Doconut.NETStandard с версии 26.7.0 на 26.8.0

Doconut имеет две отдельные интеграции .NET Standard. Они используют одно и то же имя пакета Doconut.NETStandard, поэтому определите поколение по версии и API в приложении, прежде чем менять пакеты, запуск, лицензии или ресурсы браузера.

Версия — развилка

ВерсияЦельAPI
26.7.0 и нижеnetstandard2.0предыдущий API
26.8.0 и вышеnetstandard2.1текущий API

Повышение номера версии — это обновление. Отдельного пакета для установки нет и нет совместимого shim — 26.8.0 имеет другую поверхность API. Ожидайте ошибки компиляции после повышения; остальная часть этого руководства — список этих ошибок.

Какую интеграцию вы используете?

Если проект содержит…Поколение
new Viewer(_cache, _accessor, ...)Предыдущее
viewer.OpenDocument(...) (синхронный)Предыдущее
viewer.InitCache()Предыдущее
UseDoconut(new DoconutOptions { ... })Предыдущее
UseDoconutWebFarm(...) / WebFarmOptionsПредыдущее
Viewer.DoconutLicense(...) или Viewer.SetLicensePlugin(...)Предыдущее
viewer.Converter.GetConverter()Предыдущее
using Doconut.Configs; / using Doconut.Models;Предыдущее
Вручную скопированные docViewer.js, documentLinks.js, или docViewer.UI.jsПредыдущее
builder.Services.AddDoconut(...)Текущее
app.UseDoconutResources() плюс app.UseDoconut() без аргументовТекущее
Viewer supplied by dependency injectionТекущее
await viewer.OpenDocumentAsync(...)Текущее

Если обе колонки присутствуют в одном приложении, рассматривайте миграцию как незавершённую. Не отправляйте токен документа через ресурсы или middleware из другого поколения.

Сначала проверьте хост‑фреймворк

Это жёсткое ограничение, а не предпочтение. Текущий пакет нацелен на netstandard2.1:

ХостМожет использовать 26.8.0
.NET Core 3.0 или новее (включая .NET 5/6/7/8)Да
.NET Framework, любой версииНет

.NET Framework не может ссылаться на библиотеку netstandard2.1. Если приложение работает на .NET Framework, остановитесь здесь и используйте пакет Doconut.NETFramework вместо него; начиная с 26.9.0 он требует .NET Framework 4.7.2. Оба референтных приложения для этого выпуска нацелены на net8.0.

Прежде чем мигрировать

  1. Создайте ветку и развертываемую резервную копию существующего приложения.
  2. Запишите точные версии основных и плагин‑пакетов.
  3. Составьте инвентарь каждого вызова new Viewer(...), вызова InitCache(), вызова загрузки лицензии, сопоставления UseDoconutWebFarm, контроллера конверсии, скопированного скрипта Doconut, пользовательского действия панели инструментов, viewer callback и конечной точки открытия документа.
  4. Сохраните текущие файлы .lic и секреты развертывания вне системы контроля версий.
  5. Соберите репрезентативный набор PDF, Office, изображений, CAD, email, DICOM, документов с возможностью поиска, защищённых паролем и аннотированных.
  6. Запишите текущие параметры таймаута сессии, поведения безопасности, шрифтов и настроек платформы.

Перенесите одну среду перед изменением продакшна. Текущая интеграция меняет время жизни сервисов, маршрутизацию запросов, владение сессией, доставку клиентских ресурсов и — если вы используете ферму — способ доставки страниц в браузер.

1. Пространства имён: почти всё перемещено в корень

Типы конфигурации были распределены по четырём пространствам имён. Теперь они все находятся в Doconut.

РаньшеСейчас
using Doconut.Configs.View;using Doconut;
using Doconut.Models;using Doconut;
using Doconut.Configs;using Doconut;
using Doconut.Configs.Cloud;using Doconut.Clouds;
using Doconut.Configs.Conversion;не изменено
using Doconut.Middleware;не изменено

Имена типов не изменились: WordConfig, PdfConfig, ExcelConfig, CssConfig, ScriptConfig, CloudUploadConfig, AzureConfig, CDNConfig, FileShareConfig, а остальные всё ещё присутствуют. В большинстве файлов единственное изменение — удаление двух строк using.

Doconut.Configs.Editor (BaseConfigEditor, PdfConfigEditor) был удалён и не имеет замены в этом пакете. Если ваше приложение ссылалось на эти типы, планируйте эту часть отдельно и не рассматривайте её как часть этой миграции.

2. Совместимость пакетов и лицензий

Заменяйте или обновляйте основной пакет намеренно; не полагайтесь на идентичный идентификатор пакета при выборе нового API. Команда по умолчанию устанавливает последнюю стабильную версию:

bash
dotnet add package Doconut.NETStandard

Для воспроизводимой миграции к версии, проверенной в этом руководстве, передайте номер версии как отдельный параметр:

bash
dotnet add package Doconut.NETStandard --version 26.9.0

Поддерживайте каждый плагин Doconut на той же версии, что и основной пакет — Doconut.NETStandard.Converter и Doconut.NETStandard.Dicom. Текущая интеграция загружает лицензии один раз во время AddDoconut(), используя следующий приоритет:

text
LicenseStream > LicenseContent > LicensePath > automatic discovery

Автоматическое обнаружение ищет Doconut.Viewer.lic и сопутствующие файлы Doconut.Viewer.<Capability>.lic. Предыдущие статические вызовы Viewer.DoconutLicense(...) и Viewer.SetLicensePlugin(...) больше не являются механизмом запуска, также как и List<string> путей лицензий, которые принимал старый конструктор Viewer. Переместите лицензию в DoconutOptions, держите сопутствующие файлы вместе при использовании автоматического обнаружения, перезапустите приложение после изменения лицензии и проверьте возможности через IDoconutLicenseService.

Не полагайтесь на то, что наличие старой лицензии плагина подтверждает право на текущую сборку плагина. Тестируйте Viewer, Search, Annotation, Converter и DICOM отдельно, используя утверждённые артефакты релиза.

3. Запуск и внедрение зависимостей

Ранее Viewer создавался для каждого запроса, а параметры передавались в промежуточное ПО:

csharp
// Предыдущая интеграция — только для сравнения; не компилируйте это с текущим SDK.
var viewer = new Viewer(_cache, _accessor);
// …
appBranch.UseDoconut(new DoconutOptions { UnSafeMode = false, ShowDoconutInfo = false });

Текущая интеграция регистрирует Doconut один раз и получает Viewer через внедрение зависимостей:

csharp
builder.Services.AddDoconut(options =>
{
    options.UnsafeMode      = false;   // обратите внимание на изменение написания: UnSafeMode → UnsafeMode
    options.ShowDoconutInfo = false;
    options.LicensePath     = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // состоянию сессии нужен кэш (MVC/Razor Pages уже добавляют его)
builder.Services.AddSession();

app.UseSession();
app.UseDoconutResources();
app.UseDoconut();

Viewer является временным сервисом. Менеджер сессий документа и его кэш владеют более длительным состоянием документа, а не конкретным внедрённым экземпляром Viewer.

Три вещи, которые следует перенести:

  • new Viewer(cache, accessor) удалён. Внедрите Doconut.Viewer в ваш контроллер или используйте @inject Doconut.Viewer Viewer в Razor‑view.
  • UseDoconutResources() заменяет ручную проводку app.UseMiddleware<EmbeddedResourceMiddleware>() и должен выполняться до ветки документа.
  • UnSafeMode → UnsafeMode. Переименование на один символ, которое поймает компилятор.

Когда UnsafeMode находится в состоянии false, SDK проверяет токен сессии относительно исходного запроса, поэтому AddSession() / UseSession() всё ещё должны находиться в конвейере, UseSession() перед веткой.

Методы, которые больше не существуют

BeforeNow
viewer.OpenDocument(path, config, options)await viewer.OpenDocumentAsync(path, config, options)
viewer.InitCache()удалено — нет необходимости вручную прогревать; удалите вызов и любой флаг «уже инициализировано?».
viewer.ExportToPng(sharedPath)см. §7
viewer.ExportToCloud(cloudConfig)см. §7
using var v = new Viewer(...); v.CloseDocument(t)viewer.CloseDocument(token) на внедрённом экземпляре

4. Промежуточное ПО и маршрутизация ресурсов

UseDoconut() теперь не принимает аргументы. Форма ветки MapWhen сама по себе не требует изменений — только промежуточное ПО внутри неё:

csharp
app.UseDoconutResources();   // ПЕРЕД веткой

app.MapWhen(
    ctx => ctx.Request.Path.Value?.EndsWith("DocImage.axd", StringComparison.OrdinalIgnoreCase) == true,
    branch => branch.UseDoconut());

В текущем конвейере:

  1. вызовите UseSession() до Doconut, пока включена безопасность сессии;
  2. вызовите UseDoconutResources() перед UseDoconut();
  3. сохраняйте согласованность ResourcesPath, сгенерированных URL‑ов ресурсов и клиентского ResPath;
  4. сохраняйте согласованность ветки, которую вы мапите, и клиентского BasePath.

MiddlewarePath — проверенная конфигурация; она не создаёт ветку ASP.NET Core сама по себе.

5. Конструирование и время жизни просмотрщика

Удалите кэши объектов Viewer, принадлежащие приложению. В Viewer больше нет ничего, что стоило бы сохранять: он не содержит состояния документа, а кеш сеанса владеет всем, что живёт дольше запроса. Внедрите его в конечную точку, страницу Razor, контроллер или службу приложения с областью действия:

csharp
app.MapPost("/api/open", async (Viewer viewer) =>
{
    var token = await viewer.OpenDocumentAsync("wwwroot/files/Sample.pdf");
    return Results.Ok(new { token });
});

Возвращаемый токен идентифицирует серверную сессию документа. Обращайтесь с ним как с учетными данными‑носителем: не регистрируйте его, не сохраняйте и не помещайте в аналитику.

6. Открытие и закрытие документов

Замените синхронный OpenDocument(...) на OpenDocumentAsync(...):

csharp
// Текущая интеграция: Viewer берётся из DI, а открытие документа происходит асинхронно.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { AllowSearch = true });

Текущие перегрузки принимают путь к файлу или поток, необязательную конфигурацию формата, необязательный DocOptions и токен отмены. Закрывайте серверную сессию явно, когда браузер больше её не нуждается:

csharp
viewer.CloseDocument(token);

Удалите любой вызов InitCache() и флаг, его защищающий — нечего прогревать вручную. Не переиспользуйте токен, созданный предыдущей библиотекой после перехода: открывайте каждый документ заново через текущий API.

7. Web farm → distributed: самое крупное изменение

UseDoconutWebFarm и WebFarmOptions больше не существуют. Если ваше приложение вызывает их, этот раздел — ваше обновление; если нет, переходите к §8.

Ранее один middleware делал всё: он обслуживал предварительно отрисованные изображения из общей папки и опрос пока другой узел всё ещё записывал их.

csharp
// Предыдущая интеграция — один вызов, неявная координация через файловую систему.
appBranch.UseDoconutWebFarm(new WebFarmOptions
{
    Path                = Path.Combine(env.WebRootPath, "webfarm"),
    PageWaitTimeSeconds = 180,
    StartWaitFromPage   = 5,
});

Та же задача теперь разделена на две явные части. Сторона записи — узел, открывающий документ, публикует весь набор артефактов (страницы, информацию о документе, поисковый индекс, метаданные) в общий ресурс:

csharp
var result = await _publisher.PublishAsync(          // DistributedDocumentPublisher, внедрённый из DI
    pathToFile,
    new FileShareConfig
    {
        Location              = CloudLocation.FileShare,
        RootPath              = @"\\fileserver\doconut",   // та же папка, которую вы используете сегодня
        UsePerTokenSubfolders = true,
    },
    config,
    documentOptions,
    new DistributedDocumentPublishOptions
    {
        CleanUpStagingDirectory = true,
        FirstPagePriority       = true,
    });

return Content(result.Token);

Сторона чтения — любой узел обслуживает из общего ресурса:

csharp
app.MapWhen(
    ctx => ctx.Request.Path.Value?.EndsWith("DocImage.axd", StringComparison.OrdinalIgnoreCase) == true,
    branch => branch.UseDoconutCloud<FileShareCloudHandler>(options =>
    {
        options.Location          = CloudLocation.FileShare;
        options.CloudUploadConfig = /* тот же FileShareConfig, что выше */;
    }, "/"));
ДоСейчас
WebFarmOptions.PathFileShareConfig.RootPath
PageWaitTimeSeconds / StartWaitFromPageудалено — заменено FirstPagePriority на стороне записи плюс FileShareConfig.ReadReadyPollMs на стороне чтения
viewer.OpenDocument(...) затем viewer.ExportToPng(share)один PublishAsync(...) вызов
DocOptions.IsWebfarm / WebfarmPathпо‑прежнему существует, записан как IsWebFarm / WebFarmPath — но не нужен на пути публикации

Ваша топология не меняется. Укажите RootPath на тот же UNC‑share, и каждый узел продолжит работать так же, как сегодня. Что меняется, так это то, что публикация становится операцией, которую вы вызываете, а не побочным эффектом рендеринга.

Обе части должны согласовываться. Если RootPath или UsePerTokenSubfolders различаются между издателем и обработчиком, другой узел отвечает 404. Сформируйте конфигурацию в одном помощнике и вызывайте её с обеих сторон.

PageWaitTimeSeconds = 180 означал «блокировать до трёх минут в ожидании появления страницы». Замена явна: с FirstPagePriority = true страница 1 доступна сразу, а последующие страницы отвечают HTTP 202 Accepted, пока не будут записаны. Встроенный просмотрщик автоматически повторяет запрос, когда установлен retryOn409. Клиент, который не делает повторные попытки, покажет сломанные плитки для страниц, которые ещё рендерятся.

Полная схема, включая фоновую публикацию и билеты доступа, описана в разделе Распределённые развертывания.

8. Конверсия — это плагин, и он гораздо меньше

Зарегистрируйте плагин, затем внедрите фасад DocumentConverter:

csharp
builder.Services.AddDoconut(o => o.AddPlugin<ConverterPlugin>());
csharp
// Предыдущая интеграция
var converter = viewer.Converter.GetConverter();
var config    = new WordConfigConverter { TargetFormat = WordConfigConverter.EnTargetFormat.PDF };
var result    = converter.Convert(stream, SourceFormatConverter.DOCX, config);

// Текущая интеграция
var result = await _converter.ConvertAsync(stream, ".docx", ConversionTarget.Pdf, null, ct);

Что это заменяет:

  • SourceFormatConverter — исчезло. Передавайте расширение файла как строку, включая точку.
  • Типы *ConfigConverter для каждой семьи (WordConfigConverter, ExcelConfigConverter, …), каждый со вложенным перечислением EnTargetFormat — исчезли. Теперь существует одно перечисление ConversionTarget для каждой семьи.
  • viewer.Converter.GetConverter() — исчезло. Внедрите Doconut.DocumentConverter.

ConvertAsync возвращает поток, поддерживающий поиск, поэтому return File(result, mime, name) работает напрямую — копия старого кода, необходимая для MemoryStream, больше не нужна. В поставляемом примере это удалило 68‑case переключатель расширений и десять почти идентичных контроллеров.

Смотрите Плагин конвертера для полного списка.

9. Облачные провайдеры

UseDoconutCloud стал универсальным. Провайдер теперь передаётся как аргумент типа вместо значения Location, переключаемого внутри middleware:

csharp
// Предыдущая интеграция
appBranch.UseDoconutCloud(new CloudOptions { Location = CloudLocation.CDN, ... });

// Текущая интеграция
branch.UseDoconutCloud<CDNCloudHandler>(options =>
{
    options.Location          = CloudLocation.CDN;
    options.CloudUploadConfig = new CDNConfig { DoconutCdnUrl = "..." };
}, "/");

Классы конфигурации не изменились, кроме пространства имён (Doconut.Configs.Cloud → Doconut.Clouds): AzureConfig, AmazonConfig, GoogleCloudConfig, DropBoxConfig, RedisConfig, CDNConfig, FTPConfig, плюс новый FileShareConfig. Обработчики названы <Provider>CloudHandler.

Обработчик CDN только для чтения — он обслуживает то, что уже находится на CDN; загрузка не производится.

10. Объекты конфигурации, получившие новые имена

ДоСейчас
DoconutOptions.UnSafeModeUnsafeMode
DocOptions.IsWebfarmIsWebFarm
DocOptions.WebfarmPathWebFarmPath
DocOptions.ImageResolutionпо‑прежнему присутствует, но устаревший — установите разрешение в конфигурации формата вместо этого

DocOptions также получает IsSecured.

Текущий API разделяет обязанности более строго, чем предыдущий, поэтому проверьте, что каждая настройка находится в объекте, которому она теперь принадлежит:

ОбластьТекущий тип
Пути middleware, лицензирование, регистрация плагиновDoconutOptions
Пароль, таймаут, безопасность, водяной знакDocOptions
Рендеринг формата и DPIPdfConfig, WordConfig, ExcelConfig и другие типы BaseConfig
Значения по умолчанию виджета браузераViewerConfig или эквивалентные параметры JavaScript
Сгенерированные CSS и скриптыCssConfig и ScriptConfig
Общий хранилище и облачные провайдерыFileShareConfig и остальные конфиги Doconut.Clouds

Не переносите DocOptions.ImageResolution вперёд как элемент управления рендерингом. Он устарел; установите BaseConfig.ImageResolution в конфигурации, специфичной для формата. Проверьте все значения по умолчанию, вместо того чтобы предполагать, что прежняя конфигурация ведёт себя так же.

11. Клиентский просмотрщик — два изменения, которые НЕ ОТКРЫТЫ

Оба эти изменения оставляют сервер полностью рабочим. Ваш документ рендерится, страница выглядит правильно, и в консоли браузера ничего не появляется. Прочитайте этот раздел, даже если ваш C# компилируется с первой попытки.

Обратные вызовы просмотрщика теперь — опции, а не глобальные функции

Ранее просмотрщик вызывал ваши обработчики по имени, формируя глобальное имя функции из идентификатора контейнера. Достаточно было объявить function ctlDoc_OnViewerReady() на странице с <div id="div_ctlDoc">. Текущий просмотрщик принимает явные обратные вызовы в объекте опций и больше не ищет эти глобальные функции:

javascript
objctlDoc = $("#div_ctlDoc").docViewer({
    // ... ваши существующие параметры ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // было найдено по имени
    onViewerReady:    ctlDoc_OnViewerReady,     // было найдено по имени
    onCopy:           ctlDoc_Copy,              // было ctlDoc_Copy(text)
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // было ctlDoc_AutoLoadStatus(page)
});

Почему это проблематично: старый вызов был обёрнут в пустой catch, который поглощал всё. Теперь ваши функции просто не запускаются, и ошибка не сообщается. Обычный симптом — индикатор загрузки, который никогда не останавливается, потому что функция, скрывающая его, была ctlDoc_OnViewerReady. Сам документ в порядке.

Полный список опций: onPageLoading, onPageLoaded, onThumbnailClicked, onPageClicked, onDoubleClick, onViewerBusy, onViewerReady, onViewerError, onCopy, onAnnSaved, onAnnSaveError, onAnnLoaded, onAnnClosed, onAutoLoadStatus, onThumbsShown и onError. Обратного вызова при клике по ссылке нет: обработка гиперссылок встроена и управляется showHyperlinks.

ResPath должен указывать на префикс ресурса

javascript
ResPath: '',                      // BEFORE — ресурсы получались из корня приложения
ResPath: 'doconut-res/images',    // NOW    — префикс UseDoconutResources() монтирует

Если вы изменили префикс через DoconutOptions.ResourcesPath, используйте это значение вместо него.

12. Панель инструментов Viewer, Поиск и Аннотация

Не переносите старые скрипты по отдельности. Текущие эталонные приложения формируют один полный пакет страницы:

  1. выпустить CSS Viewer и лицензированный CSS Поиска/Аннотации с помощью ReferenceCss;
  2. отрисовать панель инструментов Viewer, принадлежащую приложению;
  3. отрисовать searchBarMount, annBarMount и требуемый монтировочный элемент Viewer;
  4. выпустить скрипты Viewer и лицензированных модулей с помощью ReferenceScripts;
  5. загрузить вспомогательный скрипт панели инструментов приложения;
  6. инициализировать один objViewer;
  7. инициализировать лицензированные ленты Поиска и Аннотации;
  8. вызвать attach(objViewer) для каждой ленты;
  9. открыть документ и вызвать objViewer.View(token).

Поиск и Аннотация — это модули, присоединённые к одному Viewer, а не независимые панели инструментов. Основная панель принадлежит хост‑приложению; ленты Поиска и Аннотации являются встроенными ресурсами, доступ к которым регулируется возможностями.

Удаляйте вручную скопированные файлы, такие как documentLinks.js и docViewer.UI.js, только после того, как текущая страница будет работать с ресурсами, выпущенными ReferenceCss и ReferenceScripts.

13. Регистрация плагинов

Статические методы лицензирования плагинов не регистрируют текущие плагины. Установите и явно зарегистрируйте каждый выпущенный пакет:

csharp
builder.Services.AddDoconut(options =>
{
    options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>();
    options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});

AddDoconut() проверяет зарегистрированные возможности плагинов при запуске. Converter и DICOM — это выпущенные плагины .NET Standard. Обычные Поиск и Аннотация являются встроенными лицензированными функциями, а не пакетами AddPlugin<TPlugin>().

14. Безопасность сеанса и документа

Текущая интеграция привязывает документы к непрозрачным токенам и кэшированным сеансам. При использовании значения по умолчанию UnsafeMode = false, UseDoconut() добавляет безопасность доступа к документу, и хост должен настроить сеанс ASP.NET:

csharp
builder.Services.AddDistributedMemoryCache(); // состоянию сессии нужен кэш (MVC/Razor Pages уже добавляют один)
builder.Services.AddSession();
app.UseSession();

Сохраняйте DocOptions.IsSecured = true, если только проверенный дизайн не требует иного. Никогда не используйте UnsafeMode = true как короткий путь миграции на отдельном узле. Тестируйте запросы без токена, с некорректным токеном, с истёкшим токеном и с токеном из другой сессии браузера.

В ферме запрос страницы может попасть на узел, который никогда не получал начальный запрос, поэтому проверка по сеансу отклонит его. Это единственный случай, когда UnsafeMode = true является правильным — и его необходимо сочетать с подписанными билетами доступа через AddDoconutDistributedDocumentSecurity, а не использовать отдельно. См. Распределённые развертывания.

Примечание к именованию

Во всех фреймворках класс — Viewer. Если вы встретите DocumentViewer в старых фрагментах кода или сторонних статьях, такой тип никогда не существовал в SDK.

15. Предлагаемый порядок работы

  1. Убедитесь, что хост‑фреймворк может использовать netstandard2.1. Если нет — остановитесь.
  2. Обновите пакет до 26.8.0 и соберите проект. Разберите ошибки компиляции — большинство из них находятся в строках using в §1.
  3. Переместите инициализацию в AddDoconut(), а вызовы промежуточного ПО — в их новый порядок (§3, §4).
  4. Внедрите Viewer там, где вы его конструировали, сделайте OpenDocument асинхронным и удалите InitCache() (§5, §6).
  5. Если вы используете веб‑ферму, выполните §7 — единственная часть, требующая редизайна, а не переименования.
  6. Если вы конвертируете документы, выполните §8.
  7. Выполните §11 — изменения на клиентской стороне. Это те изменения, которые не объявятся сами по себе.
  8. Откройте реальный документ в браузере и наблюдайте за индикатором загрузки. Зеленая сборка здесь ничего не доказывает: лицензирование, регистрация плагинов, путь к ресурсам и обратные вызовы Viewer могут провалиться только во время выполнения. Для фермы проверьте, что документ, опубликованный на одном узле, обслуживается другим.

Тестирование миграции

Минимум, проверьте:

  • запуск приложения с производственной лицензией и всеми зарегистрированными плагинами;
  • CSS/скрипты Viewer и все запросы изображений страниц по выбранным путям;
  • открытие документа, навигация, масштабирование, миниатюры, печать и явное закрытие;
  • поиск в документе, содержащем текст, и отсутствие возможности поиска в файле, содержащем только изображения;
  • загрузка, сохранение, экспорт аннотаций и управление возможностями;
  • обнаружение целей конвертера, вывод, загрузка и состояние водяного знака;
  • страницы DICOM, кадры и анимация; технические метаданные недоступны в этом пакете;
  • документы, защищённые паролем, пользовательские шрифты, нелатинский текст и настроенные тайм‑ауты;
  • отклонение токенов между сессиями и поведение при истёкшей сессии;
  • для фермы: опубликовать на одном узле, запросить позднюю страницу с другого и подтвердить, что viewer повторно запрашивает ответы 202 вместо отображения сломанных плиток;
  • мобильные устройства, тёмный режим и путь обратного прокси в продакшене.

План отката

Сохраните предыдущий артефакт развертывания, соответствующие пакеты, файлы лицензий и скопированные ресурсы браузера вместе.
Безопасный откат переключает всю генерацию приложения; он не смешивает сервер предыдущего поколения с текущими скриптами или текущий сервер с вызовами new Viewer(...).

Перед переключением задокументируйте:

  • слот развертывания или артефакт, используемый для отката;
  • влияние на общедоступное хранилище, если есть — артефакты, опубликованные в версии 26.8.0, не используются предыдущим промежуточным ПО веб‑фермы;
  • как активные сессии документов будут аннулированы;
  • проверка работоспособности и тестовый документ, используемые для решения об откате;
  • кто может восстановить предыдущий набор пакетов и конфигурацию.

Унаследованная документация

Переведённое предыдущее руководство доступно по адресу
Legacy .NET Standard установка.
Предыдущий шлюз интеграции объясняет те же сигналы идентификации и ссылается обратно на это руководство по миграции.

Сохраняйте исторический URL в закладках и служебных тикетах, пока установки netstandard2.0 ещё существуют. Он документирует другую генерацию и не перенаправляется на текущий API.

Была ли эта страница полезной?