.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ımlama Modu | Command |
|---|---|
| Çerçeveye bağımlı dağıtım | dotnet publish -c Release -p:UseAppHost=false |
| Çerçeveye bağımlı yürütülebilir dosya | dotnet publish -c Release -r <RID> --self-contained falsedotnet publish -c Release |
| Bağımsız dağıtım | dotnet publish -c Release -r <RID> --self-contained true |
Not
-c Releaseparametresi gerekli değildir. Uygulamanızın Yayın derlemesini yayımlamak için bir anımsatıcı olarak sağlanır.- .NET SDK 3.1 veya sonraki sürümlerde, temel
dotnet publishkomut çalıştırılırken çerçeveye bağımlı yürütülebilir dosya varsayılan yayımlama modudur.
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.
| Yayımlama Modu | Command |
|---|---|
| Çerçeveye bağımlı dağıtım | dotnet publish -c Release -p:UseAppHost=false |
Ç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.
| Yayımlama Modu | Command |
|---|---|
| Çerçeveye bağımlı yürütülebilir dosya | dotnet publish -c Release -r <RID> --self-contained falsedotnet publish -c Release |
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
Not
Genelleştirme sabit modunu etkinleştirerek dağıtımınızın toplam boyutunu küçültebilirsiniz. Bu mod, genel olarak farkında olmayan ve sabit kültürün biçimlendirme kurallarını, büyük/küçük harf kurallarını ve dize karşılaştırmasını ve sıralama düzenini kullanabilen uygulamalar için kullanışlıdır. Genelleştirme sabit modu ve nasıl etkinleştirileceği hakkında daha fazla bilgi için bkz. .NET Genelleştirme Sabit Modu.
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 trueBu anahtar , .NET SDK'sına SCD olarak yürütülebilir dosya oluşturmasını söyler.
| Yayımlama Modu | Command |
|---|---|
| Bağımsız dağıtım | dotnet publish -c Release -r <RID> --self-contained true |
İpucu
- .NET 6 ve sonraki sürümlerde, kırpılmış olarak yayımlayarak uyumlu kendi içinde bulunan uygulamaların toplam boyutunu küçültebilirsiniz. Bu, düzelticinin herhangi bir kod yolunda olmayan veya çalışma zamanı yansımasında başvurulabilecek çerçevenin ve başvuruda bulunılan derlemelerin bölümlerini kaldırmasını sağlar. Kırpmanın uygulamanız için anlamlı olup olmadığını belirlemek için bkz . kırpma uyumsuzlukları .
- Genelleştirme sabit modunu etkinleştirerek dağıtımınızın toplam boyutunu küçültebilirsiniz. Bu mod, genel olarak farkında olmayan ve sabit kültürün biçimlendirme kurallarını, büyük/küçük harf kurallarını ve dize karşılaştırmasını ve sıralama düzenini kullanabilen uygulamalar için kullanışlıdır. Genelleştirme sabit modu ve bunun nasıl etkinleştirileceği hakkında daha fazla bilgi için bkz. .NET Core Genelleştirme Sabit Modu.
Ayrıca bkz.
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin