Öğretici: Visual Studio Code kullanarak bir .NET konsol uygulaması yayımlama

  • Makale
  • Okumak için 2 dakika

Bu öğreticide, diğer kullanıcıların çalıştıracakları bir konsol uygulamasının nasıl yayımlanları gösterir. Yayımlama, bir uygulamayı çalıştırmak için gereken dosya kümesi oluşturur. Dosyaları dağıtmak için hedef makineye kopyalayın.

Uygulamayı yayımlamak için .NET CLI kullanılır, bu nedenle isterseniz bu öğreticiyi farklı bir kod Visual Studio Code ile takip edin.

Önkoşullar

Uygulamayı yayımlama

  1. Visual Studio Code’u başlatın.

  2. .NET konsol uygulaması oluşturma içinde oluşturduğunuz HelloWorld proje klasörünü Visual Studio Code.

  3. Ana > menüden Terminali Görüntüle'yi seçin.

    Terminal HelloWorld klasöründe açılır.

  4. Şu komutu çalıştırın:

    dotnet publish --configuration Release

    Varsayılan derleme yapılandırması Hata Ayıkla'dır, bu nedenle bu komut Yayın derleme yapılandırmasını belirtir. Yayın derleme yapılandırmasından elde edilen çıktıda simgesel hata ayıklama bilgileri minimum düzeydedir ve tamamen iyileştirilmiştir.

    Komut çıktısı aşağıdaki örnektekine benzer:

    Microsoft (R) Build Engine version 16.7.0+b89cb5fde for .NET
Copyright (C) Microsoft Corporation. All rights reserved.
  Determining projects to restore...
  All projects are up-to-date for restore.
  HelloWorld -> C:\Projects\HelloWorld\bin\Release\net6.0\HelloWorld.dll
  HelloWorld -> C:\Projects\HelloWorld\bin\Release\net6.0\publish\

Dosyaları inceleme

Varsayılan olarak, yayımlama işlemi yayımlanmış uygulamanın .NET çalışma zamanı yüklü bir makinede çalıştırılacak bir dağıtım türü olan çerçeveye bağımlı bir dağıtım oluşturur. Yayımlanan uygulamayı çalıştırmak için yürütülebilir dosyayı kullanabilir veya komutu dotnet HelloWorld.dll komut isteminden çalıştırabilirsiniz.

Aşağıdaki adımlarda yayımlama işlemi tarafından oluşturulan dosyalara göz atacağız.

  1. Sol gezinti çubuğunda Gezgin'i seçin.

  2. Bin/Release/net6.0/publish alanını genişletin.

    Yayımlanmış dosyaları gösteren gezgin

    Resimde de olduğu gibi, yayımlanan çıkış aşağıdaki dosyaları içerir:

    • HelloWorld.deps.json

      Bu, uygulamanın çalışma zamanı bağımlılıkları dosyasıdır. Uygulamayı çalıştırmak için gereken .NET bileşenlerini ve kitaplıkları (uygulamanızı içeren dinamik bağlantı kitaplığı dahil) tanımlar. Daha fazla bilgi için bkz. Çalışma zamanı yapılandırma dosyaları.

    • HelloWorld.dll

      Bu, uygulamanın çerçeveye bağımlı dağıtım sürümüdür. Bu dinamik bağlantı kitaplığını çalıştırmak için bir dotnet HelloWorld.dll komut istemine girin. Uygulamayı çalıştırma yöntemi. .NET çalışma zamanı yüklü olan tüm platformlarda çalışır.

    • HelloWorld.exe (Linux'ta HelloWorld, macOS'ta oluşturulmadı.)

      Bu, uygulamanın çerçeveye bağımlı yürütülebilir sürümüdür. Dosya işletim sistemine özgü.

    • HelloWorld.pdb (dağıtım için isteğe bağlı)

      Bu, hata ayıklama sembolleri dosyasıdır. Bu dosyayı uygulamayla birlikte dağıtmanız gerekmez, ancak uygulamanızın yayımlanan sürümünde hata ayıklamanız gerektiğinde dosyayı kaydetmeniz gerekir.

    • HelloWorld.runtimeconfig.json

      Bu, uygulamanın çalışma zamanı yapılandırma dosyasıdır. Bu, uygulamanın üzerinde çalıştırıla hazır olduğu .NET sürümünü tanımlar. Buna yapılandırma seçenekleri de ebilirsiniz. Daha fazla bilgi için bkz. .NET çalışma zamanı yapılandırma ayarları.

Yayımlanan uygulamayı çalıştırma

  1. Gezgin'de yayımla klasörüne sağ tıklayın (Ctrltuşunu basılı tutarak macOS'a tıklayın) ve Terminalde Aç'ı seçin.

    Terminalde Aç seçeneğini gösteren bağlam menüsü

  2. Windows veya Linux'ta yürütülebilir dosyayı kullanarak uygulamayı çalıştırın.

    1. Giriş Windows girin ve .\HelloWorld.exe Enter tuşuna basın.

    2. Linux'ta girin ve ./HelloWorld Enter tuşuna basın.

    3. İstem yanıt olarak bir ad girin ve çıkmak için herhangi bir tuşa basın.

  3. Herhangi bir platformda komutunu kullanarak uygulamayı dotnet çalıştırın:

    1. girin dotnet HelloWorld.dll ve Enter tuşuna basın.

    2. İstem yanıt olarak bir ad girin ve çıkmak için herhangi bir tuşa basın.

Ek kaynaklar

Sonraki adımlar

Bu öğreticide bir konsol uygulaması yayımladık. Sonraki öğreticide, bir sınıf kitaplığı oluşturabilirsiniz.

Visual Studio Code kullanarak .NET sınıf kitaplığı oluşturma

Bu öğreticide, diğer kullanıcıların çalıştıracakları bir konsol uygulamasının nasıl yayımlanları gösterir. Yayımlama, bir uygulamayı çalıştırmak için gereken dosya kümesi oluşturur. Dosyaları dağıtmak için hedef makineye kopyalayın.

Uygulamayı yayımlamak için .NET CLI kullanılır, bu nedenle isterseniz bu öğreticiyi farklı bir kod Visual Studio Code ile takip edin.

Önkoşullar

Uygulamayı yayımlama

  1. Visual Studio Code’u başlatın.

  2. .NET konsol uygulaması oluşturma içinde oluşturduğunuz HelloWorld proje klasörünü Visual Studio Code.

  3. Ana > menüden Terminali Görüntüle'yi seçin.

    Terminal HelloWorld klasöründe açılır.

  4. Şu komutu çalıştırın:

    dotnet publish --configuration Release

    Varsayılan derleme yapılandırması Hata Ayıkla'dır, bu nedenle bu komut Yayın derleme yapılandırmasını belirtir. Yayın derleme yapılandırmasından elde edilen çıktıda simgesel hata ayıklama bilgileri minimum düzeydedir ve tamamen iyileştirilmiştir.

    Komut çıktısı aşağıdaki örnektekine benzer:

    Microsoft (R) Build Engine version 16.7.0+b89cb5fde for .NET
Copyright (C) Microsoft Corporation. All rights reserved.
  Determining projects to restore...
  All projects are up-to-date for restore.
  HelloWorld -> C:\Projects\HelloWorld\bin\Release\net5.0\HelloWorld.dll
  HelloWorld -> C:\Projects\HelloWorld\bin\Release\net5.0\publish\

Dosyaları inceleme

Varsayılan olarak, yayımlama işlemi yayımlanmış uygulamanın .NET çalışma zamanı yüklü bir makinede çalıştırılacak bir dağıtım türü olan çerçeveye bağımlı bir dağıtım oluşturur. Yayımlanan uygulamayı çalıştırmak için yürütülebilir dosyayı kullanabilir veya komutu dotnet HelloWorld.dll komut isteminden çalıştırabilirsiniz.

Aşağıdaki adımlarda yayımlama işlemi tarafından oluşturulan dosyalara göz atacağız.

  1. Sol gezinti çubuğunda Gezgin'i seçin.

  2. Bin/Release/net5.0/publish alanını genişletin.

    Yayımlanmış dosyaları gösteren gezgin

    Resimde de olduğu gibi, yayımlanan çıkış aşağıdaki dosyaları içerir:

    • HelloWorld.deps.json

      Bu, uygulamanın çalışma zamanı bağımlılıkları dosyasıdır. Uygulamayı çalıştırmak için gereken .NET bileşenlerini ve kitaplıkları (uygulamanızı içeren dinamik bağlantı kitaplığı dahil) tanımlar. Daha fazla bilgi için bkz. Çalışma zamanı yapılandırma dosyaları.

    • HelloWorld.dll

      Bu, uygulamanın çerçeveye bağımlı dağıtım sürümüdür. Bu dinamik bağlantı kitaplığını yürütmek için bir dotnet HelloWorld.dll komut istemine girin. Uygulamayı çalıştırma yöntemi. .NET çalışma zamanı yüklü olan tüm platformlarda çalışır.

    • HelloWorld.exe (Linux'ta HelloWorld, macOS'ta oluşturulmadı.)

      Bu, uygulamanın çerçeveye bağımlı yürütülebilir sürümüdür. Dosya işletim sistemine özgü.

    • HelloWorld.pdb (dağıtım için isteğe bağlı)

      Bu, hata ayıklama sembolleri dosyasıdır. Bu dosyayı uygulamayla birlikte dağıtmanız gerekmez, ancak uygulamanızın yayımlanan sürümünde hata ayıklamanız gerektiğinde dosyayı kaydetmeniz gerekir.

    • HelloWorld.runtimeconfig.json

      Bu, uygulamanın çalışma zamanı yapılandırma dosyasıdır. Uygulamanızın üzerinde çalışmak üzere oluşturulduğu .NET sürümünü tanımlar. Ayrıca, buna yapılandırma seçenekleri de ekleyebilirsiniz. Daha fazla bilgi için bkz. .NET çalışma zamanı yapılandırma ayarları.

Yayımlanan uygulamayı çalıştırma

  1. Gezgin'de Yayımla klasörüne sağ tıklayın (MacOS ' a CTRL tuşunu basılıolarak) ve Tümleşik terminalde aç' ı seçin.

    Terminalde aç 'ı gösteren bağlam menüsü

  2. Windows veya Linux 'ta, yürütülebilir dosyayı kullanarak uygulamayı çalıştırın.

    1. Windows, girin .\HelloWorld.exe ve enter tuşuna basın.

    2. Linux 'ta yazın ./HelloWorld ve ENTER tuşuna basın.

    3. İstemine yanıt olarak bir ad girin ve çıkmak için herhangi bir tuşa basın.

  3. Herhangi bir platformda, komutunu kullanarak uygulamayı çalıştırın dotnet :

    1. Yazın dotnet HelloWorld.dll ve ENTER tuşuna basın.

    2. İstemine yanıt olarak bir ad girin ve çıkmak için herhangi bir tuşa basın.

Ek kaynaklar

Sonraki adımlar

Bu öğreticide bir konsol uygulaması yayımladınız. Sonraki öğreticide, bir sınıf kitaplığı oluşturursunuz.

Visual Studio Code kullanarak bir .NET sınıf kitaplığı oluşturma

Bu öğretici yalnızca .NET 5 ve .NET 6 ' da kullanılabilir. Sayfanın üst kısmında bu seçeneklerden birini belirleyin.