Lựa chọn SDK Doconut phù hợp: .NET Standard 2.1, .NET 6, hay .NET 8
Bắt đầu với môi trường chạy ứng dụng
Việc lựa chọn một gói Doconut bắt đầu với dự án sẽ chạy nó. Một ứng dụng web .NET 8 mới, một dịch vụ .NET 6 đã có, và một máy chủ ASP.NET Core tương thích có thể đều cần khả năng xem tài liệu nhúng, nhưng các ràng buộc framework và kế hoạch nâng cấp của chúng khác nhau.
Doconut cung cấp các lộ trình SDK hiện tại cho .NET 8, .NET 6 và các máy chủ tương thích tiêu thụ gói .NET Standard 2.1 mới. Lựa chọn đúng thường là gói khớp trực tiếp với môi trường chạy và để lại ít sự mơ hồ về framework nhất cho đội ngũ bảo trì ứng dụng.
tổng quan SDK Trình xem Doconut là điểm khởi đầu để hiểu khả năng sản phẩm. Sử dụng tài liệu riêng cho từng framework để đưa ra quyết định chọn gói.
Hiểu ý nghĩa của ba nhãn
.NET 8 và .NET 6 là các mục tiêu ứng dụng. Một ứng dụng web có thể nhắm mục tiêu một trong các runtime này và chọn gói Doconut tương ứng.
.NET Standard 2.1 lại khác: nó định nghĩa một hợp đồng API thư viện mà các môi trường .NET tương thích có thể tiêu thụ. Doconut 26.8.0 giới thiệu thế hệ Doconut.NETStandard hiện tại cho các ứng dụng nhắm mục tiêu .NET Core 3.0 trở lên, bao gồm .NET 5 đến .NET 8. Nó không thể được tiêu thụ bởi .NET Framework.
Sự khác biệt này giúp quyết định trở nên rõ ràng. Đừng chọn .NET Standard 2.1 chỉ vì nghe chung chung; hãy chọn nó khi hợp đồng này thực sự phù hợp với môi trường và cấu trúc giải pháp.
Bảng lựa chọn thực tiễn
| Tình huống ứng dụng | Đường dẫn Doconut để đánh giá | Lý do |
|---|---|---|
| Ứng dụng mới nhắm mục tiêu .NET 8 | Doconut.NET8 | Khớp trực tiếp với phát triển .NET hiện tại và lộ trình tài liệu .NET 8 đầy đủ. |
| Ứng dụng hiện có phải duy trì trên .NET 6 | Doconut.NET6 | Giữ mục tiêu môi trường chạy trong khi cung cấp các tính năng tiêm phụ thuộc, middleware, phiên làm việc bất đồng bộ và mô hình phân tán tùy chọn hiện tại. |
| Môi trường chạy ASP.NET Core tương thích yêu cầu hợp đồng .NET Standard | Doconut.NETStandard 26.8.0+ | Nhắm mục tiêu .NET Standard 2.1 và cung cấp tích hợp Doconut hiện tại cho các môi trường hỗ trợ. |
| Tích hợp Doconut.NETStandard 26.7.0 hoặc trước đó hiện có | Lên kế hoạch di chuyển trước khi chọn 26.8.0+ | ID gói vẫn giữ nguyên, nhưng mục tiêu và thế hệ API thay đổi. |
| Ứng dụng nhắm mục tiêu .NET Framework | Doconut.NETFramework | .NET Framework không thể tiêu thụ .NET Standard 2.1. |
Bảng này thu hẹp quyết định đầu tiên. Các yếu tố như giấy phép, plugin tùy chọn, định dạng tài liệu, thiết kế triển khai và nỗ lực nâng cấp vẫn cần được xác thực riêng.
Chọn Doconut.NET8 cho các ứng dụng .NET 8 mới
Đối với một ứng dụng .NET 8 mới, gói chuyên dụng là lựa chọn rõ ràng nhất để đánh giá. trang Trình xem .NET 8 mô tả mô hình hiện tại dựa trên tiêm phụ thuộc, tài nguyên được phục vụ qua middleware, phiên làm việc tài liệu bất đồng bộ và quy trình làm việc phân tán tùy chọn.
Một sự khớp runtime trực tiếp cũng giúp việc theo dõi tài liệu dễ dàng hơn. Việc cài đặt, cấu hình, khắc phục sự cố, plugin và mẫu có thể được đánh giá trong một lộ trình riêng cho framework.
Trước khi áp dụng, hãy kiểm tra các định dạng tài liệu và tính năng tùy chọn mà sản phẩm thực sự cần. Một sự khớp gói không thay thế các quyết định cấp ứng dụng về xác thực, ủy quyền, lưu trữ, giữ lại, giám sát và giới hạn tài nguyên.
Chọn Doconut.NET6 khi máy chủ phải ở lại .NET 6
Một ứng dụng đã được triển khai có thể có các phụ thuộc hoặc cam kết hỗ trợ khiến nó phải ở trên .NET 6. Trình xem .NET 6 đã cập nhật cho phép ứng dụng giữ lại mục tiêu đó trong khi chuyển sang kiến trúc tích hợp hiện tại của Doconut.
Điều này hữu ích khi việc nâng cấp runtime và di chuyển trình xem tài liệu không nên xảy ra trong cùng một phiên bản. Nhóm có thể hiện đại hoá việc đăng ký trình xem, cung cấp tài nguyên, mở không đồng bộ và các phiên tài liệu trong khi giữ cho khung nền tảng máy chủ ổn định.
Kiểm tra xem dự án hiện tại có sử dụng tích hợp Doconut .NET 6 cổ điển hay đã cập nhật hay không. Tên gói chỉ không nhất thiết cho biết thế hệ. Tài liệu di chuyển chính thức xác định các chữ ký API và mẫu lưu trữ phân biệt chúng.
Chọn Doconut.NETStandard khi hợp đồng phù hợp với giải pháp
Hướng dẫn cài đặt .NET Standard 2.1 mới hướng dẫn cài đặt .NET Standard 2.1 xác định ranh giới tương thích. Nó hỗ trợ các máy chủ .NET Core 3.0 trở lên, bao gồm .NET 5, 6, 7 và 8, và loại trừ .NET Framework.
Con đường này có thể hợp lý khi giải pháp đặc biệt yêu cầu hợp đồng thư viện .NET Standard. Lựa chọn phiên bản là quan trọng: Doconut.NETStandard 26.7.0 và các phiên bản trước nhắm tới .NET Standard 2.0 và sử dụng tích hợp trước, trong khi 26.8.0 và các phiên bản sau nhắm tới .NET Standard 2.1 với API hiện tại.
Nếu ứng dụng đã sử dụng thế hệ gói cũ, hãy tham khảo hướng dẫn di chuyển .NET Standard trước khi cập nhật. Thay đổi ảnh hưởng nhiều hơn việc biên dịch: khởi động, vòng đời trình xem, định tuyến tài nguyên, mở tài liệu, cấp phép, plugin và xuất bản phân tán có thể cần chú ý.
So sánh toàn bộ tác động lên ứng dụng
Một bằng chứng khái niệm nhỏ nên trả lời nhiều hơn “gói có được cài đặt không?” Đánh giá:
- Tương thích máy chủ: Xác nhận mục tiêu của ứng dụng và mọi dự án tham chiếu gói trình xem.
- Thế hệ tích hợp: Xác định đăng ký hiện tại hoặc cổ điển, tạo trình xem và mẫu mở tài liệu.
- Phạm vi tài liệu: Kiểm tra các tệp PDF, Office, CAD, hình ảnh, email hoặc y tế đại diện mà sản phẩm yêu cầu.
- Nhu cầu plugin: Xác thực các khả năng Tìm kiếm, Ghi chú, Chuyển đổi hoặc DICOM riêng lẻ khi chúng thuộc quy trình làm việc.
- Mô hình vận hành: Kiểm tra vòng đời phiên, bộ nhớ đệm, cung cấp tài nguyên, dọn dẹp và bất kỳ thiết kế nút đơn hoặc phân tán nào.
- Nỗ lực nâng cấp: Tách các thay đổi khung nền tảng khỏi các thay đổi Doconut để các lỗi dễ chẩn đoán hơn.
- Kiểm soát ứng dụng: Xác minh quyền truy cập, lưu trữ, giữ lại và hành vi cung cấp trong hệ thống xung quanh.
Ghi lại phiên bản gói và mục tiêu khung nền tảng cùng với mỗi kết quả. Điều này ngăn việc một bài kiểm tra thành công trên một đường SDK bị nhầm lẫn thành bằng chứng cho đường khác.
Làm rõ lựa chọn khung nền tảng
Một ghi chú kiến trúc tốt có thể ngắn gọn: nêu mục tiêu ứng dụng, gói Doconut đã chọn và phiên bản, các plugin yêu cầu, mô hình triển khai, và đường dẫn tài liệu đã sử dụng trong quá trình thực hiện. Bản ghi quyết định này giúp các nâng cấp sau này bắt đầu từ thực tế thay vì giả định dựa trên tên gói.
Đối với phát triển .NET 8 mới, bắt đầu với SDK .NET 8 chuyên dụng. Đối với ứng dụng vẫn ở .NET 6, đánh giá gói .NET 6 đã cập nhật. Sử dụng Doconut.NETStandard 26.8.0+ khi hợp đồng .NET Standard 2.1 là phù hợp cho máy chủ tương thích, và giữ các ứng dụng .NET Framework trên đường dẫn gói chuyên dụng của chúng.
Xem lại trung tâm tài liệu Doconut và tải bản dùng thử để thử nghiệm đường dẫn đã chọn với ứng dụng và tài liệu của bạn.