NuGet 警告 NU5048

The 'PackageIconUrl'/'iconUrl' element is deprecated. Consider using the 'PackageIcon'/'icon' element instead. Learn more at https://aka.ms/deprecateIconUrl

問題

圖示 URL 已被取代,有利於將圖示內嵌在 NuGet 套件內。 可能的原因包括:

  • 從 nuspec 檔案建立套件時,它會包含專案 <iconUrl/>
  • 從 MSBuild 專案檔建立封裝時,它會包含 <PackageIconUrl> 屬性。

解決方案

若要停止看到此警告,請將內嵌圖示新增至您的套件。

針對 MSBuild 項目檔,新增 <PackageIcon/> 屬性,如下所示:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
      ...
      <PackageIcon>icon.png</PackageIcon>
      ...
  </PropertyGroup>

  <ItemGroup>
      ...
      <None Include="images\icon.png" Pack="true" PackagePath=""/>
      ...
  </ItemGroup>
</Project>

針對 nuspec 檔案,新增指向 <icon/> 將成為套件圖示之檔案的專案:

<package>
  <metadata>
    ...
    <icon>images\icon.png</icon>
    ...
  </metadata>
  <files>
    ...
    <file src="..\icon.png" target="images\" />
    ...
  </files>
</package>

深入瞭解封裝圖示圖像檔