dotnet publish

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

Ad

dotnet publish - Uygulamayı ve bağımlılıklarını barındırma sistemine dağıtım için bir klasörde yayımlar.

Özet

dotnet publish [<PROJECT>|<SOLUTION>] [-a|--arch <ARCHITECTURE>]
    [--artifacts-path <ARTIFACTS_DIR>]
    [-c|--configuration <CONFIGURATION>] [--disable-build-servers]
    [-f|--framework <FRAMEWORK>] [--force] [--interactive]
    [--manifest <PATH_TO_MANIFEST_FILE>] [--no-build] [--no-dependencies]
    [--no-restore] [--nologo] [-o|--output <OUTPUT_DIRECTORY>]
    [--os <OS>] [-r|--runtime <RUNTIME_IDENTIFIER>]
    [--sc|--self-contained [true|false]] [--no-self-contained]
    [-s|--source <SOURCE>] [--tl:[auto|on|off]]
    [--use-current-runtime, --ucr [true|false]]
    [-v|--verbosity <LEVEL>] [--version-suffix <VERSION_SUFFIX>]

dotnet publish -h|--help

Açıklama

dotnet publish uygulamayı derler, proje dosyasında belirtilen bağımlılıklarını okur ve sonuçta elde edilen dosya kümesini bir dizinde yayımlar. Çıktı aşağıdaki varlıkları içerir:

• dll uzantısına sahip bir derlemede Ara Dil (IL) kodu.
• Projenin tüm bağımlılıklarını içeren bir .deps.json dosyası.
• Uygulamanın beklediği paylaşılan çalışma zamanını ve çalışma zamanı için diğer yapılandırma seçeneklerini (örneğin, çöp toplama türü) belirten bir .runtimeconfig.json dosyası.
• NuGet önbelleğinden çıkış klasörüne kopyalanan uygulamanın bağımlılıkları.

dotnet publish komutunun çıkışı yürütme için bir barındırma sistemine (örneğin, sunucu, PC, Mac, dizüstü bilgisayar) dağıtıma hazırdır. Uygulamayı dağıtıma hazırlamanın resmi olarak desteklenen tek yoludur. Projenin belirttiği dağıtım türüne bağlı olarak, barındırma sisteminde .NET paylaşılan çalışma zamanı yüklü olabilir veya olmayabilir. Daha fazla bilgi için bkz. .NET CLIile .NET uygulamalarını yayımlama .

Örtük geri yükleme

dotnet new, dotnet build, dotnet run, dotnet test, dotnet publishve dotnet packgibi geri yükleme gerektiren tüm komutlar tarafından örtük olarak çalıştırıldığından dotnet restore çalıştırmanız gerekmez. Örtük geri yüklemeyi devre dışı bırakmak için --no-restore seçeneğini kullanın.

komutu, Azure DevOps Services veya geri yüklemenin ne zaman gerçekleştiğini açıkça denetlemesi gereken derleme sistemlerinde sürekli tümleştirme derlemeleri gibi açıkça geri yüklemenin anlamlı olduğu bazı senaryolarda hala yararlıdır.

NuGet akışlarını yönetme hakkında bilgi için belgelerine bakın.

MSBuild

dotnet publish komutu, Publish hedefini çağıran MSBuild'i çağırır. IsPublishable özelliği belirli bir proje için false olarak ayarlanırsa, Publish hedefi çağrılamazsınız ve dotnet publish komutu projede yalnızca örtük dotnet geri yükleme çalıştırır.

dotnet publish geçirilen tüm parametreler MSBuild'e geçirilir. -c ve -o parametreleri sırasıyla MSBuild'in Configuration ve PublishDir özellikleriyle eşler.

dotnet publish komutu, özellikleri ayarlamak için -p ve günlükçü tanımlamak için -l gibi MSBuild seçeneklerini kabul eder. Örneğin, şu biçimi kullanarak bir MSBuild özelliği ayarlayabilirsiniz: -p:<NAME>=<VALUE>.

.pubxml dosyaları

.pubxml dosyasına başvurarak yayımlamayla ilgili özellikleri de ayarlayabilirsiniz. Mesela:

dotnet publish -p:PublishProfile=FolderProfile

Yukarıdaki örnek, <project_folder>/Properties/PublishProfiles klasöründe bulunan FolderProfile.pubxml dosyasını kullanır. PublishProfile özelliğini ayarlarken bir yol ve dosya uzantısı belirtirseniz, bunlar yoksayılır. MSBuild varsayılan olarak Properties/PublishProfiles klasörüne bakar ve pubxml dosya uzantısını varsayar. Uzantı da dahil olmak üzere yolu ve dosya adını belirtmek için PublishProfile özelliği yerine PublishProfileFullPath özelliğini ayarlayın.

.pubxml dosyasında:

• PublishUrl, Visual Studio tarafından Yayımla hedefini belirtmek için kullanılır.
• PublishDir, CLI tarafından Yayımlama hedefini belirtmek için kullanılır.

Senaryonun tüm yerlerde çalışmasını istiyorsanız, bu özelliklerin ikisini de .pubxml dosyasında aynı değere başlatabilirsiniz. GitHub sorunu dotnet/sdk#20931 çözüldüğünde, bu özelliklerden yalnızca birinin ayarlanması gerekir.

.pubxml dosyasındaki bazı özellikler yalnızca Visual Studio tarafından kabul edilir ve dotnet publishüzerinde hiçbir etkisi yoktur. CLI'yı Visual Studio'nun davranışıyla daha uyumlu hale getirmek için çalışıyoruz. Ancak bazı özellikler CLI tarafından hiçbir zaman kullanılmaz. CLI ve Visual Studio hem yayımlamanın paketleme yönünü yapar hem de dotnet/sdk#29817 bu konuda daha fazla özellik için destek eklemeyi planlayan . Ancak CLI yayımlamanın dağıtım otomasyonu yönünü gerçekleştirmez ve bununla ilgili özellikler desteklenmez. dotnet publish tarafından desteklenmeyen en önemli .pubxml özellikleri, derlemeyi etkileyen aşağıdakilerdir:

• LastUsedBuildConfiguration
• Configuration
• Platform
• LastUsedPlatform
• TargetFramework
• TargetFrameworks
• RuntimeIdentifier
• RuntimeIdentifiers

MSBuild özellikleri

Aşağıdaki MSBuild özellikleri dotnet publishçıktısını değiştirir.

• PublishReadyToRun

  Uygulama derlemelerini ReadyToRun (R2R) biçiminde derler. R2R, önceden (AOT) derlemenin bir biçimidir. Daha fazla bilgi için bkz. ReadyToRun görüntüleri.

  Çalışma zamanı hatalarına neden olabilecek eksik bağımlılıklarla ilgili uyarıları görmek için PublishReadyToRunShowWarnings=truekullanın.

  PublishReadyToRun komut satırı yerine yayımlama profilinde belirtmenizi öneririz.

• PublishSingleFile

  Uygulamayı platforma özgü tek dosyalı yürütülebilir dosyaya paketler. Tek dosyalı yayımlama hakkında daha fazla bilgi içintek dosyalı paketleyici tasarım belgesine bakın.

  Bu seçeneği komut satırı yerine proje dosyasında belirtmenizi öneririz.

• PublishTrimmed

  Bağımsız bir yürütülebilir dosya yayımlarken uygulamanın dağıtım boyutunu azaltmak için kullanılmayan kitaplıkları kırpar. Daha fazla bilgi için bkz. bağımsız dağıtımları ve yürütülebilir dosyaları kırpma. .NET 6 SDK'sı ile kullanılabilir.

  Bu seçeneği komut satırı yerine proje dosyasında belirtmenizi öneririz.

Daha fazla bilgi için aşağıdaki kaynaklara bakın:

• MSBuild komut satırı başvurusu
• ASP.NET Core uygulama dağıtımı için Visual Studio yayımlama profillerini (.pubxml)
• dotnet msbuild

İş yükü bildirimi indirmeleri

Bu komutu çalıştırdığınızda, iş yükleri için reklam bildirimlerini zaman uyumsuz bir arka plan indirme işlemi başlatır. Bu komut tamamlandığında indirme işlemi hala çalışıyorsa indirme durdurulur. Daha fazla bilgi için bkz.Reklam bildirimleri.

Bağımsız değişken

• PROJECT|SOLUTION

  Yayımlayacak proje veya çözüm.

  • PROJECT, C#, F# veya Visual Basic proje dosyasının yolu ve dosya adı ya da C#, F# veya Visual Basic proje dosyası içeren bir dizinin yoludur. Dizin belirtilmezse, varsayılan olarak geçerli dizin olur.

  • SOLUTION, çözüm dosyasının (.sln uzantısı) yolu ve dosya adı ya da çözüm dosyası içeren bir dizinin yoludur. Dizin belirtilmezse, varsayılan olarak geçerli dizin olur.

Seçenekler

• -a|--arch <ARCHITECTURE>

  Hedef mimariyi belirtir. Bu, sağlanan değerin varsayılan RID ile birleştirildiği Çalışma Zamanı Tanımlayıcısı (RID)ayarlamak için bir kısaltma söz dizimidir. Örneğin, win-x64 makinesinde --arch x86 belirterek RID değerini win-x86olarak ayarlar. Bu seçeneği kullanırsanız -r|--runtime seçeneğini kullanmayın. .NET 6 Preview 7 sürümünden itibaren kullanılabilir.

• --artifacts-path <ARTIFACTS_DIR>

  Yürütülen komuttaki tüm derleme çıktı dosyaları, projeyle ayrılmış olarak belirtilen yolun altındaki alt klasörlere gider. Daha fazla bilgi için bkz. Artifacts Output Layout. .NET 8 SDK'sı ile kullanılabilir.

• -c|--configuration <CONFIGURATION>

  Derleme yapılandırmasını tanımlar. .NET 8 SDK'sı veya sonraki bir sürümle geliştiriyorsanız, komut TargetFramework net8.0 veya sonraki bir sürüme ayarlanmış projeler için varsayılan olarak Release yapılandırmasını kullanır. Varsayılan derleme yapılandırması, SDK'nın önceki sürümleri ve önceki hedef çerçeveler için Debug. Proje ayarlarında veya bu seçeneği kullanarak varsayılanı geçersiz kılabilirsiniz. Daha fazla bilgi için bkz. 'dotnet publish' Release configuration ve 'dotnet pack' uses Release configurationkullanır.

• --disable-build-servers

  Komutu kalıcı derleme sunucularını yoksaymaya zorlar. Bu seçenek, derleme önbelleğinin tüm kullanımını devre dışı bırakmak için tutarlı bir yol sağlar ve bu da bir derlemeyi sıfırdan zorlar. Önbelleklere güvenmeyen bir derleme, önbellekler herhangi bir nedenle bozulduğunda veya yanlış olduğunda kullanışlıdır. .NET 7 SDK'sı ile kullanılabilir.

• -f|--framework <FRAMEWORK>

  Belirtilen hedef çerçevesi için uygulamayıyayımlar. Proje dosyasında hedef çerçeveyi belirtmeniz gerekir.

• --force

  Son geri yükleme başarılı olsa bile tüm bağımlılıkların çözümlenmesine zorlar. Bu bayrağın belirtilmesi, project.assets.json dosyasını silmekle aynıdır.

• -?|-h|--help

  komutunun nasıl kullanılacağına ilişkin bir açıklama yazdırır.

• --interactive

  Komutun durmasına ve kullanıcı girişini veya eylemini beklemesine izin verir. Örneğin, kimlik doğrulamasını tamamlamak için. .NET Core 3.0 SDK'sı ile kullanılabilir.

• --manifest <PATH_TO_MANIFEST_FILE>

  Uygulamayla yayımlanan paket kümesini kırpmak için kullanılacak bir veya birkaç hedef bildirimini belirtir. Bildirim dosyası, komutunun çıkışının bir parçasıdır. Birden çok bildirim belirtmek için her bildirim için bir --manifest seçeneği ekleyin.

• --no-build

  Yayımlamadan önce projeyi oluşturmaz. Ayrıca --no-restore bayrağını örtük olarak ayarlar.

• --no-dependencies

  Projeden projeye başvuruları yoksayar ve yalnızca kök projeyi geri yükler.

• --nologo

  Başlangıç başlığını veya telif hakkı iletisini görüntülemez.

• --no-restore

  Komutu çalıştırırken örtük geri yükleme yürütmez.

• -o|--output <OUTPUT_DIRECTORY>

  Çıkış dizininin yolunu belirtir.

  Belirtilmezse, çerçeveye bağımlı yürütülebilir dosya ve platformlar arası ikili dosyalar için varsayılan olarak [project_file_folder]/bin/[configuration]/[framework]/publish/ olur. Bağımsız yürütülebilir dosya için varsayılan olarak [project_file_folder]/bin/[configuration]/[framework]/[runtime]/publish/ .

  Web projesinde, çıkış klasörü proje klasöründeyse, ardışık dotnet publish komutları iç içe çıktı klasörleriyle sonuçlanır. Örneğin, proje klasörü myprojectve yayımlama çıktı klasörü myproject/publishise ve iki kez çalıştırırsanız, ikinci çalıştırma myproject/publish/publish.config ve .json dosyaları gibi içerik dosyalarını yerleştirir. Yayımlama klasörlerinin iç içe olmasını önlemek için, doğrudan proje klasörünün altında bir yayımlama klasörü belirtin veya yayımlama klasörünü projeden dışlayın. publishoutputadlı bir yayımlama klasörünü dışlamak için, .csproj dosyasındaki PropertyGroup öğesine aşağıdaki öğeyi ekleyin:

  <DefaultItemExcludes>$(DefaultItemExcludes);publishoutput**</DefaultItemExcludes>
  

  • .NET 7.0.200 SDK ve üzeri

    Bir çözümde bu komutu çalıştırırken --output seçeneğini belirtirseniz, CLI çıkış yolunun belirsiz semantiği nedeniyle bir uyarı (7.0.200'de bir hata) yayar. --output seçeneğine izin verilmiyor çünkü tüm oluşturulan projelerin tüm çıkışları, çok hedefli projelerin yanı sıra doğrudan ve geçişli bağımlılıkların farklı sürümlerine sahip projelerle uyumlu olmayan belirtilen dizine kopyalanacak. Daha fazla bilgi için bkz. Çözüm düzeyi --output seçeneğiderlemeyle ilgili komutlar için artık geçerli değil.

  • .NET Core 3.x SDK ve üzeri

    Projeyi yayımlarken göreli bir yol belirtirseniz, oluşturulan çıkış dizini proje dosyası konumuna değil geçerli çalışma dizinine göredir.

    Çözüm yayımlarken göreli bir yol belirtirseniz, tüm projeler için tüm çıkış geçerli çalışma dizinine göre belirtilen klasöre gider. Yayımlama çıktısının her proje için ayrı klasörlere gitmesini sağlamak için, --output seçeneği yerine msbuild PublishDir özelliğini kullanarak göreli bir yol belirtin. Örneğin, dotnet publish -p:PublishDir=.\publish her proje için yayımlama çıktısını proje dosyasını içeren klasörün altındaki bir publish klasörüne gönderir.

  • .NET Core 2.x SDK

    Projeyi yayımlarken göreli bir yol belirtirseniz, oluşturulan çıkış dizini geçerli çalışma dizinine değil proje dosyası konumuna göredir.

    Çözüm yayımlarken göreli bir yol belirtirseniz, her projenin çıkışı proje dosyası konumuna göre ayrı bir klasöre gider. Çözüm yayımlarken mutlak bir yol belirtirseniz, tüm projeler için tüm yayımlama çıktısı belirtilen klasöre gider.

• --os <OS>

  Hedef işletim sistemini (OS) belirtir. Bu, sağlanan değerin varsayılan RID ile birleştirildiği Çalışma Zamanı Tanımlayıcısı (RID)ayarlamak için bir kısaltma söz dizimidir. Örneğin, win-x64 makinesinde --os linux belirterek RID değerini linux-x64olarak ayarlar. Bu seçeneği kullanırsanız -r|--runtime seçeneğini kullanmayın. .NET 6'dan itibaren kullanılabilir.

• --sc|--self-contained [true|false]

  Çalışma zamanının hedef makineye yüklenmesi gerekmemesi için .NET çalışma zamanını uygulamanızla yayımlar. Çalışma zamanı tanımlayıcısı belirtilirse ve proje yürütülebilir bir projeyse (kitaplık projesi değil) varsayılan true. Daha fazla bilgi için bkz. .NET uygulama yayımlama ve .NET uygulamalarını .NET CLIile yayımlama .

  Bu seçenek true veya falsebelirtilmeden kullanılıyorsa, varsayılan olarak true. Bu durumda, çözüm veya proje bağımsız değişkenini --self-containedhemen sonra koymayın çünkü true veya false bu konumda olması beklenir.

• --no-self-contained

  --self-contained falseeşdeğerdir.

• --source <SOURCE>

  Geri yükleme işlemi sırasında kullanılacak NuGet paket kaynağının URI'sini.

• -r|--runtime <RUNTIME_IDENTIFIER>

  Belirli bir çalışma zamanı için uygulamayı yayımlar. Çalışma Zamanı Tanımlayıcılarının (RID) listesi için bkz. RID kataloğu. Daha fazla bilgi için bkz. .NET uygulama yayımlama ve .NET uygulamalarını .NET CLIile yayımlama . Bu seçeneği kullanıyorsanız --self-contained veya --no-self-contained de kullanın.

• --tl:[auto|on|off]

  Derleme çıktısı için terminal günlükçü kullanılıp kullanılmayacağını belirtir. Varsayılan değer, terminal günlüğünü etkinleştirmeden önce ortamı doğrulayan autodeğeridir. Ortam denetimi, terminalin modern çıkış özelliklerini kullanabileceğini ve yeni günlükçü'leri etkinleştirmeden önce yeniden yönlendirilmiş standart çıkış kullanmadığını doğrular. on ortam denetimini atlar ve terminal günlüğünü etkinleştirir. off ortam denetimini atlar ve varsayılan konsol günlükçüsunu kullanır.

  Terminal günlükçü, geri yükleme aşamasını ve ardından derleme aşamasını gösterir. Her aşamada, şu anda oluşturulan projeler terminalin en altında görünür. Derlemeye alınan her proje, hem şu anda derlenen MSBuild hedefini hem de bu hedefe harcanan süreyi oluşturur. Derleme hakkında daha fazla bilgi edinmek için bu bilgileri arayabilirsiniz. Bir projenin oluşturulması tamamlandığında, şunları yakalayan tek bir "derleme tamamlandı" bölümü yazılır:

  • Oluşturulan projenin adı.
  • Hedef çerçeve (çok hedefliyse).
  • Bu derlemenin durumu.
  • Bu derlemenin birincil çıkışı (köprüdür).
  • Bu proje için oluşturulan tüm tanılamalar.

  Bu seçenek .NET 8'den itibaren kullanılabilir.

• --use-current-runtime, --ucr [true|false]

  RuntimeIdentifier, makinenizin birine göre taşınabilir bir platform RuntimeIdentifier ayarlar. Bu, SelfContained, PublishAot, PublishSelfContained, PublishSingleFileve PublishReadyToRungibi bir RuntimeIdentifiergerektiren özelliklerde örtük olarak gerçekleşir. Özelliği false olarak ayarlanırsa, bu örtük çözüm artık gerçekleşmez.

• -v|--verbosity <LEVEL>

  Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , m[inimal], n[ormal], d[etailed]ve diag[nostic]q[uiet]. Varsayılan değer minimal. Daha fazla bilgi için bkz. LoggerVerbosity.

• --version-suffix <VERSION_SUFFIX>

  Proje dosyasının sürüm alanındaki yıldız işareti (*) yerine geçecek sürüm sonekini tanımlar.

Örnekler

• Geçerli dizindeki proje için çerçevesine bağımlı platformlar arası ikili oluşturun:

  dotnet publish
  

  .NET Core 3.0 SDK'sı ile başlayarak, bu örnek geçerli platform için çerçeveye bağımlı yürütülebilir de oluşturur.

• Belirli bir çalışma zamanı için geçerli dizindeki proje için bağımsız yürütülebilir oluşturun:

  dotnet publish --runtime osx-x64
  

  RID proje dosyasında olmalıdır.

• Belirli bir platform için geçerli dizindeki proje için çerçevesine bağımlı yürütülebilir oluşturun:

  dotnet publish --runtime osx-x64 --self-contained false
  

  RID proje dosyasında olmalıdır. Bu örnek .NET Core 3.0 SDK ve sonraki sürümler için geçerlidir.

• Projeyi belirli bir çalışma zamanı ve hedef çerçeve için geçerli dizinde yayımlayın:

  dotnet publish --framework net8.0 --runtime osx-x64
  

• Belirtilen proje dosyasını yayımlayın:

  dotnet publish ~/projects/app1/app1.csproj
  

• Geçerli uygulamayı yayımlayın ancak projeden projeye (P2P) başvuruları geri yüklemeyin; geri yükleme işlemi sırasında yalnızca kök proje:

  dotnet publish --no-dependencies
  

Ayrıca bkz.

• .NET uygulaması yayımlamaya genel bakış
• .NET CLI ile .NET uygulamalarını yayımlamayı
• hedef çerçeveleri
• Çalışma Zamanı Tanımlayıcısı (RID) kataloğu
• dotnet publish ile bir .NET uygulamasını kapsayıcılı hale
• macOS Catalina Notarization ile çalışma
• Yayımlanmış bir uygulama Dizin yapısı
• MSBuild komut satırı başvurusu
• ASP.NET Core uygulama dağıtımı için Visual Studio yayımlama profillerini (.pubxml)
• dotnet msbuild
• Bağımsız dağıtımları kırpma