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:
| Versi | Target | API |
|---|---|---|
| 26.7.0 dan di bawahnya | netstandard2.0 | API sebelumnya |
| 26.8.0 dan di atasnya | netstandard2.1 | API 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(...) / WebFarmOptions | Sebelumnya |
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.js | Sebelumnya |
builder.Services.AddDoconut(...) | Saat ini |
app.UseDoconutResources() plus app.UseDoconut() tanpa argumen | Saat ini |
Viewer disediakan oleh dependency injection | Saat 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:
| Host | Dapat mengonsumsi 26.8.0 |
|---|---|
| .NET Core 3.0 atau lebih baru (termasuk .NET 5/6/7/8) | Ya |
| .NET Framework, versi apa pun | Tidak |
.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
- Buat cabang dan cadangan yang dapat dideploy dari aplikasi yang ada.
- Catat versi paket inti dan plugin yang tepat.
- Inventarisasi setiap pemanggilan
new Viewer(...), pemanggilanInitCache(), pemanggilan pemuatan lisensi, pemetaanUseDoconutWebFarm, kontroler konversi, skrip Doconut yang disalin, aksi toolbar khusus, callback viewer, dan endpoint pembukaan dokumen. - Jaga file
.licsaat ini dan rahasia deployment di luar kontrol sumber. - Ambil kumpulan representatif PDF, Office, gambar, CAD, email, DICOM, yang dapat dicari, yang dilindungi kata sandi, dan dokumen beranotasi.
- 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.
| Sebelumnya | Sekarang |
|---|---|
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:
dotnet add package Doconut.NETStandardUntuk migrasi yang dapat direproduksi ke rilis yang diaudit oleh panduan ini, berikan versi sebagai opsi terpisah:
dotnet add package Doconut.NETStandard --version 26.9.0Pertahankan 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:
LicenseStream > LicenseContent > LicensePath > automatic discoveryPenemuan 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:
// 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:
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. SuntikkanDoconut.Viewerke dalam controller Anda, atau gunakan@inject Doconut.Viewer Viewerdalam tampilan Razor.UseDoconutResources()menggantikan penataan manualapp.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
| Sebelum | Sekarang |
|---|---|
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:
app.UseDoconutResources(); // SEBELUM cabang
app.MapWhen(
ctx => ctx.Request.Path.Value?.EndsWith("DocImage.axd", StringComparison.OrdinalIgnoreCase) == true,
branch => branch.UseDoconut());Dalam pipeline saat ini:
- panggil
UseSession()sebelum Doconut saat keamanan sesi diaktifkan; - panggil
UseDoconutResources()sebelumUseDoconut(); - pertahankan
ResourcesPath, URL sumber daya yang dihasilkan, dan clientResPathselaras; - pertahankan cabang yang Anda petakan dan client
BasePathselaras.
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:
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(...):
// 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:
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.
// 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:
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:
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 */;
}, "/"));| Sebelum | Sekarang |
|---|---|
WebFarmOptions.Path | FileShareConfig.RootPath |
PageWaitTimeSeconds / StartWaitFromPage | hilang — diganti oleh FirstPagePriority pada sisi penulisan plus FileShareConfig.ReadReadyPollMs pada sisi pembacaan |
viewer.OpenDocument(...) kemudian viewer.ExportToPng(share) | satu panggilan PublishAsync(...) |
DocOptions.IsWebfarm / WebfarmPath | masih 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
RootPathatauUsePerTokenSubfoldersberbeda 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:
builder.Services.AddDoconut(o => o.AddPlugin<ConverterPlugin>());// 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 enumEnTargetFormatbersarang — hilang. Sekarang ada satu enumConversionTargetuntuk setiap keluarga. viewer.Converter.GetConverter()— hilang. SisipkanDoconut.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:
// 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
| Sebelum | Sekarang |
|---|---|
DoconutOptions.UnSafeMode | UnsafeMode |
DocOptions.IsWebfarm | IsWebFarm |
DocOptions.WebfarmPath | WebFarmPath |
DocOptions.ImageResolution | masih 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:
| Aspek | Tipe saat ini |
|---|---|
| Jalur middleware, lisensi, pendaftaran plugin | DoconutOptions |
| Kata sandi, batas waktu, keamanan, watermark | DocOptions |
| Rendering format dan DPI | PdfConfig, WordConfig, ExcelConfig, dan tipe BaseConfig lainnya |
| Default widget browser | ViewerConfig atau opsi JavaScript yang setara |
| CSS dan skrip yang dihasilkan | CssConfig dan ScriptConfig |
| Penyimpanan bersama dan penyedia cloud | FileShareConfig 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:
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
ResPath: '', // SEBELUM — sumber daya berasal dari root aplikasi
ResPath: 'doconut-res/images', // SEKARANG — awalan UseDoconutResources() memasangJika 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:
- menghasilkan CSS Viewer dan CSS Search/Annotation berlisensi dengan
ReferenceCss; - menampilkan toolbar Viewer milik aplikasi;
- menampilkan
searchBarMount,annBarMount, dan mount Viewer yang diperlukan; - menghasilkan skrip Viewer dan modul berlisensi dengan
ReferenceScripts; - memuat skrip pembantu toolbar milik aplikasi;
- menginisialisasi satu
objViewer; - menginisialisasi Ribbon Search dan Anotasi yang berlisensi;
- memanggil
attach(objViewer)pada setiap Ribbon; - 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:
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:
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
- Pastikan kerangka kerja host dapat mengonsumsi netstandard2.1. Jika tidak, hentikan.
- Naikkan paket ke 26.8.0 dan bangun. Selesaikan kesalahan kompilasi — kebanyakan adalah
baris
usingdi §1. - Pindahkan startup ke
AddDoconut()dan panggilan middleware ke urutan baru mereka (§3, §4). - Sisipkan
Viewerdi tempat Anda membangunnya, buatOpenDocumentasync, dan hapusInitCache()(§5, §6). - Jika Anda menggunakan web farm, lakukan §7 — satu-satunya bagian yang merupakan redesain bukan sekadar mengganti nama.
- Jika Anda mengonversi dokumen, lakukan §8.
- Lakukan §11 — perubahan sisi klien. Mereka adalah yang tidak akan mengumumkan diri.
- 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
202alih-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?