Impostare un tipo di pacchetto NuGet

I pacchetti possono essere contrassegnati con uno più tipi di pacchetto per indicare l'uso previsto.

Tipi di pacchetto noti

• I pacchetti di tipo Dependency aggiungono asset in fase di compilazione o di esecuzione ad applicazioni e librerie e possono essere installati in qualsiasi tipo di progetto, presupponendo che siano compatibili.

• DotnetTool i pacchetti di tipo sono strumenti .NET che possono essere installati dall'interfaccia della riga di comando dotnet.

• MSBuildSdk i pacchetti di tipo sono SDK di progetto MSBuild che semplificano l'uso di software development kit.

• Template I pacchetti di tipo forniscono modelli personalizzati che possono essere usati per creare file o progetti come un'app, un servizio, uno strumento o una libreria di classi.

I pacchetti non contrassegnati con un tipo, inclusi tutti i pacchetti creati con versioni precedenti di NuGet, usano il tipo Dependency per impostazione predefinita.

Nota

Il supporto per i tipi di pacchetto è stato aggiunto in NuGet 3.5. Se non è necessario un tipo di pacchetto personalizzato, è consigliabile non impostare in modo esplicito il tipo di pacchetto. Per impostazione predefinita, NuGet viene impostato sul Dependency tipo quando non viene specificato alcun tipo.

Tipi di pacchetto personalizzati

È possibile contrassegnare il pacchetto con uno o più tipi di pacchetto personalizzati se l'uso non rientra nei tipi di pacchetto noti.

Si supponga, ad esempio, che i clienti dell'app Contoso possano installare le estensioni. L'app potrebbe richiedere agli autori di estensioni di usare il tipo di ContosoExtension pacchetto personalizzato per identificare i pacchetti come estensioni appropriate che seguono le convenzioni necessarie.

Avviso

Non è possibile installare un pacchetto con un tipo di pacchetto personalizzato da Visual Studio o da nuget.exe. Per altre informazioni, vedere NuGet/Home#10468 .

Uso dell'interfaccia della riga di comando dotnet

I tipi di pacchetto possono essere impostati nel file di progetto (.csproj):

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

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

</Project>

I pacchetti con più usi previsti possono essere contrassegnati con più tipi di pacchetto usando il ; delimitatore:

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

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

</Project>

I tipi di pacchetto possono essere versionati usando un , delimitatore tra il tipo di pacchetto e la relativa Version stringa:

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

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

</Project>

Uso di nuget.exe

I tipi di pacchetto vengono impostati nel .nuspec file all'interno di un packageTypes\packageType nodo sotto l'elemento <metadata> :

<?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>

I pacchetti con più usi previsti possono essere contrassegnati con più tipi di pacchetto:

<?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>

È possibile eseguire il controllo delle versioni dei tipi di pacchetto usando una Version stringa:

<?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>

Il formato di una stringa del tipo di pacchetto è esattamente simile a un ID pacchetto. Ovvero, un tipo di pacchetto è una stringa senza distinzione tra maiuscole e minuscole corrispondente all'espressione ^\w+([_.-]\w+)*$ regolare con almeno un carattere e al massimo 100 caratteri.

Se specificato, la versione del tipo di pacchetto è una Version stringa. La versione del tipo di pacchetto è facoltativa e per impostazione predefinita è 0.0.