NuGet 警告 NU5128

[アーティクル]
08/16/2024

シナリオ 1

nuspec ファイルの依存関係グループで宣言されているターゲットフレームワークと、lib/ref フォルダ内の対応するターゲットフレームワークが完全に一致していません。以下のアクションのリストをご覧ください。

.NETStandard2.0 の依存関係グループを nuspec に追加します。

問題点

lib/<tfm>/パッケージ内のディレクトリref/<tfm>/に、警告メッセージで指定されたターゲットフレームワークモニカー (TFM) のファイルが少なくとも 1 つ含まれています。ただし、この TFM では、nuspecファイル内に依存関係グループは存在しません。これにより、パッケージのコンシューマーは、パッケージに依存関係がない場合でも、パッケージが TFM と互換性がないと考える可能性があります。パッケージに未宣言の依存関係がある場合、パッケージを使用しているプロジェクトでは実行時エラーが発生します。

解決策

プロジェクト内で NuGet のパックターゲットを実行する

可能であれば、NuGet の MSBuild パックターゲットを使用します。これは、プロジェクトのターゲットフレームワークの依存関係グループを持つアセンブリ TFM と自動的に一致します。プロジェクトは、それぞれの NuGet 依存関係で PackageReference を使用する必要があります。プロジェクトで packages.config を使用する場合は、nuget.exe packおよびnuspecファイルを使用する必要があります。

手動で編集した nuspec ファイル

カスタム nuspec ファイルを使用していれば、依存関係が次の互換性のある TFM と同じである場合でも、lib/ または ref/ のアセンブリが存在する各 TFM に一致する依存関係グループを含めることをおすすめします。例えば、パッケージ内にnetstandard1.0およびnetstandard2.0アセンブリーが含まれており、依存関係が両方とも同じである場合は、重複する依存関係項目を「依存関係グループ」として、両方のTFM をリスト表示できます。

ノート: アセンブリパスで使用される TFM 識別子は、依存関係グループで使用される TFM 識別子とは異なる形式を使用します。警告メッセージでは、依存関係グループ内で使用するために、適切な名前を特定します。パッケージに、そのターゲットフレームワークでの依存関係がまったくない場合は、空のグループを使用します。次に例を示します。

<package>
  <metadata>
    ...
    <dependencies>
      <group targetFramework=".NETFramework4.7.2" />
    </dependencies>
  </metadata>
  ...
</package>

lib/またはref/ファイルを削除

報告された TFM とパッケージが互換性を持たないようにするには、その TFM のパッケージにlib/<tfm>/またはref/<tfm>/ファイルが含まれないように、プロジェクトを変更します。例えば、.NETFramework4.7.2の依存関係グループをnuspecに追加するように警告で表示されている場合は、お使いのパッケージから任意のlib/net472/*およびref/net472/*ファイルを削除します。

シナリオ 2

nuspec ファイルの依存関係グループで宣言されているターゲットフレームワークと、lib/ref フォルダ内の対応するターゲットフレームワークが完全に一致していません。以下のアクションのリストをご覧ください。

netstandard2.0 ターゲットフレームワークの lib アセンブリまたは ref アセンブリを追加する

問題点

このnuspecファイルには、報告されたターゲットフレームワークモニカー (TFM) の依存関係グループがありますが、lib/またはref/のいずれかにこの TFM のアセンブリは存在しません。互換性のある TFM のアセンブリがある場合、パッケージは引き続きインストールされますが、コンパイル時に使用されるアセンブリの依存関係が正しくなく、ランタイムでプロジェクトが失敗する可能性があります。

解決策

プロジェクト内で NuGet のパックターゲットを実行する

ファイルを手動で編集するnuspec

レポートされた TFM をプロジェクトのコンパイル対象となる追加のターゲットフレームワークとして追加し、アセンブリをパッケージに追加。 SDK スタイルプロジェクトを使用して複数の TFM を複数ターゲットにしている場合、NuGet の MSBuild パックターゲットは、適切な lib/<tfm>/ フォルダーにアセンブリを自動追加、適切なTFM と依存関係を持つ依存関係グループを作成できます。 SDK 以外のスタイルのプロジェクトを使用していれば、追加のTFM 用に追加のプロジェクトファイルを作成し、パッケージ内の正しい場所に出力アセンブリをコピーするようにnuspecファイルを変更する必要があります。

空の _._ ファイル追加

パッケージにメタパッケージなどのアセンブリが含まれていなければ、警告メッセージに記載されている TFM のlib/<tfm>/ディレクトリに空の_._ファイルを追加することを検討してください。例えば、netstandard2.0ターゲットフレームワークのアセンブリを追加するように警告が表示された場合は、パッケージに空Empty lib/netstandard2.0/_._ のファイルを作成します。

依存関係グループを削除する

カスタム nuspec ファイルを使用する場合は、報告された TFM の依存関係グループを削除し、lib/<tfm>/かref/<tfm>/ ファイルが存在する TFM の依存関係グループのみを残します。

アセンブリに関連しないパッケージのすべての依存関係を削除する

パッケージにlib/かref/ のファイルが含まれていず、メタパッケージでない場合は、パッケージコンシューマーに必要な依存関係がない可能性があります。 NuGet の MSBuild Pack ターゲットを使用してパックする場合は、プロジェクトファイル内の任意のPropertyGroupファイルに<SuppressDependenciesWhenPacking>true</SuppressDependenciesWhenPacking>を設定できます。カスタム nuspec ファイルを使用していれば、<dependencies>要素を削除します。

その他のシナリオ

この警告は NuGet 5.3 の開発中に追加され、最初は .NET Core SDK 3.0 プレビュー 9 で使用できます。 NuGet/Home#8583 は、多すぎるシナリオで警告が発生していた課題を追跡します。 NoWarnMSBuild プロパティを使用できます (プロジェクトファイル内の任意のPropertyGroupに<NoWarn>$(NoWarn);NU5128</NoWarn>を追加します)。影響を受けるプロジェクトが複数ある場合は、すべてのプロジェクトにNoWarnを自動的に追加するためにDirectory.Build.targetsを使用できます。

次の方法で共有

NuGet 警告 NU5128

シナリオ 1

問題点

解決策

シナリオ 2

問題点

解決策

フィードバック

その他のリソース