NuGet paket türü ayarlama

Paketler, kullanım amacını belirtmek için bir paket türü daha ile işaretlenebilir.

Bilinen paket türleri

• Dependency tür paketleri kitaplıklara ve uygulamalara derleme veya çalışma zamanı varlıkları ekler ve herhangi bir proje türüne yüklenebilir (uyumlu oldukları varsayılarak).

• DotnetTool tür paketleri , dotnet CLI tarafından yüklenebilen .NET araçlarıdır.

• MSBuildSdk tür paketleri, yazılım geliştirme setlerini kullanmayı kolaylaştıran MSBuild proje SDK'larıdır .

• Template tür paketleri uygulama, hizmet, araç veya sınıf kitaplığı gibi dosyalar veya projeler oluşturmak için kullanılabilecek özel şablonlar sağlar.

• McpServer tür paketleri MCP sunucuları içerir. Bu paket türüne DotnetTool paket türü her zaman eşlik eder, çünkü yerel bir MCP sunucusu .NET aracı olarak dağıtılır. MCP sunucusu ve NuGet hakkında bilgi için bkz. NuGet paketlerinde MCP sunucuları.

NuGet'in önceki sürümleriyle oluşturulan tüm paketler de dahil olmak üzere bir türle işaretlenmemiş paketler, varsayılan olarak türü olarak Dependency kullanılır.

Note

NuGet 3.5'te paket türleri desteği eklendi. Özel paket türüne ihtiyacınız yoksa, paket türünü açıkça ayarlamamak en iyisidir. NuGet, hiçbir tür belirtilmediğinde varsayılan olarak Dependency türünü kullanır.

Özel paket türleri

Kullanımı bilinen paket türlerine uymuyorsa paketinizi bir veya daha fazla özel paket türüyle işaretleyebilirsiniz.

Örneğin, uygulama müşterilerinin Contoso uzantıları yükleyebileceğini düşünün. Uygulama, uzantı yazarlarının paketlerini gerekli kurallara uygun uzantılar olarak tanımlamak için özel paket türünü ContosoExtension kullanmasını gerektirebilir.

Warning

Özel paket türüne sahip bir paket Visual Studio veya nuget.exetarafından yüklenemez. Daha fazla bilgi için bkz. NuGet/Home#10468 .

dotnet CLI kullanma

Paket türleri proje dosyasında ayarlanabilir (.csproj):

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

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

</Project>

Birden çok amaçlanan kullanımı olan paketler sınırlayıcı kullanılarak ; birden çok paket türüyle işaretlenebilir:

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

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

</Project>

Paket türleri, paket türü ile , dizesi arasında bir Version sınırlayıcı kullanılarak sürüm oluşturulabilir:

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

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

</Project>

Nuget.exe kullanma

Paket türleri, .nuspec elementi altındaki bir packageTypes\packageType düğümünde bulunan <metadata> dosyasında ayarlanır.

<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2010/07/nuspec.xsd">
    <metadata>
        <!-- ... -->
        <packageTypes>
            <packageType name="ContosoExtension" />
        </packageTypes>
    </metadata>
</package>

Birden çok amaçlanan kullanımı olan paketler birden çok paket türüyle işaretlenebilir:

<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2010/07/nuspec.xsd">
    <metadata>
        <!-- ... -->
        <packageTypes>
            <packageType name="PackageType1" />
            <packageType name="PackageType2" />
        </packageTypes>
    </metadata>
</package>

Paket türleri bir Version dize kullanılarak sürümleştirilebilir:

<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2010/07/nuspec.xsd">
    <metadata>
        <!-- ... -->
        <packageTypes>
            <packageType name="PackageType1" version="1.0.0.0" />
            <packageType name="PackageType2" />
        </packageTypes>
    </metadata>
</package>

Paket türü dizesinin biçimi tam olarak paket kimliğine benzer. Yani paket türü, en az bir karakter ve en çok 100 karakter içeren normal ifadeyle ^\w+([_.-]\w+)*$ eşleşen büyük/küçük harfe duyarlı olmayan bir dizedir.

Sağlanırsa, paket türü sürümü bir Version dizedir. Paket türü sürümü isteğe bağlıdır ve varsayılan olarak olarak 0.0ayarlanır.