Migrasi ke .NET Standard 2.1

Pindahkan aplikasi Doconut.NETStandard yang ada dari 26.7.0 ke 26.8.0

Doconut memiliki dua integrasi .NET Standard yang berbeda. Mereka menggunakan nama paket Doconut.NETStandard yang sama, jadi identifikasi generasi dari versi dan API dalam aplikasi sebelum mengubah paket, startup, lisensi, atau sumber daya peramban.

Versi adalah percabangan di jalan

Kedua generasi dipublikasikan di bawah ID paket yang sama. Hanya versi yang membedakannya:

VersiTargetAPI
26.7.0 dan di bawahnyanetstandard2.0API sebelumnya
26.8.0 dan di atasnyanetstandard2.1API saat ini

Meningkatkan nomor versi adalah peningkatan. Tidak ada paket terpisah untuk diinstal dan tidak ada shim kompatibilitas — 26.8.0 memiliki permukaan API yang berbeda. Harapkan kesalahan kompilasi setelah peningkatan; sisanya panduan ini adalah daftar kesalahan tersebut.

Integrasi mana yang Anda gunakan?

Jika proyek berisi…Generasi
new Viewer(_cache, _accessor, ...)Sebelumnya
viewer.OpenDocument(...) (sinkron)Sebelumnya
viewer.InitCache()Sebelumnya
UseDoconut(new DoconutOptions { ... })Sebelumnya
UseDoconutWebFarm(...) / WebFarmOptionsSebelumnya
Viewer.DoconutLicense(...) atau Viewer.SetLicensePlugin(...)Sebelumnya
viewer.Converter.GetConverter()Sebelumnya
using Doconut.Configs; / using Doconut.Models;Sebelumnya
Disalin secara manual docViewer.js, documentLinks.js, atau docViewer.UI.jsSebelumnya
builder.Services.AddDoconut(...)Saat ini
app.UseDoconutResources() plus app.UseDoconut() tanpa argumenSaat ini
Viewer disediakan oleh dependency injectionSaat ini
await viewer.OpenDocumentAsync(...)Saat ini

Jika kedua kolom muncul dalam aplikasi yang sama, anggap migrasi tidak lengkap. Jangan mengirim satu token dokumen melalui sumber daya atau middleware dari generasi lain.

Periksa kerangka kerja host terlebih dahulu

Ini adalah gerbang keras, bukan preferensi. Paket saat ini menargetkan netstandard2.1:

HostDapat mengonsumsi 26.8.0
.NET Core 3.0 atau lebih baru (termasuk .NET 5/6/7/8)Ya
.NET Framework, versi apa punTidak

.NET Framework tidak dapat merujuk ke pustaka netstandard2.1. Jika aplikasi berjalan di .NET Framework, hentikan di sini dan gunakan paket Doconut.NETFramework sebagai gantinya; mulai dari 26.9.0 paket ini memerlukan .NET Framework 4.7.2. Kedua aplikasi referensi untuk rilis ini menargetkan net8.0.

Sebelum Anda melakukan migrasi

  1. Buat cabang dan cadangan yang dapat dideploy dari aplikasi yang ada.
  2. Catat versi paket inti dan plugin yang tepat.
  3. Inventarisasi setiap pemanggilan new Viewer(...), pemanggilan InitCache(), pemanggilan pemuatan lisensi, pemetaan UseDoconutWebFarm, kontroler konversi, skrip Doconut yang disalin, aksi toolbar khusus, callback viewer, dan endpoint pembukaan dokumen.
  4. Jaga file .lic saat ini dan rahasia deployment di luar kontrol sumber.
  5. Ambil kumpulan representatif PDF, Office, gambar, CAD, email, DICOM, yang dapat dicari, yang dilindungi kata sandi, dan dokumen beranotasi.
  6. Catat batas waktu sesi yang ada, perilaku keamanan, font, dan pengaturan platform.

Migrasikan satu lingkungan sebelum mengubah produksi. Integrasi saat ini mengubah masa hidup layanan, routing permintaan, kepemilikan sesi, pengiriman sumber daya klien, dan — jika Anda menjalankan farm — bagaimana halaman mencapai peramban sama sekali.

1. Namespace: hampir semua dipindahkan ke root

Tipe konfigurasi tersebar di empat namespace. Sekarang semuanya berada di Doconut.

SebelumnyaSekarang
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;tidak berubah
using Doconut.Middleware;tidak berubah

Nama tipe tidak berubah: WordConfig, PdfConfig, ExcelConfig, CssConfig, ScriptConfig, CloudUploadConfig, AzureConfig, CDNConfig, FileShareConfig dan sisanya masih ada. Di sebagian besar file, seluruh perubahan adalah menghapus dua baris using.

Doconut.Configs.Editor (BaseConfigEditor, PdfConfigEditor) telah dihapus dan tidak memiliki pengganti dalam paket ini. Jika aplikasi Anda merujuk ke tipe tersebut, rencanakan bagian itu secara terpisah dan jangan menganggapnya sebagai bagian dari migrasi ini.

2. Kompatibilitas Paket dan Lisensi

Ganti atau perbarui paket inti secara sengaja; jangan bergantung pada ID paket yang identik untuk memilih API baru. Perintah default menginstal rilis stabil terbaru:

bash
dotnet add package Doconut.NETStandard

Untuk migrasi yang dapat direproduksi ke rilis yang diaudit oleh panduan ini, berikan versi sebagai opsi terpisah:

bash
dotnet add package Doconut.NETStandard --version 26.9.0

Pertahankan setiap plugin Doconut pada versi yang sama dengan paket inti — Doconut.NETStandard.Converter dan Doconut.NETStandard.Dicom. Integrasi saat ini memuat lisensi sekali selama AddDoconut(), menggunakan prioritas ini:

text
LicenseStream > LicenseContent > LicensePath > automatic discovery

Penemuan otomatis mencari Doconut.Viewer.lic dan file pendamping Doconut.Viewer.<Capability>.lic. Panggilan statis sebelumnya Viewer.DoconutLicense(...) dan Viewer.SetLicensePlugin(...) bukanlah mekanisme startup saat ini, dan begitu juga List<string> dari jalur lisensi yang diterima oleh konstruktor lama Viewer. Pindahkan lisensi ke DoconutOptions, pertahankan file pendamping bersama saat menggunakan penemuan otomatis, restart setelah mengubah lisensi, dan verifikasi kemampuan melalui IDoconutLicenseService.

Jangan menganggap bahwa keberadaan lisensi plugin lama membuktikan hak untuk build plugin saat ini. Uji Viewer, Search, Annotation, Converter, dan DICOM secara terpisah dengan artefak rilis yang disetujui.

3. Startup dan Injeksi Dependensi

Sebelumnya viewer dibangun per permintaan dan opsi diteruskan ke middleware:

csharp
// Integrasi sebelumnya — hanya untuk perbandingan; jangan kompilasi ini terhadap SDK saat ini.
var viewer = new Viewer(_cache, _accessor);
// …
appBranch.UseDoconut(new DoconutOptions { UnSafeMode = false, ShowDoconutInfo = false });

Integrasi saat ini mendaftarkan Doconut sekali dan menerima Viewer dari dependency injection:

csharp
builder.Services.AddDoconut(options =>
{
    options.UnsafeMode      = false;   // catat perubahan ejaan: UnSafeMode → UnsafeMode
    options.ShowDoconutInfo = false;
    options.LicensePath     = "Doconut.Viewer.lic";
});
builder.Services.AddDistributedMemoryCache(); // status sesi membutuhkan cache (MVC/Razor Pages sudah menambah satu)
builder.Services.AddSession();

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

Viewer adalah layanan transien. Manajer sesi dokumen dan cache-nya memiliki keadaan dokumen yang lebih lama, bukan instance Viewer yang disuntikkan secara khusus.

Tiga hal yang harus dipertahankan:

  • new Viewer(cache, accessor) sudah tidak ada. Suntikkan Doconut.Viewer ke dalam controller Anda, atau gunakan @inject Doconut.Viewer Viewer dalam tampilan Razor.
  • UseDoconutResources() menggantikan penataan manual app.UseMiddleware<EmbeddedResourceMiddleware>(), dan harus dijalankan sebelum cabang dokumen.
  • UnSafeMode → UnsafeMode. Penggantian satu karakter yang akan ditangkap oleh kompiler.

Ketika UnsafeMode berada dalam keadaan false, SDK memvalidasi token sesi terhadap permintaan asal, sehingga AddSession() / UseSession() masih harus berada di pipeline, UseSession() sebelum cabang.

Metode yang Tidak Lagi Ada

SebelumSekarang
viewer.OpenDocument(path, config, options)await viewer.OpenDocumentAsync(path, config, options)
viewer.InitCache()removed — tidak ada yang perlu dipanaskan secara manual; hapus pemanggilan dan setiap flag "did I already init?" di sekitarnya
viewer.ExportToPng(sharedPath)lihat §7
viewer.ExportToCloud(cloudConfig)lihat §7
using var v = new Viewer(...); v.CloseDocument(t)viewer.CloseDocument(token) pada instance yang disuntikkan

4. Middleware dan Routing Sumber Daya

UseDoconut() sekarang tidak menerima argumen. Bentuk cabang MapWhen sendiri tidak perlu diubah — hanya middleware di dalamnya:

csharp
app.UseDoconutResources();   // SEBELUM cabang

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

Dalam pipeline saat ini:

  1. panggil UseSession() sebelum Doconut saat keamanan sesi diaktifkan;
  2. panggil UseDoconutResources() sebelum UseDoconut();
  3. pertahankan ResourcesPath, URL sumber daya yang dihasilkan, dan client ResPath selaras;
  4. pertahankan cabang yang Anda petakan dan client BasePath selaras.

MiddlewarePath adalah konfigurasi yang divalidasi; ia tidak membuat cabang ASP.NET Core secara mandiri.

5. Konstruksi Penampil dan Masa Pakai

Hapus cache milik aplikasi untuk objek Viewer. Tidak ada yang tersisa dalam sebuah Viewer
yang layak dipertahankan: ia tidak membawa status dokumen, dan cache sesi memiliki semua
yang bertahan lebih lama dari sebuah permintaan. Suntikkan ke dalam endpoint, halaman Razor, controller, atau
layanan aplikasi berskala:

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

Token yang dikembalikan mengidentifikasi sesi dokumen sisi server. Perlakukan sebagai kredensial pembawa
kredensial: jangan log, simpan, atau tempatkan dalam analitik.

6. Membuka dan Menutup Dokumen

Ganti OpenDocument(...) sinkron dengan OpenDocumentAsync(...):

csharp
// Integrasi saat ini: Viewer diambil dari DI dan pembukaan dokumen bersifat asinkron.
var token = await viewer.OpenDocumentAsync(path, new PdfConfig { AllowSearch = true });

Overload saat ini menerima jalur file atau aliran, konfigurasi format opsional,
DocOptions opsional, dan token pembatalan. Tutup sesi server secara eksplisit ketika
browser tidak lagi membutuhkannya:

csharp
viewer.CloseDocument(token);

Hapus semua pemanggilan InitCache() dan flag yang melindunginya — tidak ada yang perlu dipanaskan secara manual
Jangan gunakan kembali token yang dibuat oleh perpustakaan sebelumnya setelah peralihan: buka setiap
dokumen lagi melalui API saat ini.

7. Web farm → terdistribusi: perubahan terbesar

UseDoconutWebFarm dan WebFarmOptions tidak ada lagi. Jika aplikasi Anda memanggilnya,
bagian ini adalah peningkatan Anda; jika tidak, lewati ke §8.

Sebelumnya satu middleware melakukan semuanya: menyajikan gambar pra-render dari folder bersama
dan memeriksa sementara node lain masih menulisnya.

csharp
// Integrasi sebelumnya — satu panggilan, koordinasi implisit melalui sistem berkas.
appBranch.UseDoconutWebFarm(new WebFarmOptions
{
    Path                = Path.Combine(env.WebRootPath, "webfarm"),
    PageWaitTimeSeconds = 180,
    StartWaitFromPage   = 5,
});

Pekerjaan yang sama kini dibagi menjadi dua bagian eksplisit. Sisi Penulisan — node yang membuka
dokumen memublikasikan seluruh set artefak (halaman, info dokumen, indeks pencarian,
metadata) ke dalam share:

csharp
var result = await _publisher.PublishAsync(          // DistributedDocumentPublisher, disuntikkan dari DI
    pathToFile,
    new FileShareConfig
    {
        Location              = CloudLocation.FileShare,
        RootPath              = @"\\fileserver\doconut",   // folder yang sama yang Anda gunakan hari ini
        UsePerTokenSubfolders = true,
    },
    config,
    documentOptions,
    new DistributedDocumentPublishOptions
    {
        CleanUpStagingDirectory = true,
        FirstPagePriority       = true,
    });

return Content(result.Token);

Sisi Pembacaan — setiap node melayani dari share:

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 YANG SAMA seperti di atas */;
    }, "/"));
SebelumSekarang
WebFarmOptions.PathFileShareConfig.RootPath
PageWaitTimeSeconds / StartWaitFromPagehilang — diganti oleh FirstPagePriority pada sisi penulisan plus FileShareConfig.ReadReadyPollMs pada sisi pembacaan
viewer.OpenDocument(...) kemudian viewer.ExportToPng(share)satu panggilan PublishAsync(...)
DocOptions.IsWebfarm / WebfarmPathmasih ada, dieja IsWebFarm / WebFarmPath — tetapi tidak diperlukan pada jalur publikasi

Topologi Anda tidak berubah. Arahkan RootPath ke share UNC yang sama dan setiap node
tetap bekerja seperti yang dilakukan hari ini. Yang berubah adalah bahwa publikasi adalah operasi yang Anda
panggil, bukan efek samping dari rendering.

Kedua sisi harus setuju. Jika RootPath atau UsePerTokenSubfolders berbeda antara
penerbit dan penangan, node lain menjawab 404. Bangun konfigurasi dalam satu helper
dan panggil dari kedua sisi.

PageWaitTimeSeconds = 180 berarti "memblokir hingga tiga menit berharap halaman muncul". Penggantiannya
adalah eksplisit: dengan FirstPagePriority = true, halaman 1 dapat disajikan segera
dan halaman berikutnya menjawab HTTP 202 Accepted sampai ditulis. Penampil terbundel secara otomatis
mencoba kembali ketika retryOn409 diatur. Klien yang tidak mencoba kembali akan menampilkan ubin
rusak untuk halaman yang masih dirender.

Susunan lengkap, termasuk publikasi latar belakang dan tiket akses, ada di
Penyebaran Terdistribusi.

8. Konversi adalah plugin, dan jauh lebih kecil

Daftarkan plugin, lalu sisipkan facade DocumentConverter:

csharp
builder.Services.AddDoconut(o => o.AddPlugin<ConverterPlugin>());
csharp
// Integrasi sebelumnya
var converter = viewer.Converter.GetConverter();
var config    = new WordConfigConverter { TargetFormat = WordConfigConverter.EnTargetFormat.PDF };
var result    = converter.Convert(stream, SourceFormatConverter.DOCX, config);

// Integrasi saat ini
var result = await _converter.ConvertAsync(stream, ".docx", ConversionTarget.Pdf, null, ct);

Apa yang digantikan:

  • SourceFormatConverter — hilang. Berikan ekstensi file sebagai string, termasuk titik.
  • Jenis per-keluarga *ConfigConverter (WordConfigConverter, ExcelConfigConverter, …), masing-masing dengan enum EnTargetFormat bersarang — hilang. Sekarang ada satu enum ConversionTarget untuk setiap keluarga.
  • viewer.Converter.GetConverter() — hilang. Sisipkan Doconut.DocumentConverter.

ConvertAsync mengembalikan aliran yang dapat dicari, sehingga return File(result, mime, name) bekerja langsung — menyalin kode lama yang diperlukan oleh MemoryStream tidak diperlukan. Dalam contoh yang dikirim ini menghapus sebuah switch ekstensi dengan 68 kasus dan sepuluh pengontrol yang hampir identik.

Lihat Plugin Konverter untuk seluruh fiturnya.

9. Penyedia Cloud

UseDoconutCloud menjadi generik. Penyedia adalah argumen tipe alih-alih nilai Location yang dipilih di dalam middleware:

csharp
// Integrasi sebelumnya
appBranch.UseDoconutCloud(new CloudOptions { Location = CloudLocation.CDN, ... });

// Integrasi saat ini
branch.UseDoconutCloud<CDNCloudHandler>(options =>
{
    options.Location          = CloudLocation.CDN;
    options.CloudUploadConfig = new CDNConfig { DoconutCdnUrl = "..." };
}, "/");

Kelas konfigurasi tidak berubah kecuali namespace (Doconut.Configs.Cloud → Doconut.Clouds): AzureConfig, AmazonConfig, GoogleCloudConfig, DropBoxConfig, RedisConfig, CDNConfig, FTPConfig, serta FileShareConfig yang baru. Handler dinamai <Provider>CloudHandler.

Handler CDN bersifat read-only — ia menyajikan apa yang sudah ada di CDN; tidak mengunggah apa pun.

10. Objek konfigurasi yang berganti nama

SebelumSekarang
DoconutOptions.UnSafeModeUnsafeMode
DocOptions.IsWebfarmIsWebFarm
DocOptions.WebfarmPathWebFarmPath
DocOptions.ImageResolutionmasih ada tetapi usang — atur resolusi pada konfigurasi format sebagai gantinya

DocOptions juga mendapatkan IsSecured.

API saat ini juga memisahkan kepentingan lebih ketat dibandingkan yang sebelumnya, jadi periksa bahwa setiap pengaturan berada pada objek yang kini memilikinya:

AspekTipe saat ini
Jalur middleware, lisensi, pendaftaran pluginDoconutOptions
Kata sandi, batas waktu, keamanan, watermarkDocOptions
Rendering format dan DPIPdfConfig, WordConfig, ExcelConfig, dan tipe BaseConfig lainnya
Default widget browserViewerConfig atau opsi JavaScript yang setara
CSS dan skrip yang dihasilkanCssConfig dan ScriptConfig
Penyimpanan bersama dan penyedia cloudFileShareConfig dan konfigurasi Doconut.Clouds lainnya

Jangan teruskan DocOptions.ImageResolution sebagai kontrol rendering. Itu usang; atur BaseConfig.ImageResolution pada konfigurasi spesifik format. Tinjau semua default alih-alih mengasumsikan konfigurasi sebelumnya memiliki perilaku yang sama.

11. Penampil sisi klien — dua perubahan yang gagal secara SENYAP

Kedua hal ini membuat server berfungsi dengan sempurna. Dokumen Anda dirender, halaman terlihat benar, dan tidak ada yang muncul di konsol peramban. Baca bagian ini bahkan jika C# Anda berhasil dikompilasi pada percobaan pertama.

Callback penampil kini menjadi opsi, bukan fungsi global

Penampil sebelumnya memanggil handler Anda dengan nama, menghasilkan nama fungsi global dari id kontainer. Mendeklarasikan function ctlDoc_OnViewerReady() pada halaman dengan <div id="div_ctlDoc"> sudah cukup. Penampil saat ini mengambil callback eksplisit dalam objek opsi dan tidak lagi mencari global tersebut:

javascript
objctlDoc = $("#div_ctlDoc").docViewer({
    // ... opsi Anda yang ada ...
    onViewerBusy:     ctlDoc_OnViewerBusy,      // ditemukan berdasarkan nama
    onViewerReady:    ctlDoc_OnViewerReady,     // ditemukan berdasarkan nama
    onCopy:           ctlDoc_Copy,              // adalah ctlDoc_Copy(text)
    onAutoLoadStatus: ctlDoc_AutoLoadStatus     // adalah ctlDoc_AutoLoadStatus(page)
});

Mengapa ini menjengkelkan: panggilan lama dibungkus dalam catch kosong, yang menelan semuanya. Sekarang fungsi Anda tidak pernah dijalankan dan tidak ada yang melaporkan kesalahan. Gejala biasanya adalah spinner yang terus berputar — karena fungsi yang menyembunyikannya adalah ctlDoc_OnViewerReady. Dokumen di belakangnya baik-baik saja.

Daftar opsi lengkapnya adalah onPageLoading, onPageLoaded, onThumbnailClicked, onPageClicked, onDoubleClick, onViewerBusy, onViewerReady, onViewerError, onCopy, onAnnSaved, onAnnSaveError, onAnnLoaded, onAnnClosed, onAutoLoadStatus, onThumbsShown, dan onError. Tidak ada callback klik tautan: penanganan hyperlink sudah terintegrasi, dipicu oleh showHyperlinks.

ResPath harus mengarah ke awalan sumber daya

javascript
ResPath: '',                      // SEBELUM — sumber daya berasal dari root aplikasi
ResPath: 'doconut-res/images',    // SEKARANG    — awalan UseDoconutResources() memasang

Jika Anda mengubah awalan melalui DoconutOptions.ResourcesPath, gunakan nilai itu sebagai gantinya.

12. Toolbar Viewer, Pencarian, dan Anotasi

Jangan migrasikan skrip lama satu per satu. Aplikasi referensi saat ini menyusun satu paket halaman lengkap:

  1. menghasilkan CSS Viewer dan CSS Search/Annotation berlisensi dengan ReferenceCss;
  2. menampilkan toolbar Viewer milik aplikasi;
  3. menampilkan searchBarMount, annBarMount, dan mount Viewer yang diperlukan;
  4. menghasilkan skrip Viewer dan modul berlisensi dengan ReferenceScripts;
  5. memuat skrip pembantu toolbar milik aplikasi;
  6. menginisialisasi satu objViewer;
  7. menginisialisasi Ribbon Search dan Anotasi yang berlisensi;
  8. memanggil attach(objViewer) pada setiap Ribbon;
  9. buka dokumen dan panggil objViewer.View(token).

Search dan Annotation adalah modul yang terpasang pada Viewer yang sama, bukan toolbar independen. Toolbar utama milik aplikasi host; Ribbon Search dan Annotation tersemat, sebagai sumber daya yang terbatas kemampuannya.

Hapus file yang disalin secara manual seperti documentLinks.js dan docViewer.UI.js hanya setelah halaman saat ini berfungsi dengan sumber daya yang dihasilkan oleh ReferenceCss dan ReferenceScripts.

13. Pendaftaran Plugin

Metode plugin-licensi statis tidak mendaftarkan plugin saat ini. Instal dan daftarkan setiap paket yang dirilis secara eksplisit:

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

AddDoconut() memvalidasi kemampuan plugin yang terdaftar saat startup. Converter dan DICOM adalah plugin .NET Standard yang dirilis. Search dan Annotation normal adalah fitur berlisensi bawaan, bukan paket AddPlugin<TPlugin>().

14. Keamanan Sesi dan Dokumen

Integrasi saat ini mengikat dokumen ke token opak dan sesi yang di-cache. Dengan UnsafeMode = false default, UseDoconut() menambahkan keamanan akses dokumen dan host harus mengkonfigurasi sesi ASP.NET:

csharp
builder.Services.AddDistributedMemoryCache(); // session state memerlukan cache (MVC/Razor Pages sudah menambahkan satu)
builder.Services.AddSession();
app.UseSession();

Pertahankan DocOptions.IsSecured = true kecuali desain yang ditinjau memerlukan sebaliknya. Jangan pernah menggunakan UnsafeMode = true sebagai jalan pintas migrasi pada satu node. Uji permintaan tanpa token, token yang rusak, token yang kedaluwarsa, dan token dari sesi browser yang berbeda.

Di sebuah farm, permintaan halaman dapat mendarat pada node yang tidak pernah melihat permintaan pembuka, sehingga pemeriksaan per-sesi akan menolaknya. Itu adalah satu-satunya kasus di mana UnsafeMode = true benar — dan harus dipasangkan dengan tiket akses yang ditandatangani melalui AddDoconutDistributedDocumentSecurity, bukan dikirim sendiri. Lihat Penyebaran Terdistribusi.

Catatan Penamaan

Di semua kerangka kerja, kelasnya adalah Viewer. Jika Anda menemukan DocumentViewer dalam cuplikan lama atau artikel pihak ketiga, tipe itu tidak pernah ada di SDK.

15. Urutan Kerja yang Disarankan

  1. Pastikan kerangka kerja host dapat mengonsumsi netstandard2.1. Jika tidak, hentikan.
  2. Naikkan paket ke 26.8.0 dan bangun. Selesaikan kesalahan kompilasi — kebanyakan adalah baris using di §1.
  3. Pindahkan startup ke AddDoconut() dan panggilan middleware ke urutan baru mereka (§3, §4).
  4. Sisipkan Viewer di tempat Anda membangunnya, buat OpenDocument async, dan hapus InitCache() (§5, §6).
  5. Jika Anda menggunakan web farm, lakukan §7 — satu-satunya bagian yang merupakan redesain bukan sekadar mengganti nama.
  6. Jika Anda mengonversi dokumen, lakukan §8.
  7. Lakukan §11 — perubahan sisi klien. Mereka adalah yang tidak akan mengumumkan diri.
  8. Buka dokumen nyata di browser, dan perhatikan spinner yang sibuk. Build hijau membuktikan tidak ada apa-apa di sini: lisensi, pendaftaran plugin, jalur sumber daya, dan viewer callback semuanya gagal hanya pada runtime. Untuk farm, verifikasi bahwa dokumen yang dipublikasikan oleh satu node dilayani oleh node lain.

Pengujian migrasi

Setidaknya, verifikasi:

  • memulai aplikasi dengan lisensi produksi dan setiap plugin yang terdaftar;
  • CSS/script Viewer dan semua permintaan halaman-gambar di bawah jalur yang dipilih;
  • pembukaan dokumen, navigasi, zoom, thumbnail, cetak, dan penutupan eksplisit;
  • Pencarian pada dokumen yang berisi teks dan keadaan tidak dapat dicari pada file yang hanya berisi gambar;
  • memuat anotasi, menyimpan, mengekspor, dan pembatasan kemampuan;
  • penemuan target konverter, output, unduhan, dan keadaan watermark;
  • halaman DICOM, frame, dan animasi; metadata teknis tidak tersedia pada paket ini;
  • dokumen yang dilindungi kata sandi, font khusus, teks non-Latin, dan batas waktu yang dikonfigurasi;
  • penolakan token lintas sesi dan perilaku sesi kedaluwarsa;
  • untuk farm: publikasikan pada satu node, minta halaman terlambat dari node lain, dan konfirmasi bahwa viewer mencoba kembali respons 202 alih-alih menampilkan ubin yang rusak;
  • mobile, mode gelap, dan jalur reverse-proxy produksi.

Rencana rollback

Pertahankan artefak penyebaran sebelumnya, paket yang cocok, file lisensi, dan sumber daya browser yang disalin bersama-sama. Rollback yang aman mengganti seluruh generasi aplikasi; itu tidak mencampur server generasi sebelumnya dengan skrip saat ini, atau server saat ini dengan situs panggilan new Viewer(...).

Sebelum pemindahan, dokumentasikan:

  • slot penyebaran atau artefak yang digunakan untuk rollback;
  • dampak penyimpanan bersama, jika ada — artefak yang dipublikasikan oleh 26.8.0 tidak dikonsumsi oleh middleware web-farm sebelumnya;
  • bagaimana sesi dokumen aktif akan dibatalkan;
  • pemeriksaan kesehatan dan dokumen uji coba yang digunakan untuk memutuskan rollback;
  • siapa yang dapat memulihkan set paket dan konfigurasi sebelumnya.

Dokumentasi legacy

Manual sebelumnya yang diterjemahkan tetap tersedia di Pengaturan Legacy .NET Standard. Gateway integrasi sebelumnya menjelaskan sinyal identifikasi yang sama dan menautkan kembali ke panduan migrasi ini.

Pertahankan URL historis dalam bookmark dan tiket dukungan selama instalasi netstandard2.0 masih ada. Itu mendokumentasikan generasi yang berbeda dan tidak diarahkan ke API saat ini.

Apakah halaman ini membantu?