Menerbitkan paket ke NuGet.org

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

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

Prasyarat

• Versi Visual Studio 2019 dan beban kerja .NET Core apa pun.
• 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 Proyek.

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, jika sudah 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 Buat paket NuGet pada build .

   

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

   

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. Beri kunci Anda Dorong paket baru dan cakupan versi paket, dan masukkan * di bidang pola glob untuk memilih semua paket. Pilih Buat, jika sudah selesai.

   

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 ditingkatkan, navigasikan ke folder yang berisi paket Anda nupkg .

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. Output perintah sebelumnya akan terlihat seperti ini.

   

nuget.exe

1. Dalam prompt perintah yang ditingkatkan, navigasikan ke folder yang berisi paket Anda nupkg .

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. Output perintah sebelumnya akan terlihat seperti ini.

   

Artikel terkait

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