.NET CLI ile .NET uygulamaları yayımlama

Bu makalede, .NET uygulamanızı komut satırından nasıl yayımlayabileceğiniz gösterilmektedir. .NET, uygulamalarınızı yayımlamak için üç yol sağlar. Çerçeveye bağımlı dağıtım, yerel olarak yüklenen .NET çalışma zamanını kullanan platformlar arası bir .dll dosyası oluşturur. Çerçeveye bağımlı yürütülebilir dosya, yerel olarak yüklenen .NET çalışma zamanını kullanan platforma özgü bir yürütülebilir dosya oluşturur. Bağımsız yürütülebilir dosya, platforma özgü bir yürütülebilir dosya oluşturur ve .NET çalışma zamanının yerel bir kopyasını içerir.

Bu yayımlama modlarının genel bakışı için bkz . .NET Uygulama Dağıtımı.

CLI'yi kullanma konusunda hızlı yardım mı arıyorsunuz? Aşağıdaki tabloda uygulamanızı yayımlamaya ilişkin bazı örnekler gösterilmektedir. Hedef çerçeveyi parametresiyle -f <TFM> veya proje dosyasını düzenleyerek belirtebilirsiniz. Daha fazla bilgi için bkz . Yayımlama temel bilgileri.

Yayımlamayla ilgili temel bilgiler

<TargetFramework> Proje dosyasının ayarı, uygulamanızı yayımladığınızda varsayılan hedef çerçeveyi belirtir. Hedef çerçeveyi geçerli herhangi bir Hedef Çerçeve Takma Adı (TFM) ile değiştirebilirsiniz. Örneğin, projeniz kullanıyorsa <TargetFramework>net8.0</TargetFramework>.NET 8'i hedefleyen bir ikili oluşturulur. Bu ayarda belirtilen TFM, komutu tarafından dotnet publish kullanılan varsayılan hedeftir.

Birden fazla çerçeveyi hedeflemek istiyorsanız, ayarı noktalı virgülle ayırarak birden çok TFM değerine ayarlayabilirsiniz <TargetFrameworks> . Uygulamanızı oluşturduğunuzda, her hedef çerçeve için bir derleme oluşturulur. Ancak, uygulamanızı yayımladığınızda, hedef çerçeveyi komutuyla dotnet publish -f <TFM> belirtmeniz gerekir.

Parametresiyle değiştirilmediği sürece varsayılan BUILD-CONFIGURATION modu Hata Ayıklama'dır.-c

Komutun dotnet publish varsayılan çıkış dizinidir ./bin/<BUILD-CONFIGURATION>/<TFM>/publish/. Örneğin, dotnet publish -c Release -f net8.0 için ./bin/Release/net8.0/publish/yayımlar. Ancak, tüm derleme çıkışları için basitleştirilmiş bir çıkış yolu ve klasör yapısı seçebilirsiniz. Daha fazla bilgi için bkz . Yapıt çıktı düzeni.

Yerel bağımlılıklar

Uygulamanızın yerel bağımlılıkları varsa farklı bir işletim sisteminde çalışmayabilir. Örneğin, uygulamanız yerel Windows API'sini kullanıyorsa macOS veya Linux üzerinde çalışmaz. Platforma özgü kod sağlamanız ve her platform için bir yürütülebilir dosya derlemeniz gerekir.

Ayrıca başvurmuş olduğunuz bir kitaplığın yerel bağımlılığı varsa uygulamanızın her platformda çalışmayabileceğini de göz önünde bulundurun. Ancak, başvurabileceğiniz bir NuGet paketinin sizin için gerekli yerel bağımlılıkları işlemek için platforma özgü sürümler içeriyor olması mümkündür.

Yerel bağımlılıkları olan bir uygulamayı dağıtırken, yayımlamak istediğiniz hedef platformu belirtmek için anahtarını kullanmanız dotnet publish -r <RID> gerekebilir. Çalışma zamanı tanımlayıcılarının listesi için bkz . Çalışma Zamanı Tanımlayıcısı (RID) kataloğu.

Platforma özgü ikili dosyalar hakkında daha fazla bilgi, Çerçeveye bağlı yürütülebilir dosya ve Bağımsız dağıtım bölümlerinde ele alınmıştır.

Örnek uygulama

Yayımlama komutlarını keşfetmek için aşağıdaki uygulamayı kullanabilirsiniz. Uygulama, terminalinizde aşağıdaki komutlar çalıştırılarak oluşturulur:

mkdir apptest1
cd apptest1
dotnet new console
dotnet add package Figgle

Program.cs Konsol şablonu tarafından oluşturulan veya Program.vb dosyasının aşağıdaki şekilde değiştirilmesi gerekir:

using System;

namespace apptest1
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine(Figgle.FiggleFonts.Standard.Render("Hello, World!"));
        }
    }
}

Module Program
    Sub Main(args As String())
        Console.WriteLine(Figgle.FiggleFonts.Standard.Render("Hello, World!"))
    End Sub
End Module

Uygulamayıdotnet run () çalıştırdığınızda aşağıdaki çıkış görüntülenir:

  _   _      _ _         __        __         _     _ _
 | | | | ___| | | ___    \ \      / /__  _ __| | __| | |
 | |_| |/ _ \ | |/ _ \    \ \ /\ / / _ \| '__| |/ _` | |
 |  _  |  __/ | | (_) |    \ V  V / (_) | |  | | (_| |_|
 |_| |_|\___|_|_|\___( )    \_/\_/ \___/|_|  |_|\__,_(_)
                     |/

Çerçeveye bağımlı dağıtım

Uygulamanızı FDD olarak yayımladığınızda, klasörde bir <PROJECT-NAME>.dll dosya oluşturulur ./bin/<BUILD-CONFIGURATION>/<TFM>/publish/ . Uygulamanızı çalıştırmak için çıkış klasörüne gidin ve komutunu kullanın dotnet <PROJECT-NAME>.dll .

Uygulamanız belirli bir .NET sürümünü hedeflemek üzere yapılandırılmıştır. Hedeflenen .NET çalışma zamanının, uygulamanızın çalıştığı herhangi bir makinede olması gerekir. Örneğin, uygulamanız .NET Core 8'i hedef alıyorsa, uygulamanızın üzerinde çalıştığı tüm makinelerde .NET Core 8 çalışma zamanı yüklü olmalıdır. Yayımlama temel bilgileri bölümünde belirtildiği gibi, proje dosyanızı düzenleyerek varsayılan hedef çerçeveyi değiştirebilir veya birden fazla çerçeveyi hedefleyebilirsiniz.

FDD yayımlamak, uygulamayı çalıştıran sistemde kullanılabilen en son .NET güvenlik düzeltme ekine otomatik olarak iletilen bir uygulama oluşturur. Derleme zamanında sürüm bağlama hakkında daha fazla bilgi için bkz . Kullanılacak .NET sürümünü seçme.

Çerçeveye bağımlı yürütülebilir dosya

Çerçeveye bağımlı yürütülebilir dosya (FDE), temel dotnet publish komut için varsayılan moddur. Geçerli işletim sistemini hedeflemek istediğiniz sürece başka parametre belirtmeniz gerekmez.

Bu modda platformlar arası uygulamanızı barındırmak için platforma özgü bir yürütülebilir konak oluşturulur. FDD komutu biçiminde dotnet bir konak gerektirdiğinden bu mod FDD'ye benzer. Ana bilgisayar yürütülebilir dosya adı platforma göre değişir ve benzeri <PROJECT-FILE>.exebir adla adlandırılır. Bu yürütülebilir dosyayı çağırmak dotnet <PROJECT-FILE>.dllyerine doğrudan çalıştırabilirsiniz. Bu, uygulamayı çalıştırmanın hala kabul edilebilir bir yoludur.

Uygulamanız belirli bir .NET sürümünü hedeflemek üzere yapılandırılmıştır. Hedeflenen .NET çalışma zamanının, uygulamanızın çalıştığı herhangi bir makinede olması gerekir. Örneğin, uygulamanız .NET 8'i hedef alıyorsa, uygulamanızın üzerinde çalıştığı tüm makinelerde .NET 8 çalışma zamanı yüklü olmalıdır. Yayımlama temel bilgileri bölümünde belirtildiği gibi, proje dosyanızı düzenleyerek varsayılan hedef çerçeveyi değiştirebilir veya birden fazla çerçeveyi hedefleyebilirsiniz.

FDE yayımlamak, uygulamayı çalıştıran sistemde kullanılabilen en son .NET güvenlik düzeltme ekine otomatik olarak iletilen bir uygulama oluşturur. Derleme zamanında sürüm bağlama hakkında daha fazla bilgi için bkz . Kullanılacak .NET sürümünü seçme.

Anahtarı her kullandığınızda -r çıkış klasörü yolu şu şekilde değişir: ./bin/<BUILD-CONFIGURATION>/<TFM>/<RID>/publish/

Örnek uygulamayı kullanıyorsanız komutunu çalıştırındotnet publish -f net6.0 -r win-x64 --self-contained false. Bu komut aşağıdaki yürütülebilir dosyayı oluşturur: ./bin/Debug/net6.0/win-x64/publish/apptest1.exe

.NET yükleme arama davranışını yapılandırma

.NET 9 ve sonraki sürümlerinde, yayımlanan yürütülebilir dosyanın .NET yükleme arama yollarını ve AppHostRelativeDotNet özellikleri aracılığıyla AppHostDotNetSearch yapılandırabilirsiniz.

AppHostDotNetSearch yürütülebilir dosyanın bir .NET yüklemesini arayacağı bir veya daha fazla konumun belirtilmesine izin verir:

• AppLocal: uygulama yürütülebilir dosyasının klasörü
• AppRelative: uygulama yürütülebilir dosyasıyla ilgili yol
• EnvironmentVariables: ortam değişkenlerinin DOTNET_ROOT[_<arch>] değeri
• Global: kayıtlı ve varsayılan genel yükleme konumları

AppHostRelativeDotNet , içerdiğinde AppHostDotNetSearch AppRelativearanacak yürütülebilir dosyaya göre yolu belirtir.

Daha fazla bilgi için bkz AppHostDotNetSearchAppHostRelativeDotNet . ve apphost'ta konum seçeneklerini yükleme.

Bağımsız dağıtım

Bağımsız bir dağıtım (SCD) yayımladığınızda ,NET SDK'sı platforma özgü bir yürütülebilir dosya oluşturur. SCD yayımlamak, uygulamanızı çalıştırmak için gerekli tüm .NET dosyalarını içerir, ancak .NET'in yerel bağımlılıklarını içermez (örneğin, Linux'ta .NET 6 veya Linux üzerinde .NET 8 için). Uygulama çalışmadan önce bu bağımlılıkların sistemde mevcut olması gerekir.

SCD yayımlamak, kullanılabilir en son .NET güvenlik düzeltme ekine iletmeyen bir uygulama oluşturur. Derleme zamanında sürüm bağlama hakkında daha fazla bilgi için bkz . Kullanılacak .NET sürümünü seçme.

SCD yayımlamak için komutuyla dotnet publish aşağıdaki anahtarları kullanmanız gerekir:

• -r <RID>

  Bu anahtar, hedef platformu belirtmek için bir tanımlayıcı (RID) kullanır. Çalışma zamanı tanımlayıcılarının listesi için bkz . Çalışma Zamanı Tanımlayıcısı (RID) kataloğu.

• --self-contained true

  Bu anahtar , .NET SDK'sına SCD olarak yürütülebilir dosya oluşturmasını söyler.

Ayrıca bkz.

• .NET Uygulama Dağıtımına Genel Bakış
• .NET Runtime IDentifier (RID) kataloğu