MSBuild Komut Satırı Başvurusu
Bir proje veya çözüm dosyası oluşturmak için MSBuild.exe'yi kullandığınızda, işlem çeşitli yönlerini belirtmek için birkaç anahtar içerebilir.
MSBuild.exe [Switches] [ProjectFile]
Değişkenler
Bağımsız Değişken |
Tanımlama |
---|---|
ProjectFile |
Proje dosyasında belirttiğiniz hedefleri oluşturur. Bir proje dosyası belirtmezseniz, MSBuild "proj" içinde sona erer ve bu dosyayı kullanan bir dosya adı uzantısının geçerli çalışma dizini arar. Ayrıca, bu bağımsız değişken için bir Visual Studio çözümü dosyası belirtebilirsiniz. |
Anahtarları
Anahtarı |
Kısa biçim |
Tanımlama |
---|---|---|
/help |
/? veya /h |
Kullanım bilgisini görüntüler. Aşağıdaki komut bir örnektir: msbuild.exe /? |
/detailedsummary |
/DS |
Yapý günlüðüne sonunda oluşturulan yapılandırmaları ve nasıl bunlar düğümleri için zamanlanmış ilgili ayrıntılı bilgileri gösterir. |
/ignoreprojectextensions:extensions |
/ yoksay:extensions |
Belirtilen uzantıları oluşturmak için hangi proje dosyası belirlerken yoksayar. Aşağıdaki örnekte gösterildiği gibi birden çok uzantı ayırmak için noktalı virgül veya virgül kullanın: /ignoreprojectextensions:.vcproj,.sln |
/maxcpucount [:number |
/m[:number |
Eş zamanlı işlemler oluştururken kullanılacak en fazla sayısını belirtir. Bu anahtarı içermiyorsa, varsayılan değer 1'dir. Bu anahtar değeri belirtmeden eklerseniz, MSBuild için bilgisayardaki işlemci sayısına kullanacağı. Daha fazla bilgi için bkz. MSBuild ile Paralel Olarak Birden Çok Proje Derleme. Aşağıdaki örnek aynı anda hem oluşturmak üç proje sağlayan üç MSBuild işlem kullanarak oluşturmak için MSBuild bildirir: msbuild myproject.proj /maxcpucount:3 |
/ noautoresponse |
/noautorsp |
MSBuild.rsp dosyaları otomatik olarak dahil etmeyin. |
/nodeReuse:value |
/nr:value |
Etkinleştirmek veya devre dışı kullanımların MSBuild düğüm. Aşağıdaki değerleri belirleyebilirsiniz:
Bir düğüm için bir proje yürütüyor karşılık gelir. Dahil ederseniz /maxcpucount anahtarı, birden fazla düğümün aynı anda yürütebilir. |
/nologo |
Başlangıç başlığı veya telif hakkı iletisini gösterme. |
|
/ önişlem [:filepath |
/pp[:filepath |
Tarafından toplanan, tek proje dosyasını oluşturmak katıştırarak tüm bunların sınırları ile bir yapı sırasında alınan dosyaları olarak işaretlenmiş. Hangi dosyaların içe daha kolay belirlemek için bu anahtarı kullanın, dosyaların nerede alınan ve hangi dosyaları yapı katkıda. Bu anahtarı kullandığınızda, proje oluþturulmaz. Belirttiğiniz bir filepath, çıktı dosyasına toplanmış proje dosyasıdır. Aksi durumda, çıktı konsol penceresinde görüntülenir. Nasıl kullanılacağı hakkında bilgi için Import öğesi bir proje dosyasını başka bir proje dosyasına eklemek için bkz: İçe aktar öğesini (MSBuild) ve Nasıl yapılır: aynı hedefte birden çok proje dosyalarında kullanma. |
/Property:name=value |
/p:name=value |
Belirtilen proje düzeyi özelliklerini geçersiz kılmak veya set nerede name özellik adı ve value özellik değeri. Ayrı ayrı her özelliği belirtin veya aşağıdaki örnekte gösterildiği gibi birden çok özelliği ayırmak için noktalı virgül veya virgül kullanın: /property:WarningLevel=2;OutputDir=bin\Debug |
/ target:targets |
/ t:targets |
Proje alanında belirtilen hedefleri oluşturun. Her hedef ayrı ayrı belirtin veya aşağıdaki örnekte gösterildiği gibi birden çok hedefi ayırmak için noktalı virgül veya virgül kullanın: /target:Resources;Compile Bu anahtarı kullanarak tüm hedefleri belirtirseniz, bunlar tüm hedeflerin yerine çalıştırılan DefaultTargets proje dosyasında öznitelik. Daha fazla bilgi için, bkz. Hedef oluþturulma sýrasý ve Nasıl yapılır: hangi yapı için ilk hedef belirleme. Bir hedef görevleri oluşan bir gruptur. Daha fazla bilgi için bkz. MSBuild hedefleri. |
/toolsversion:version |
/TV:version |
Aşağıdaki örnekte gösterildiği gibi projeyi oluşturmak için kullanılacak araç takımı sürümünü belirtir:/toolsversion:3.5 Bu anahtarı kullanarak, bir proje oluşturmak ve belirtilen sürümünden farklı bir sürüm belirtmek Proje öğesini (MSBuild). Daha fazla bilgi için bkz. ToolsVersion ayarlarını geçersiz kılma. MSBuild 4.5 için aşağıdaki değerleri belirleyebilirsiniz version: 2.0, 3.5 ve 4.0. 4. 0'ı belirtirseniz, VisualStudioVersion yapı özelliği kullanmak için hangi alt toolset belirtir. Toolsets alt bölümünde daha fazla bilgi için bkz: MSBuild Araç Takımı (ToolsVersion). Bir araç takımı, görevler, hedefler ve bir uygulama oluşturmak için kullanılan araçları içerir. Derleyiciler csc.exe ve vbc.exe gibi araçlar içerir. Toolsets hakkında daha fazla bilgi için bkz: MSBuild Araç Takımı (ToolsVersion), Standart ve Özel Araç Takımı Yapılandırmaları, ve MSBuild Multitargeting genel bakış.
Not
Araç Takımı sürüm bir projeyi çalıştıracak şekilde tasarlanmış .NET Framework sürümü hedef framework, aynı değildir.Daha fazla bilgi için bkz. Framework MSBuild hedef ve hedef platformu.
|
/ validate: schema |
/valschema |
Proje dosyasını doğrulamak ve doğrulama başarılı olursa, projeyi derleyin. Belirtmezseniz, schema, project varsayılan şemaya göre doğrulanır. Belirtirseniz schema, proje, belirttiğiniz şemaya göre doğrulanır. Aşağıdaki ayarı bir örnektir:/validate:MyExtendedBuildSchema.xsd |
/verbosity:level |
v:level |
Yapı günlük dosyasında görüntülemek için bilgi miktarını belirtir. Bu logger için ayarladığınız ayrıntı düzeyi olaylara her günlükçü görüntüler. Aşağıdaki ayrıntı düzeylerini belirtebilirsiniz: q[uiet], m[inimal], n[ormal], d[etailed], ve diag[nostic]. Aşağıdaki ayarı bir örnektir:/verbosity:quiet |
/version |
/ ver |
Sürüm bilgilerini görüntüleyin. Proje oluþturulmaz. |
@file |
Komut satırı anahtarları metin dosyasından yerleştirin. Birden çok dosya varsa, bunları ayrı ayrı belirtin. Daha fazla bilgi için bkz. MSBuild yanıt dosyaları. |
Loggers için anahtarları
Anahtarı |
Kısa biçim |
Tanımlama |
---|---|---|
/consoleloggerparameters:parameters |
/clp:parameters |
Yapı bilgisini konsol penceresinde görüntüler Konsolu logger için belirttiğiniz parametreleri geçirin. Aşağıdaki parametreler belirtebilirsiniz:
Aşağıdaki örnekte gösterildiği gibi birden çok parametre ayırmak için noktalı virgül veya virgül kullanın: /consoleloggerparameters:PerformanceSummary;NoSummary /verbosity:minimal |
/distributedFileLogger |
/dfl |
MSBuild her düğümün yapı çıktı dosyasına kendi oturum. Bu dosyaların başlangıçtaki konumu geçerli dizindir. Varsayılan olarak, dosyaların adlandırıldığı "MSBuildnodeId.log". Kullanabileceğiniz /fileLoggerParameters dosyaları ve diğer parametreleri fileLogger konumunu belirtmek için anahtar. Kullanarak bir günlük dosyası adı, /fileLoggerParameters anahtarı, dağıtılmış günlükçü kullanacağınız şablon olarak adlandırın ve düğüm kimliği her düğüm için bir günlük dosyası oluştururken, adının sonuna. |
/distributedlogger:central logger*forwarding logger |
/dl:central logger*forwarding logger |
Her düğüm için farklı günlükçü örneği ekleme MSBuild, günlük olayları. Birden çok loggers belirtmek için ayrı ayrı her Günlükçü belirtin. Günlükçü sözdizimi bir günlükçü belirtmek için kullanın. Günlükçü sözdizimi için bkz: /logger anahtarını tıklatın. Aşağıdaki örnekler bu anahtarı nasıl gösterir: /dl:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral /dl:MyLogger,C:\My.dll*ForwardingLogger,C:\Logger.dll |
/fileLogger[numara] |
/flnumber |
Geçerli dizindeki tek bir dosya oluşturma çıktısındaki oturum. Belirtmezseniz, number, çıktı dosyası msbuild.log olarak adlandırılır. Belirtirseniz number, çıktı dosyası msbuild adlınn .log, number. Number9 1 arasında bir rakam olabilir. Kullanabileceğiniz /fileLoggerParameters dosya ve diğer parametreleri fileLogger konumunu belirtmek için anahtar. |
/fileloggerparameters: [sayı]parameters |
/flp:numberparameters |
Dosya günlükçü ve dağıtılmış dosya günlükçü için herhangi bir ek parametreleri belirtir. Bu anahtarın varlığı anlamına gelir karşılık gelen /filelogger[number] anahtar. Number9 1 arasında bir rakam olabilir. Tüm parametreler için listelenen kullanabilirsiniz /consoleloggerparameters. Bir veya daha aşağıdaki parametreleri de kullanabilirsiniz:
Aşağıdaki örnek, uyarılar ve hatalar için ayrı günlük dosyaları oluşturur: /flp1:logfile=errors.txt;errorsonly /flp2:logfile=warnings.txt;warningsonly Diğer olasılıklar aşağıdaki örneklerde gösterilmektedir: /fileLoggerParameters:LogFile=MyLog.log;Append; Verbosity=diagnostic;Encoding=UTF-8 /flp:Summary;Verbosity=minimal;LogFile=msbuild.sum /flp1:warningsonly;logfile=msbuild.wrn /flp2:errorsonly;logfile=msbuild.err |
/Logger:logger |
/ l:logger |
MSBuild olayları günlüğe kaydetmek için kullanılacak günlükçü belirtir. Birden çok loggers belirtmek için ayrı ayrı her Günlükçü belirtin. İçin aşağıdaki sözdizimini kullanın logger:[LoggerClass,]LoggerAssembly[;LoggerParameters] İçin aşağıdaki sözdizimini kullanın LoggerClass:[PartialOrFullNamespace.]LoggerClassName Günlükçü sınıfı tam olarak bir Günlükçü derlemesi varsa belirtmeniz gerekmez. İçin aşağıdaki sözdizimini kullanın LoggerAssembly:{AssemblyName[,StrongName] |AssemblyFile} Günlükçü parametreler isteğe bağlıdır ve tam olarak girdiğiniz gibi Oluşturucusu'na aktarılır. Aşağıdaki örnekler /logger geçin. /logger:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral /logger:XMLLogger,C:\Loggers\MyLogger.dll;OutputAsHTML |
/noconsolelogger |
/noconlog |
Varsayılan konsol günlükçüsünü devre dışı bırakın ve olayları konsolunda oturum yok. |
Örnek
Aşağıdaki örnek oluşturur rebuild hedefi, MyProject.proj proje.
MSBuild.exe MyProject.proj /t:rebuild
MSBuild.exe, daha karmaşık yapıları gerçekleştirmek için kullanabilirsiniz. Örneğin, belirli projelerin bir çözümde belirli hedefleri oluşturmak için kullanabilirsiniz. Aşağıdaki örnek proje oluşturur NotInSolutionFolder ve proje temizler InSolutionFolder, içinde olduğu NewFolder çözüm klasörü.
msbuild SlnFolders.sln /t:NotInSolutionfolder:Rebuild;NewFolder\InSolutionFolder:Clean
Ayrıca bkz.
Başvuru
Ortak MSBuild Proje Özellikleri