NuGet.org'da paket yayımlama

NuGet.org, geliştiricilerin yeniden kullanılabilir kodu paylaşmalarını sağlayan bir paket yöneticisidir. Bir NuGet paketi, diğer projelerde .nupkg tüketilebilir derlenmiş kod içeren uzantılı sıkıştırılmış bir dosyadır. NuGet.org'da barındırılan paketler, dünyanın farklı yerlerinde bulunan tüm geliştiriciler tarafından kullanılabilir.

Önkoşullar

Proje oluşturma

Bir .NET paketi oluşturmak ve oluşturmak için kendi .NET projenizi NuGet veya aşağıdaki gibi yeni bir temel .NET sınıf kitaplığı oluşturabilirsiniz:

  1. Dosya Visual Studio, Yeni'yive ardındanöğesini Project.

  2. Sınıf Kitaplığı (.NET Standard) şablonunu ve ardından Sonraki'yi seçin.

  3. Projenize ve çözümünüze bir ad ve ardından projeyi yerel olarak kaydetmek için bir konum seçin. Bitirerek Oluştur'a seçin.

    Sınıf kitaplığı projesi oluşturma

Şablon sınıfı kitaplığı bir NuGet paketi oluşturmak için yeterlidir. Bu nedenle bu öğreticide mevcut şablonu kullanacak ve ek kod yazmayabilirsiniz.

Paket ayarlama ve oluşturma

  1. Çözüm gezgininden projenizi seçin, sağ tıklayın ve özellikler'i ve ardından Paketle'yiseçin.

  2. Formu doldurun ve paket kimliğinizin benzersiz olduğundan emin olun, aksi takdirde NuGet.org'da mevcut paketlerle çakışabilirsiniz. Yaygın bir adlandırma kuralı şöyledir: Company.Product.Feature. Projenizi her derlemesinde paketinizi oluşturmak için Derlemede NuGet oluştur onay kutusunu seçin.

    Paket özelliklerini yapılandırma

  3. Çözüm gezgininden projenizi seçin, sağ tıklayın ve paketinizi oluşturmak için Paket'i seçin.

    Paket oluşturma

  4. Çıkış penceresinde pack komutunun durumunu kontrol edin.

    Paket çıkışı

API anahtarı oluşturma

Paketimizi oluşturduğumuza göre yayımlamaya neredeyse hazırız, ancak önce NuGet.org API'sini bağlamak için bir API anahtarı nupkg oluşturmamız gerekiyor.

  1. NuGet.org hesabınızla oturum açın veya oturum açmadıysanız bir tane oluşturun.

  2. Kullanıcı adınız simgesini ve ardından API Anahtarları'ı seçin.

  3. Oluştur'ı seçin ve anahtarınız için bir ad girin. Anahtarınıza Yeni paketler ve paket sürümü kapsamı ile birlikte bir Push (Yeni paketler ve paket sürümü kapsamı) girin ve tüm paketleri seçmek için glob deseni alanına girin. Bitirerek Oluştur'a seçin.

    API anahtarı oluşturma

  4. Kopyala'ya tıklayın ve API anahtarınızı güvenli bir konuma kaydedin. Uygulama paketimizi yayımlamak için bu anahtara NuGet gerekir.

    API anahtarını kopyalama

NuGet.org'da paket yayımlama

Paketinizi web kullanıcı arabirimini, dotnet CLI'yı veya CLI'nuget.exe yayımlayın. Bu bölümde komut satırı kullanarak paketleri yayımlamaya odaklaneceğiz. Bunu yapmak için paketinizin adına, API anahtarına ve kaynak URL'ye ihtiyacınız vardır.

  1. Yükseltilmiş komut isteminde paketinizi içeren klasöre nupkg gidin.

  2. Paketinizi NuGet.org'da yayımlamak için aşağıdaki komutu çalıştırın. Yer tutucuları paket adınız ve API anahtarınız ile değiştirin.

    dotnet nuget push <packageName> --api-key <APIKey> --source https://api.nuget.org/v3/index.json
    
  3. Önceki komutun çıktısı aşağıdakine benzer şekilde görüntü gerekir.

    Paket çıktısını yayımlama