適切な Doconut SDK の選び方：.NET Standard 2.1、.NET 6、または .NET 8
アプリケーションホストから始める
Doconut パッケージの選択は、それを実行するプロジェクトから始まります。新しい .NET 8 Web アプリケーション、既存の .NET 6 サービス、そしてライブラリ互換の ASP.NET Core ホストはすべて埋め込みドキュメントビューイングが必要になる可能性がありますが、フレームワークの制約やアップグレード計画は異なります。
Doconut は .NET 8、.NET 6、そして新しい .NET Standard 2.1 パッケージを利用できる互換ホスト向けの最新 SDK パスを提供しています。適切な選択は通常、ホストと直接一致し、アプリケーションを保守するチームにとってフレームワークの曖昧さが最小になるパッケージです。
製品機能の出発点はDoconut Viewer SDK の概要です。フレームワーク固有のドキュメントを使用してパッケージの決定を行ってください。
3つのラベルが何を意味するかを理解する
.NET 8 と .NET 6 はアプリケーションのターゲットです。Web アプリケーションはこれらのランタイムのいずれかを対象にし、対応する Doconut パッケージを選択できます。
.NET Standard 2.1 は異なります。これは、互換性のある .NET ホストが利用できるライブラリ API 契約を定義します。Doconut 26.8.0 は、.NET Core 3.0 以降（.NET 5 から .NET 8 を含む）を対象としたアプリケーション向けに現在の Doconut.NETStandard 世代を導入しています。.NET Framework では利用できません。
この区別により、判断が明確になります。.NET Standard 2.1 がより汎用的に聞こえるからといって選んではいけません。その契約がホストやソリューション構造に適合する場合にのみ選択してください。
実用的な選択表
| アプリケーションの状況 | 評価すべき Doconut パス | 理由 |
|---|---|---|
| .NET 8 を対象とした新規アプリケーション | Doconut.NET8 | 現在の .NET 開発に直接一致し、完全な .NET 8 ドキュメントパスを提供します。 |
| .NET 6 に留まらなければならない既存アプリケーション | Doconut.NET6 | ホストのターゲットを維持しつつ、現在の依存性注入、ミドルウェア、非同期セッション、オプションの分散モデルを提供します。 |
| .NET Standard 契約が必要な互換性のある ASP.NET Core ホスト | Doconut.NETStandard 26.8.0+ | .NET Standard 2.1 を対象とし、サポートされているホスト向けに現在の Doconut 統合を提供します。 |
| 既存の Doconut.NETStandard 26.7.0 以前の統合 | 26.8.0+ を選択する前に移行計画を立てる | パッケージ ID は同じままですが、ターゲットと API 世代が変更されます。 |
| .NET Framework を対象としたアプリケーション | Doconut.NETFramework | .NET Framework は .NET Standard 2.1 を利用できません。 |
この表は最初の判断を絞り込みます。ライセンス、オプションプラグイン、ドキュメント形式、デプロイ設計、アップグレード作業は別途検証が必要です。
新しい .NET 8 アプリケーションには Doconut.NET8 を選択する
新しい .NET 8 アプリケーションでは、専用パッケージが最も明確な選択肢です。.NET 8 ビューアページ では、依存性注入、ミドルウェア提供リソース、非同期ドキュメントセッション、オプションの分散ワークフローに基づく現在のモデルが説明されています。
直接的なランタイムの一致により、ドキュメントの追従が容易になります。インストール、構成、トラブルシューティング、プラグイン、サンプルはすべて、1 つのフレームワーク固有のパス内で評価できます。
導入前に、製品が実際に必要とするドキュメント形式とオプション機能をテストしてください。パッケージの一致は、認証、認可、ストレージ、保持、監視、リソース制限といったアプリケーションレベルの決定を代替するものではありません。
ホストが .NET 6 に留まる必要がある場合は Doconut.NET6 を選択
既存のアプリケーションは、.NET 6 に留まる必要がある依存関係やサポートの約束がある場合があります。 更新された .NET 6 ビューア は、ホストフレームワークを安定させたまま、Doconut の最新統合アーキテクチャへ移行できるようにします。
ランタイムのアップグレードとドキュメントビューアの移行を同じリリースで行うべきでない場合に便利です。チームは、ビューアの登録、リソース配信、非同期オープン、ドキュメントセッションを近代化しつつ、ホストフレームワークを安定させたままにできます。
既存プロジェクトが従来の Doconut .NET 6 統合か、更新版かを確認してください。パッケージ名だけでは世代が判別できないことがあります。公式の移行ドキュメントでは、API シグネチャとホスティングパターンが区別できるように示されています。
ソリューションに契約が合致する場合は Doconut.NETStandard を選択
新しい .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 移行ガイド を参照してください。変更はコンパイルだけでなく、起動、ビューアのライフタイム、リソースルーティング、ドキュメントオープン、ライセンス、プラグイン、分散パブリッシングにも影響します。
完全なアプリケーションへの影響を比較
小規模な概念実証は「パッケージはインストールできるか？」以上の答えを提供すべきです。評価項目:
- ホスト互換性: アプリケーションのターゲットと、ビューアパッケージを参照しているすべてのプロジェクトを確認します。
- 統合世代: 現在または従来の登録、ビューア作成、ドキュメントオープン パターンを特定します。
- ドキュメント カバレッジ: 製品で必要とされる代表的な PDF、Office、CAD、画像、メール、医療ファイルをテストします。
- プラグイン要件: ワークフローに含まれる場合、Search、Annotation、Converter、または DICOM 機能を個別に検証します。
- 運用モデル: セッションの寿命、キャッシュ、リソース配信、クリーンアップ、単一ノードまたは分散設計のいずれかをテストします。
- アップグレード工数: フレームワークの変更と Doconut の変更を分離し、障害の診断を容易にします。
- アプリケーション制御: 周辺システムにおけるアクセス、保存、保持、配信の動作を検証します。
各結果とともにパッケージバージョンとフレームワークターゲットを記録してください。これにより、ある SDK パスでの成功テストが別のパスに関する証拠と誤解されることを防げます。
フレームワークの選択を明示的にする
良いアーキテクチャノートは簡潔で構いません。アプリケーションのターゲット、選択した Doconut パッケージとバージョン、必要なプラグイン、デプロイモデル、実装時に使用したドキュメントパスを記載します。この決定記録は、後のアップグレードがパッケージ名の推測ではなく事実に基づいて開始できるようにします。
新規の .NET 8 開発では専用の .NET 8 SDK から始めます。 .NET 6 に留まるアプリケーションは更新された .NET 6 パッケージを評価してください。互換性のあるホストに対して .NET Standard 2.1 契約が適切な場合は Doconut.NETStandard 26.8.0 以上を使用し、.NET Framework アプリケーションは専用パッケージパスを維持します。
Doconut ドキュメントハブ と トライアルをダウンロード を確認し、選択したパスを自分のアプリケーションとドキュメントでテストしてください。