Mengatur jenis paket NuGet

Paket dapat ditandai dengan satu lagi jenis paket untuk menunjukkan penggunaan yang dimaksudkan.

Jenis paket yang diketahui

  • Dependency paket jenis menambahkan aset build atau run-time ke pustaka dan aplikasi, dan dapat diinstal dalam jenis proyek apa pun (dengan asumsi aset tersebut kompatibel).

  • DotnetTool jenis paket adalah alat .NET yang dapat diinstal oleh dotnet CLI.

  • MSBuildSdk paket jenis adalah SDK proyek MSBuild yang menyederhanakan penggunaan kit pengembangan perangkat lunak.

  • Template paket jenis menyediakan templat kustom yang dapat digunakan untuk membuat file atau proyek seperti aplikasi, layanan, alat, atau pustaka kelas.

  • McpServer jenis paket berisi server MCP. Jenis paket ini selalu disertai dengan DotnetTool jenis paket, karena server MCP lokal didistribusikan sebagai alat .NET. Untuk informasi tentang server MCP dan NuGet, lihat Server MCP dalam paket NuGet.

Paket yang tidak ditandai dengan jenis, termasuk semua paket yang dibuat dengan versi NuGet sebelumnya, secara default menjadi jenis Dependency.

Note

Dukungan untuk jenis paket ditambahkan di NuGet 3.5. Jika Anda tidak memerlukan jenis paket kustom, yang terbaik adalah tidak secara eksplisit mengatur jenis paket. NuGet mengatur default ke jenis Dependency ketika tidak ada jenis yang ditentukan.

Jenis paket kustom

Anda dapat menandai paket Anda dengan satu atau beberapa jenis paket kustom jika penggunaannya tidak sesuai dengan jenis paket yang diketahui.

Misalnya, bayangkan pelanggan Contoso aplikasi dapat menginstal ekstensi. Aplikasi ini dapat memerlukan penulis ekstensi untuk menggunakan jenis ContosoExtension paket kustom untuk mengidentifikasi paket mereka sebagai ekstensi yang tepat yang mengikuti konvensi yang diperlukan.

Warning

Paket dengan jenis paket kustom tidak dapat diinstal oleh Visual Studio atau nuget.exe. Lihat NuGet/Home#10468 untuk informasi selengkapnya.

Jenis paket dapat diatur dalam file proyek (.csproj):

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net5.0</TargetFramework>
    
    <PackageType>ContosoExtension</PackageType>
  </PropertyGroup>

</Project>

Paket dengan beberapa penggunaan yang dimaksudkan dapat ditandai dengan beberapa jenis paket menggunakan pemisah ; :

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net5.0</TargetFramework>
    
    <PackageType>PackageType1;PackageType2</PackageType>
  </PropertyGroup>

</Project>

Jenis paket dapat diberi versi menggunakan pemisah , antara jenis paket dan stringnya Version :

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net5.0</TargetFramework>
    
    <PackageType>PackageType1, 1.0.0.0;PackageType2</PackageType>
  </PropertyGroup>

</Project>

Format string jenis paket persis seperti ID paket. Artinya, jenis paket adalah string yang tidak peka terhadap huruf besar atau kecil, cocok dengan ekspresi reguler ^\w+([_.-]\w+)*$, yang memiliki setidaknya satu karakter dan paling banyak 100 karakter.

Jika disediakan, versi jenis paket adalah Version string. Jenis versi paket opsional dan secara default adalah 0.0.

  • Last updated on