NuGet paketleriyle çalışmaya başlama

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2017

geliştiriciler, hem akışlara hem de genel kayıt defterlerine NuGet paketlerini yayımlamak ve kullanmak için Azure Artifacts kullanabilir. Akış, paketleri barındıran bir kuruluş yapısıdır. Ortak ve özel akışlar oluşturabilir ve akış izinlerini değiştirerek paketlerinize kimlerin erişebileceğini belirleyebilirsiniz.

Önkoşullar

Bu hızlı başlangıçta Azure Artifacts ayarlamış olduğunuz varsayılmaktadır. uzantının lisans Azure Artifacts kılavuzundanasıl lisanslayabilirim.

Not

Azure Artifacts, TFS 2017 veya daha yeni bir sürümde önceden yüklenmiş olarak gelen bir uzantıdır, kuruluşunuzda kaldırılırsa, bunu Azure Artifacts marketi'nden yükleyebilirsiniz.

Akış oluşturma

Azure Artifacts ile iki tür akış oluşturabilirsiniz: proje kapsamındaki ve kuruluş kapsamındaki akışlar. Tüm genel akışlar proje kapsamıdır ve barındırma projesinin görünürlük ayarlarını alırlar. Varsayılan olarak, Web Kullanıcı arabirimi kullanılarak oluşturulan tüm akış, proje kapsamlı bir akışdır.

  1. Projenizin içinden Azure Artifacts' a gidin.

    Azure Artifacts git

  2. Akış oluştur' u seçin.

    Yeni akış düğmesi

  3. Akışınıza bir ad verin ve görünürlüğünü, yukarı akış kaynaklarınıve kapsam ayarlarını seçin.

    Yeni akış iletişim kutusu

  4. İşiniz bittiğinde Oluştur ' u seçin.

Azure Artifacts TFS 2017 müşterileri için varsayılan olarak yüklenir. Azure Artifacts kullanmak için TFS 2017 ' e yükseltmeniz gerekir. Akışınızı ilk kez kullanıyorsanız, bir lisans atamanız istenebilir

  1. Derleme sürümü ' ne gidin ve paketler' i seçin.

    Azure Artifacts TFS 'ye git

  2. + Yeni akış' ı seçin.

    Yeni akış düğmesi TFS

  3. Akışa bir ad, Açıklamaverin ve kimler okuyabilen, dış paketleri dahiletmek istiyorsanız kimlerin katkıda bulunabileceğini ve bunları okuyabilirler.

    Yeni akış iletişim kutusu TFS

  4. İşiniz bittiğinde Oluştur ' u seçin.

Bağlan ve paketleri yayımlamak için

Azure Artifacts, NuGet paketlerinizi ortak veya özel akışlara yayımlayabilir ve ardından bunları, akışınızın görünürlük ayarlarına bağlı olarak başkalarıyla paylaşabilirsiniz.

Akışınıza bağlanıp bir paket yayımlamanız aşağıda verilmiştir.

  1. projenizin içinden Artifacts' yi seçin ve ardından akışınızı seçin. Henüz bir tane yoksa, Yeni bir akış oluşturabilirsiniz .

  2. akışa Bağlanseçin.

    akışınıza Bağlan

  3. NuGet üst bilgisi altında NuGet.exe seçin.

    NuGet.exe akışı bağlantısı

  4. Azure Artifacts Nuget.exe ile ilk kez kullanıyorsanız, araçları al düğmesini seçin ve önkoşulları yüklemek için yönergeleri izleyin.

    1. en son NuGet sürümünüindirin.
    2. Azure Artifacts kimlik bilgisi sağlayıcısınıindirin ve yükleyin.
  5. Project kurulumunda , akışınıza bağlanmak için yönergeleri izleyin.

    Proje ayarları

komut satırını kullanarak NuGet paketi yayımlama

NuGet paketiniz yoksa ancak paketinizi akışınıza yayımlamayı denemek istiyorsanız, HelloWorld örnek paketini yükleyebilirsiniz.

nuget install HelloWorld -ExcludeVersion

Paketinizi akışınıza yayımlamak için aşağıdaki komutu çalıştırın:

nuget.exe push -Source "<YOUR_FEED_NAME>" -ApiKey <ANY_STRING> <PACKAGE_PATH>
  1. Derleme ve yayınpaketleriniseçin.

  2. Açılır menüden akışınızı seçin veya yapmadıysanız bir tane oluşturun .

  3. akışa Bağlanseçin.

    akışa Bağlan-TFS

  4. NuGet ' yi seçin ve akışınıza bağlanmak için yönergeyi izleyin.

    NuGet akışa Bağlan-TFS

örnek bir NuGet paketi yükleyip yayımlama

NuGet paketiniz yoksa ancak paketlerimizi akışınıza yayımlamak için adımları uygulamak istiyorsanız, HelloWorld örnek paketini yükleyebilirsiniz.

  1. örnek NuGet paketini yükler:

    nuget install HelloWorld -ExcludeVersion
    
  2. nuget.config dosyanızı ayarlayın ve paketinizi akışınıza yayımlayın

    nuget sources add -Name <SourceName> -Source <SourceURL> -username <UserName> -password <Pat>
    nuget push -Source <SourceName> -ApiKey az <PackagePath exp:(.\Get-Hello.1.0.0.nupkg)>
    

Visual Studio paketleri tüketme

akışınızdan NuGet paketlerini kullanmak için akışın NuGet uç noktasını aşağıdaki gibi Visual Studio bir paket kaynağı olarak eklemeniz gerekir.

1. akışın kaynak URL 'sini alın

  1. projenizin içinden Artifacts' yi seçin ve ardından akışınızı seçin.

  2. akışa Bağlanseçin.

    akışa Bağlan

  3. NuGet bölümünden Visual Studio seçin.

  4. Akışınızın kaynak URL 'sini kopyalayın.

    Kaynak URL 'sini Kopyala

  1. Derleme ve yayın' ı seçin ve ardından paketler' i seçin.

  2. Açılır menüden akışınızı seçin.

  3. akışa Bağlanseçin.

    akışa Bağlan

  4. Akışınızın kaynak URL 'sini kopyalayın.

    Kaynak URL 'sini Kopyala

2. Visual Studio ayarlama

Paket kaynağını ayarla

  1. Visual Studio ' de araçlar' ı ve sonra seçenekler' i seçin.

  2. NuGet Paket Yöneticisi bölümünü genişletin ve paket kaynakları' nı seçin.

  3. Akışın adını ve kaynak URL 'sini girin ve ardından bir kaynak eklemek için yeşil (+) işaretini seçin.

  4. Akışınızdaki yukarı akış kaynaklarını etkinleştirdiyseniz, NuGet.org onay kutusunu temizleyin.

  5. Tamam’ı seçin.

    Visual Studio 'yu ayarlama: Windows

3. paketleri tüketme

Artık Visual Studio kullanarak akışınızdan paket bulabilir ve bunları kullanabilirsiniz.

  1. Visual Studio, Çözüm Gezgini projenize sağ tıklayın ve ardından NuGet paketlerini yönet' i seçin.
  2. Araştır' ı seçin ve ardından paket kaynağı açılan listesinden akış Kaynağı Seç ' i seçin.
  3. Akışınıza gelen paketleri aramak için arama çubuğunu kullanın.

Not

Yukarı akış kaynaklarını kullanıyorsanız,henüz akışınıza kaydedilmiş yukarı akış kaynaklarından gelen paketler (bunları en az bir kez kullanarak) arama sonucunda Paket Yöneticisi görünmez. Bu paketleri yüklemek için:

NuGet.org adresinden paketi tüketme

  1. Genel kayıt defterinden (NuGet.org) Install-Package komutunu kopyalayın.
  2. Araçlar'ıNuGet Paket Yöneticisi paket yöneticisini NuGet seçin.
  3. komutunu Konsol'a Paket Yöneticisi çalıştır'ı seçin.