Öğretici: .NET CLI kullanarak bir .NET yerel aracı yükleme ve kullanma

Makale
01/29/2025

Bu makale şunlar için geçerlidir: .NET Core 3.0 SDK ve sonraki sürümleri ✔️

Bu öğreticide yerel bir aracı nasıl yükleyip kullanacağınız öğretildi. Bu serinin ilk öğreticisinde oluşturduğunuz bir aracıkullanmaktasınız.

Önkoşullar

bu serinin ilköğreticisini tamamlayın.
.NET Core 2.1 çalışma zamanını yükleyin.

Bu öğreticide, .NET Core 2.1'i hedefleyen bir aracı yükleyip kullanacaksınız; bunun için bu çalışma zamanı ortamının bilgisayarınızda kurulu olması gerekir. 2.1 çalışma zamanını yüklemek için .NET Core 2.1 indirme sayfasına gidin ve Uygulamaları çalıştır - Çalışma zamanı sütununda çalışma zamanı yükleme bağlantısını bulun.

Bildirim dosyası oluşturma

Yalnızca yerel erişim için bir araç yüklemek için (geçerli dizin ve alt dizinler için), bir bildirim dosyasına eklenmesi gerekir.

microsoft.botsay klasöründen deposu klasörüne bir düzey yukarı gidin:

cd ..

dotnet new komutunu çalıştırarak bir bildirim dosyası oluşturun:

dotnet new tool-manifest

Çıkış, dosyanın başarıyla oluşturulduğuna işaret eder.

The template "Dotnet local tool manifest file" was created successfully.

.config/dotnet-tools.json dosyasında henüz araç yok:

{
  "version": 1,
  "isRoot": true,
  "tools": {}
}

Bildirim dosyasında listelenen araçlar geçerli dizin ve alt dizinler tarafından kullanılabilir. Geçerli dizin, bildirim dosyasını içeren .config dizini içeren dizindir.

Yerel bir araca başvuran bir CLI komutu kullandığınızda SDK, geçerli dizinde ve üst dizinlerde bir bildirim dosyası arar. Bir bildirim dosyası bulursa ancak dosya başvurulan aracı içermiyorsa, aramaya üst dizinler aracılığıyla devam eder. Arama, başvurulan aracı bulduğunda veya isRoottrueolarak ayarlanmış bir bildirim dosyası bulduğunda sona erer.

Botsay'i yerel araç olarak yükleme

İlk derste oluşturduğunuz paketten aracı yükleyin.

dotnet tool install --add-source ./microsoft.botsay/nupkg microsoft.botsay

Bu komut, aracı önceki adımda oluşturduğunuz bildirim dosyasına ekler. Komut çıktısı, yeni yüklenen aracın hangi bildirim dosyasında olduğunu gösterir:

You can invoke the tool from this directory using the following command:
'dotnet tool run botsay' or 'dotnet botsay'
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
Entry is added to the manifest file /home/name/repository/.config/dotnet-tools.json

.config/dotnet-tools.json dosyasında artık tek bir araç vardır:

{
  "version": 1,
  "isRoot": true,
  "tools": {
    "microsoft.botsay": {
      "version": "1.0.0",
      "commands": [
        "botsay"
      ]
    }
  }
}

Aracı kullan

deposu klasöründen dotnet tool run komutunu çalıştırarak aracı çağırın:

dotnet tool run botsay hello from the bot

Başkaları tarafından yüklenen yerel aracı geri yükleme

Genellikle deponun kök dizinine yerel bir araç yüklersiniz. Bildirim dosyasını depoya iade ettikten sonra, diğer geliştiriciler en son bildirim dosyasını alabilir. Bildirim dosyasında listelenen tüm araçları yüklemek için tek bir dotnet tool restore komutu çalıştırabilir.

.config/dotnet-tools.json dosyasını açın ve içeriğini aşağıdaki JSON ile değiştirin:

{
  "version": 1,
  "isRoot": true,
  "tools": {
    "microsoft.botsay": {
      "version": "1.0.0",
      "commands": [
        "botsay"
      ]
    },
    "dotnetsay": {
      "version": "2.1.3",
      "commands": [
        "dotnetsay"
      ]
    }
  }
}

Değişikliklerinizi kaydedin.

Bu değişikliği yapmak, başka biri proje dizini için paket dotnetsay yükledikten sonra depodan en son sürümü almakla aynıdır.

dotnet tool restore komutunu çalıştırın.

dotnet tool restore

komutu aşağıdaki örneğe benzer bir çıkış oluşturur:

Tool 'microsoft.botsay' (version '1.0.0') was restored. Available commands: botsay
Tool 'dotnetsay' (version '2.1.3') was restored. Available commands: dotnetsay
Restore was successful.

Araçların kullanılabilir olduğunu doğrulayın:

dotnet tool list

Çıktı, aşağıdaki örneğe benzer şekilde paketlerin ve komutların listesidir:

Package Id      Version      Commands       Manifest
--------------------------------------------------------------------------------------------
microsoft.botsay 1.0.0        botsay         /home/name/repository/.config/dotnet-tools.json
dotnetsay        2.1.3        dotnetsay      /home/name/repository/.config/dotnet-tools.json

Araçları test edin:

dotnet tool run dotnetsay hello from dotnetsay
dotnet tool run botsay hello from botsay

Yerel aracı güncelleştirme

Yerel araç dotnetsay yüklü sürümü 2.1.3'tür. Aracı en son sürüme güncelleştirmek için dotnet tool update komutunu kullanın.

dotnet tool update dotnetsay

Çıkış, yeni sürüm numarasını gösterir:

Tool 'dotnetsay' was successfully updated from version '2.1.3' to version '2.1.7'
(manifest file /home/name/repository/.config/dotnet-tools.json).

Update komutu, paket kimliğini içeren ilk bildirim dosyasını bulur ve güncelleştirir. Arama kapsamındaki herhangi bir bildirim dosyasında böyle bir paket kimliği yoksa, SDK en yakın bildirim dosyasına yeni bir giriş ekler. Arama kapsamı, isRoot = true olan bir bildirim dosyası bulunana kadar üst dizinler boyunca devam eder.

Yerel araçları kaldırın

Yüklü araçları kaldırmak için dotnet tool uninstall komutunu çalıştırın.

dotnet tool uninstall microsoft.botsay

dotnet tool uninstall dotnetsay

Sorun Giderme

Eğitimi takip ederken bir hata iletisi alırsanız bkz. .NET aracı kullanım sorunlarını giderme.

Ayrıca bkz.

Daha fazla bilgi için bkz. .NET araçları .

Aracılığıyla paylaş