Pakketten publiceren naar NuGet.org

  • Artikel

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

NuGet.org is een pakketbeheerder waarmee ontwikkelaars herbruikbare code kunnen delen. Een NuGet-pakket is een gecomprimeerd bestand met .nupkg extensie die gecompileerde code bevat die kan worden gebruikt in andere projecten. Pakketten die worden gehost in NuGet.org zijn beschikbaar voor alle ontwikkelaars over de hele wereld.

Vereisten

  • Elke versie van Visual Studio 2019 en de .NET Core-workload.
  • dotnet CLI. Als u deze nog niet hebt, installeert u de .NET Core SDK.
  • Registreer u voor een gratis account op nuget.org als u er nog geen hebt.

Een project maken

U kunt uw eigen .NET-project gebruiken om een NuGet-pakket te bouwen en te genereren, of als volgt een nieuwe .NET-basisklassebibliotheek maken:

  1. Selecteer in Visual Studio Bestand, Nieuw en vervolgens Project.

  2. Selecteer de sjabloon Class Library (.NET Standard) en selecteer Volgende.

  3. Geef uw project een naam en uw oplossing en selecteer vervolgens een locatie om het project lokaal op te slaan. Selecteer Maken wanneer u klaar bent.

    Een klassebibliotheekproject maken

De sjabloonklassebibliotheek is voldoende om een NuGet-pakket te maken, dus voor deze zelfstudie gebruiken we de bestaande sjabloon en schrijven we geen extra code.

Een pakket instellen en genereren

  1. Selecteer uw project in Solution Explorer, klik met de rechtermuisknop en selecteer eigenschappen en vervolgens Package.

  2. Vul het formulier in en zorg ervoor dat uw pakket-id uniek is, anders kan dit conflicteren met bestaande pakketten op NuGet.org. Een algemene naamconventie is bijvoorbeeld: Company.Product.Feature. Als u uw pakket elke keer wilt genereren wanneer u uw project bouwt, schakelt u het selectievakje NuGet genereren in voor build .

    Pakketeigenschappen configureren

  3. Selecteer uw project in Solution Explorer en klik met de rechtermuisknop op Pack om uw .nupkg pakket te genereren.

    Pakket genereren

  4. Controleer de status van de opdracht Pack in het uitvoervenster.

    Uitvoer van pakket

Een API-sleutel genereren

Nu we ons nupkg pakket hebben gemaakt, zijn we bijna klaar om het te publiceren, maar eerst moeten we een API-sleutel genereren om verbinding te maken met de NuGet.org-API.

  1. Meld u aan bij uw NuGet.org-account of maak er een als u dat nog niet hebt gedaan.

  2. Selecteer uw gebruikersnaampictogram en selecteer VERVOLGENS API-sleutels.

  3. Selecteer Maken en voer een naam in voor uw sleutel. Geef uw sleutel een push nieuwe pakketten en pakketversiebereik en voer * in het veld glob-patroon in om alle pakketten te selecteren. Selecteer Maken wanneer u klaar bent.

    API-sleutel maken

  4. Selecteer Kopiëren en sla uw API-sleutel op een veilige locatie op. We hebben deze sleutel nodig om ons NuGet-pakket te publiceren.

    API-sleutel kopiëren

Een pakket publiceren naar NuGet.org

U kunt uw pakket publiceren met behulp van de webgebruikersinterface, dotnet CLI of nuget.exe CLI. We richten ons op het publiceren van pakketten met behulp van de opdrachtregel in deze sectie. Hiervoor hebt u de naam van uw pakket, een API-sleutel en de bron-URL nodig.

  1. Navigeer in een opdrachtprompt met verhoogde bevoegdheid naar de map met het nupkg pakket.

  2. Voer de volgende opdracht uit om uw pakket te publiceren naar NuGet.org. Vervang de tijdelijke aanduidingen door uw pakketnaam en API-sleutel.

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

  3. De uitvoer van de vorige opdracht moet er ongeveer als volgt uitzien.

    Pakketuitvoer publiceren