การเลือก 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 เป็นเป้าหมายของแอปพลิเคชัน แอปพลิเคชันเว็บสามารถมุ่งเป้าไปที่หนึ่งใน runtime เหล่านี้และเลือกแพ็กเกจ 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 Viewer อธิบายโมเดลปัจจุบันที่อิงจากการฉีดพึ่งพา, ทรัพยากรที่ให้บริการโดยมิดเดิลแวร์, เซสชันเอกสารแบบอะซิงโครนัส, และเวิร์กโฟลว์กระจายที่เป็นตัวเลือก

การตรงกับ runtime อย่างตรงไปตรงมาช่วยให้การติดตามเอกสารง่ายขึ้น การติดตั้ง, การกำหนดค่า, การแก้ไขปัญหา, ปลั๊กอิน, และตัวอย่างทั้งหมดสามารถประเมินได้ในเส้นทางที่เจาะจงเฟรมเวิร์กเดียว

ก่อนนำไปใช้ ให้ทดสอบรูปแบบเอกสารและคุณลักษณะตัวเลือกที่ผลิตภัณฑ์ต้องการจริง การตรงกับแพ็กเกจไม่ได้แทนที่การตัดสินใจระดับแอปพลิเคชันเกี่ยวกับการตรวจสอบสิทธิ์, การให้สิทธิ์, การจัดเก็บ, การเก็บรักษา, การตรวจสอบ, และขีดจำกัดของทรัพยากร.

เลือก Doconut.NET6 เมื่อโฮสต์ต้องคงอยู่บน .NET 6

แอปพลิเคชันที่มีอยู่แล้วอาจมีการพึ่งพาหรือข้อผูกมัดการสนับสนุนที่ทำให้ต้องคงอยู่บน .NET 6. ตัวดู .NET 6 ที่อัปเดต (ตัวดู .NET 6 ที่อัปเดต) ทำให้แอปพลิเคชันคงเป้าหมายนั้นไว้ขณะย้ายไปยังสถาปัตยกรรมการรวมของ Doconut ปัจจุบัน

นี่เป็นประโยชน์เมื่อการอัปเกรด runtime และการย้ายตัวดูเอกสารไม่ควรเกิดขึ้นในรุ่นเดียวกัน ทีมงานสามารถปรับปรุงการลงทะเบียนตัวดู, การส่งมอบทรัพยากร, การเปิดแบบอะซิงโครนัส, และเซสชันเอกสารได้ขณะคงเฟรมเวิร์กโฮสต์ให้เสถียร

ตรวจสอบว่าโครงการที่มีอยู่ใช้การรวม Doconut .NET 6 แบบคลาสสิกหรือแบบอัปเดตหรือไม่ ชื่อแพ็กเกจอย่างเดียวอาจไม่บ่งบกรุ่นได้ เอกสารการย้ายอย่างเป็นทางการระบุลายเซ็น API และรูปแบบการโฮสต์ที่แยกแยะได้

เลือก Doconut.NETStandard เมื่อสัญญาเข้ากับโซลูชัน

คู่มือการติดตั้ง .NET Standard 2.1 (คู่มือการติดตั้ง .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 (คู่มือการย้าย .NET Standard) ก่อนอัปเดต การเปลี่ยนแปลงส่งผลเกินกว่าการคอมไพล์: การเริ่มต้น, อายุการใช้งานของตัวดู, การกำหนดเส้นทางทรัพยากร, การเปิดเอกสาร, การให้ลิขสิทธิ์, ปลั๊กอิน, และการเผยแพร่แบบกระจายอาจต้องการความสนใจ

เปรียบเทียบผลกระทบต่อแอปพลิเคชันทั้งหมด

การพิสูจน์แนวคิดขนาดเล็กควรตอบได้มากกว่า “แพ็กเกจติดตั้งได้หรือไม่?” ประเมิน:

1. ความเข้ากันได้ของโฮสต์: ยืนยันเป้าหมายของแอปพลิเคชันและทุกโครงการที่อ้างอิงแพ็กเกจตัวดู
2. รุ่นการรวม: ระบุการลงทะเบียนแบบปัจจุบันหรือแบบคลาสสิก, การสร้างตัวดู, และรูปแบบการเปิดเอกสาร
3. การครอบคลุมเอกสาร: ทดสอบไฟล์ PDF, Office, CAD, รูปภาพ, อีเมล หรือไฟล์ทางการแพทย์ที่เป็นตัวอย่างที่ผลิตภัณฑ์ต้องการ
4. ความต้องการปลั๊กอิน: ตรวจสอบความสามารถของ Search, Annotation, Converter หรือ DICOM แยกกันเมื่อเป็นส่วนของกระบวนการทำงาน
5. โมเดลการทำงาน: ทดสอบอายุการใช้งานของเซสชัน, การแคช, การส่งทรัพยากร, การทำความสะอาด, และการออกแบบแบบโหนดเดียวหรือแบบกระจาย
6. ความพยายามในการอัปเกรด: แยกการเปลี่ยนแปลงของเฟรมเวิร์กออกจากการเปลี่ยนแปลงของ Doconut เพื่อให้การวินิจฉัยข้อผิดพลาดง่ายขึ้น
7. การควบคุมแอปพลิเคชัน: ตรวจสอบการเข้าถึง, การจัดเก็บ, การเก็บรักษา, และพฤติกรรมการส่งมอบในระบบโดยรอบ

บันทึกเวอร์ชันแพ็กเกจและเป้าหมายเฟรมเวิร์กพร้อมกับผลลัพธ์แต่ละรายการ สิ่งนี้จะป้องกันไม่ให้การทดสอบสำเร็จบนเส้นทาง SDK หนึ่งถูกตีความเป็นหลักฐานสำหรับเส้นทางอื่น

ทำให้การเลือกเฟรมเวิร์กชัดเจน

บันทึกสถาปัตยกรรมที่ดีสามารถสั้น ๆ ได้: ระบุเป้าหมายของแอปพลิเคชัน, แพ็กเกจและเวอร์ชัน Doconut ที่เลือก, ปลั๊กอินที่ต้องการ, โมเดลการปรับใช้, และเส้นทางเอกสารที่ใช้ระหว่างการดำเนินการ บันทึกการตัดสินใจนี้ช่วยให้การอัปเกรดในภายหลังเริ่มจากข้อเท็จจริงแทนการสันนิษฐานจากชื่อแพ็กเกจ

สำหรับการพัฒนา .NET 8 ใหม่ ให้เริ่มด้วย .NET 8 SDK เฉพาะทาง สำหรับแอปพลิเคชันที่คงอยู่บน .NET 6 ให้ประเมินแพ็กเกจ .NET 6 ที่อัปเดต ใช้ Doconut.NETStandard 26.8.0+ เมื่อสัญญา .NET Standard 2.1 เป็นตัวเลือกที่เหมาะสมสำหรับโฮสต์ที่เข้ากันได้ และให้แอปพลิเคชัน .NET Framework อยู่บนเส้นทางแพ็กเกจเฉพาะของพวกมัน

ตรวจสอบศูนย์เอกสาร Doconut (ศูนย์เอกสาร Doconut) และดาวน์โหลดรุ่นทดลอง (ดาวน์โหลดรุ่นทดลอง) เพื่อทดสอบเส้นทางที่เลือกกับแอปพลิเคชันและเอกสารของคุณเอง.