Pubblicare pacchetti in NuGet.org

  • Articolo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

NuGet.org è una gestione pacchetti che consente agli sviluppatori di condividere codice riutilizzabile. Un pacchetto NuGet è un file compresso con .nupkg estensione contenente codice compilato che può essere utilizzato in altri progetti. I pacchetti ospitati in NuGet.org sono disponibili per tutti gli sviluppatori in tutto il mondo.

Prerequisiti

  • Qualsiasi versione di Visual Studio 2019 e del carico di lavoro .NET Core.
  • dotnet CLI. Se non è già disponibile, installare .NET Core SDK.
  • Registrarsi per ottenere un account gratuito in nuget.org se non è già disponibile.

Creare un progetto

È possibile usare il proprio progetto .NET per compilare e generare un pacchetto NuGet oppure creare una nuova libreria di classi .NET di base come indicato di seguito:

  1. In Visual Studio selezionare File, Nuovo e quindi Progetto.

  2. Selezionare il modello Libreria di classi (.NET Standard) e selezionare Avanti.

  3. Assegnare un nome al progetto e alla soluzione e quindi selezionare un percorso per salvare il progetto in locale. Al termine, selezionare Crea .

    Creare un progetto di libreria di classi

La libreria di classi modello è sufficiente per creare un pacchetto NuGet, quindi per questa esercitazione si userà il modello esistente e non si scriverà codice aggiuntivo.

Configurare e generare un pacchetto

  1. Selezionare il progetto da Esplora soluzioni, fare clic con il pulsante destro del mouse e selezionare proprietà e quindi Pacchetto.

  2. Compilare il modulo e assicurarsi che l'ID del pacchetto sia univoco altrimenti potrebbe essere in conflitto con i pacchetti esistenti in NuGet.org. Una convenzione di denominazione comune è simile a Company.Product.Feature. Se si vuole generare il pacchetto ogni volta che si compila il progetto, selezionare la casella di controllo Genera pacchetto NuGet alla compilazione .

    Configurare le proprietà del pacchetto

  3. Selezionare il progetto da Esplora soluzioni, fare clic con il pulsante destro del mouse e quindi scegliere Pack per generare il .nupkg pacchetto.

    Genera pacchetto

  4. Controllare lo stato del comando pack nella finestra di output.

    Output del pacchetto

Generare una chiave API

Ora che è stato creato il nupkg pacchetto, è quasi possibile pubblicarlo, ma prima di tutto è necessario generare una chiave API per connettersi all'API NuGet.org.

  1. Accedere all'account NuGet.org o crearne uno, se non è stato fatto.

  2. Selezionare l'icona del nome utente e quindi chiavi API.

  3. Selezionare Crea e quindi immettere un nome per la chiave. Assegnare alla chiave un push di nuovi pacchetti e l'ambito della versione del pacchetto e immettere * nel campo modello glob per selezionare tutti i pacchetti. Al termine, selezionare Crea .

    Creare una chiave API

  4. Selezionare Copia e salvare la chiave API in una posizione sicura. Questa chiave sarà necessaria per pubblicare il pacchetto NuGet.

    Copiare la chiave API

Pubblicare un pacchetto in NuGet.org

È possibile pubblicare il pacchetto usando l'interfaccia utente Web, l'interfaccia della riga di comando dotnet o l'interfaccia della riga di comando di nuget.exe. Ci concentreremo sulla pubblicazione di pacchetti usando la riga di comando in questa sezione. A tale scopo, saranno necessari il nome del pacchetto, una chiave API e l'URL di origine.

  1. In un prompt dei comandi con privilegi elevati passare alla cartella contenente il nupkg pacchetto.

  2. Eseguire il comando seguente per pubblicare il pacchetto in NuGet.org. Sostituire i segnaposto con il nome del pacchetto e la chiave API.

    dotnet nuget push <packageName> --api-key <APIKey> --source https://api.nuget.org/v3/index.json

  3. L'output del comando precedente dovrebbe essere simile al seguente.

    Pubblicare l'output del pacchetto