Menerbitkan paket ke NuGet.org

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

NuGet.org adalah manajer paket yang memungkinkan pengembang berbagi kode yang dapat digunakan kembali. Paket NuGet adalah file terkompresi dengan ekstensi .nupkg yang berisi kode yang dikompilasi yang dapat digunakan dalam proyek lain. Paket yang dihosting di NuGet.org tersedia untuk semua pengembang di seluruh dunia.

Prasyarat

• Versi apa pun dari Visual Studio 2019 dan beban kerja .NET Core.
• dotnet CLI. Jika Anda belum memilikinya, instal .NET Core SDK.
• Daftarkan akun gratis di nuget.org jika Anda belum memilikinya.

Membuat proyek

Anda dapat menggunakan proyek .NET Anda sendiri untuk membangun dan menghasilkan paket NuGet, atau membuat pustaka kelas .NET dasar baru sebagai berikut:

1. Di Visual Studio, pilih File, Baru, lalu Project.

2. Pilih templat Pustaka Kelas (.NET Standard) dan pilih Berikutnya.

3. Beri nama proyek Anda dan solusi Anda lalu pilih lokasi untuk menyimpan proyek secara lokal. Pilih Buat setelah selesai.

   

Pustaka kelas templat cukup untuk membuat paket NuGet sehingga untuk tutorial ini kami akan menggunakan templat yang ada dan kami tidak akan menulis kode tambahan apa pun.

Menyiapkan dan menghasilkan paket

1. Pilih proyek Anda dari penjelajah solusi, klik kanan dan pilih properti lalu Paket.

2. Isi formulir dan pastikan id paket Anda unik jika tidak, mungkin bertentangan dengan paket yang ada di NuGet.org. Konvensi penamaan umum adalah sesuatu seperti: Company.Product.Feature. Jika Anda ingin membuat paket setiap kali membuat proyek, pilih kotak centang Hasilkan paket NuGet pada build.

   

3. Pilih proyek Anda dari penjelajah solusi, klik kanan lalu pilih Pack untuk menghasilkan paket .nupkg Anda.

   paket

4. Periksa status perintah paket di jendela output.

   

Membuat kunci API

Sekarang setelah kami membuat paket nupkg, kami hampir siap untuk menerbitkannya, tetapi pertama-tama kita perlu membuat kunci API untuk terhubung ke API NuGet.org.

1. Masuk ke akun NuGet.org Anda atau buat akun jika Anda belum melakukannya.

2. Pilih ikon nama pengguna Anda lalu pilih Kunci API .

3. Pilih Buat lalu masukkan nama untuk kunci Anda. Berikan kunci Anda Mendorong paket baru dan versi paket cakupan, dan masukkan * di bidang pola glob untuk memilih semua paket. Pilih Buat setelah selesai.

   kunci API

4. Pilih Salin dan simpan kunci API Anda di lokasi yang aman. Kami akan membutuhkan kunci ini untuk menerbitkan paket NuGet kami.

   

Menerbitkan paket ke NuGet.org

Anda dapat menerbitkan paket menggunakan antarmuka pengguna web, CLI dotnet, atau CLI nuget.exe. Kita akan fokus pada penerbitan paket dengan menggunakan baris perintah di bagian ini. Anda akan memerlukan nama paket Anda, kunci API, dan URL sumber untuk melakukannya.

dotnet CLI

1. Dalam prompt perintah yang memiliki hak akses tingkat tinggi, navigasikan ke folder yang berisi paket nupkg Anda.

2. Jalankan perintah berikut untuk menerbitkan paket Anda ke NuGet.org. Ganti tempat penampung dengan nama paket dan kunci API Anda.

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

3. Hasil perintah sebelumnya akan terlihat seperti ini.

   menerbitkan output paket

nuget.exe

1. Dalam prompt perintah yang memiliki hak akses tingkat tinggi, navigasikan ke folder yang berisi paket nupkg Anda.

2. Jalankan perintah berikut untuk menerbitkan paket Anda ke NuGet.org. Ganti tempat penampung dengan nama paket dan kunci API Anda.

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

3. Hasil perintah sebelumnya akan terlihat seperti ini.

   menerbitkan output paket

Artikel terkait

• Menggunakan paket NuGet di Visual Studio
• Mulai menggunakan paket NuGet dan Azure Artifacts
• Menerbitkan paket NuGet dengan Azure Pipelines