Paketleri NuGet.org yayımlama

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

NuGet.org, geliştiricilerin yeniden kullanılabilir kodu paylaşmasına olanak tanıyan bir paket yöneticisidir. NuGet paketi, diğer projelerde kullanılabilecek derlenmiş kod içeren, uzantılı sıkıştırılmış bir dosyadır .nupkg . NuGet.org'de barındırılan paketler dünyanın dört bir yanındaki tüm geliştiriciler tarafından kullanılabilir.

Önkoşullar

Bir proje oluştur

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

  1. Visual Studio'da Dosya, Yeni ve Proje'yi seçin.

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

  3. Projenizi ve çözümünüzü adlandırın ve ardından projeyi yerel olarak kaydetmek için bir konum seçin. İşiniz bittiğinde Oluştur'u seçin.

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

Şablon sınıfı kitaplığı NuGet paketi oluşturmak için yeterlidir, bu nedenle bu öğreticide mevcut şablonu kullanacağız ve ek kod yazmayacağız.

Paket ayarlama ve oluşturma

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

  2. Formu doldurun ve paket kimliğinizin benzersiz olduğundan emin olun, aksi takdirde NuGet.org üzerindeki mevcut paketlerle çakışabilir. Yaygın bir adlandırma kuralı şöyledir: Company.Product.Feature. Projenizi her oluşturduğunuzda paketinizi oluşturmak istiyorsanız Derlemede NuGet paketi oluştur onay kutusunu seçin.

    Paket özelliklerini yapılandırma

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

    Paket oluşturma

  4. Çıkış penceresinde pack komutunun durumunu denetleyin.

    Paket çıkışı

API anahtarı oluşturma

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

  1. NuGet.org hesabınızda oturum açın veya yapmadıysanız hesap oluşturun.

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

  3. Oluştur'u seçin ve anahtarınız için bir ad girin. Anahtarınıza yeni paketler ve paket sürümü kapsamı verin ve tüm paketleri seçmek için glob desen alanına girin * . İşiniz bittiğinde Oluştur'u seçin.

    API anahtarı oluşturma

  4. Kopyala'yı seçin ve API anahtarınızı güvenli bir konuma kaydedin. NuGet paketimizi yayımlamak için bu anahtara ihtiyacımız olacak.

    API anahtarını kopyalama

paketi NuGet.org yayımlama

Paketinizi web kullanıcı arabirimi, dotnet CLI veya nuget.exe CLI kullanarak yayımlayabilirsiniz. Bu bölümdeki komut satırını kullanarak paketleri yayımlamaya odaklanacağız. Bunu yapmak için paketinizin adına, BIR API anahtarına ve kaynak URL'ye ihtiyacınız olacaktır.

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

  2. Paketinizi NuGet.org 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ı şuna benzer olmalıdır.

    Paket çıktısı yayımlama