MSBuild Komut Satırı Başvurusu
Proje veya çözüm dosyası oluşturmak için MSBuild.exe'yi kullandığınızda, çeşitli yönlerini işlemi belirtmek için birkaç anahtar içerebilir.
MSBuild.exe [Switches] [ProjectFile]
Arguments
Bağımsız Değişken |
Açıklama |
---|---|
ProjectFile |
Proje dosyasında belirttiğiniz hedefleri oluşturur.Bir proje dosyası belirtmezseniz, o anda çalışan dizinin "proj" içinde sona erer ve bu dosyayı kullanan bir dosya adı uzantısı için MSBuild arar.Visual Studio çözüm dosyası bu bağımsız değişken için de belirtebilirsiniz. |
Anahtarlar
Anahtarı |
Kısa biçim |
Açıklama |
---|---|---|
/help |
/?veya /h |
Kullanım bilgileri görüntüler.Aşağıdaki komutu bir örnek verilmiştir: msbuild.exe /? |
/detailedsummary |
/DS |
Yapı günlük sonundaki oluşturulan yapılandırmaları ve bunların düğümlerini nasıl zamanlanmış ilgili ayrıntılı bilgileri gösterir. |
/ignoreprojectextensions:extensions |
/ Yoksay:extensions |
Belirtilen uzantılara göz ardı oluşturmak için hangi proje dosyası belirlenirken.Aşağıdaki örnekte gösterildiği gibi birden çok uzantıları ayırmak için noktalı virgül veya virgül kullanın: /ignoreprojectextensions:.vcproj,.sln |
/maxcpucount [:number] |
/m[:number] |
En fazla oluşturulurken kullanılacak eşzamanlı işlem sayısını belirtir.Bu anahtar dahil etmezseniz, varsayılan değer 1'dir.Bir değer belirterek olmadan bu anahtarı dahil, MSBuild bilgisayardaki işlemci sayısının kullanacağınız.Daha fazla bilgi için bkz. MSBuild ile Paralel Olarak Birden Çok Proje Derleme. Aşağıdaki örnek, aynı anda oluşturmak üç projeleri sağlayan üç MSBuild işlem kullanarak oluşturmak için MSBuild bildirir: msbuild myproject.proj /maxcpucount:3 |
/ noautoresponse |
/noautorsp |
Tüm MSBuild.rsp dosyalarını otomatik olarak eklemeyin. |
/nodeReuse:value |
/nr:value |
Etkinleştirmek veya yeniden kullanım MSBuild düğümleri devre dışı bırakabilir.Aşağıdaki değerlerden belirtebilirsiniz:
Bir düğümü çalışan bir proje karşılık gelir.Eklerseniz /maxcpucount anahtarı, birden çok düğüm aynı anda yürütebilirsiniz. |
/nologo |
Başlangıç başlığı veya telif hakkı iletisini görüntüleme. |
|
/ önişlem [:filepath] |
/pp[:filepath] |
Tarafından toplanan, tek bir proje dosyası oluşturmak katıştırarak tüm işaretlenmiş bir yapı, bunların sınırlarını ile sırasında alınması dosyalar.Bu geçiş daha kolay hangi dosyaların içe belirlemek için kullanabileceğiniz, dosyaları nerede içe ve hangi dosyaları yapı katkıda.Bu anahtarı kullandığınızda, proje yerleşik değildir. Belirtirseniz, bir filepath, çıkış dosyasına toplanmış proje dosyasıdır.Aksi halde, çıkış konsol penceresi içinde görüntülenir. Nasıl kullanıldığı hakkında bilgi için Import bir proje dosyası başka bir proje dosyasına eklemek için bkz İçeri Aktarma Öğesi (MSBuild) ve Nasıl Yapılır: Birden Çok Proje Dosyasında Aynı Hedefi Kullanma. |
/Property:name=value |
/p:name=value |
Ayarlayın veya belirtilen proje düzeyi özellikleri geçersiz kılma nerede name özellik adı ve value özellik değeri.Ayrı ayrı her bir özellik belirtin veya aşağıdaki örnekte gösterildiği gibi birden çok özellik ayırmak için noktalı virgül veya virgül kullanın: /property:WarningLevel=2;OutDir=bin\Debug |
/ target:targets |
/ t:targets |
Belirtilen hedeflerin projenizdeki oluşturun.Ayrı ayrı her hedefini belirtin veya birden çok hedefleri, aşağıdaki örnekte gösterildiği gibi ayırmak için noktalı virgül veya virgül kullanın: /target:Resources;Compile Bu anahtarını kullanarak tüm hedefleri belirtirseniz, bulunan tüm hedefler yerine çalıştıkları DefaultTargets proje dosyasında özniteliği.Daha fazla bilgi için bkz. Hedef Derleme Sırası ve Nasıl Yapılır: Önce Hangi Hedefin Derleneceğini Belirtme. Bir hedef görevleri grubudur.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 bir araç takımı sürümünü belirtir:/toolsversion:3.5 Bu anahtarını kullanarak, bir proje oluşturun ve belirtilen sürümden farklı bir sürüm belirtmek Proje Öğesi (MSBuild).Daha fazla bilgi için bkz. ToolsVersion Ayarlarını Geçersiz Kılma. MSBuild 4.5 için aşağıdaki değerleri belirtebilirsiniz version: 2.0, 3.5 ve 4.0.4.0 belirtirseniz, VisualStudioVersion yapı özelliği hangi sub-kullanmak için bir araç takımı belirtir.Daha fazla bilgi için alt toolsets bölümüne bakın MSBuild Araç Takımı (ToolsVersion). Bir araç takımı görevleri, hedefleri ve bir uygulama oluşturmak için kullanılan araçları oluşur.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 Çoklu Sürüm Desteğine Genel Bakış.
|
/ doğrulamak: [schema] |
/val[schema] |
Proje dosyası doğrulamak ve doğrulama başarılı olursa, proje oluşturun. Belirtmezseniz, schema, proje varsayılan şemasına göre doğrulanır. Belirtirseniz schema, proje belirttiğiniz şemasına göre doğrulanır. Aşağıdaki ayarı bir örnek verilmiştir:/validate:MyExtendedBuildSchema.xsd |
/verbosity:level |
v:level |
Yapı günlüğünde görüntülemek için bilgi miktarını belirtir.Her Günlükçü bu Günlükçü için ayarlanan ayrıntı düzeyi temel olayları görüntüler. Aşağıdaki ayrıntı düzeyleri belirtebilirsiniz: q[uiet], m[inimal], n[ormal], d[etailed], ve diag[nostic]. Aşağıdaki ayarı bir örnek verilmiştir:/verbosity:quiet |
/ VERSION |
/ ver |
Sürüm bilgileri görüntüler.Proje yerleşik değildir. |
@file |
Komut satırı anahtarları metin dosyasından ekleyin.Birden çok dosyanız varsa, bunları ayrı olarak belirtin.Daha fazla bilgi için bkz. MSBuild Yanıt Dosyaları. |
Günlükçüler için anahtarlar
Anahtarı |
Kısa biçim |
Açıklama |
---|---|---|
/consoleloggerparameters: parameters |
/clp:parameters |
Belirttiğiniz konsol penceresinde yapı bilgileri görüntüler konsol Günlükçü için parametreler.Aşağıdaki parametreleri belirtebilirsiniz:
Aşağıdaki örnekte gösterildiği gibi birden çok parametreleri ayırmak için noktalı virgül veya virgül kullanın: /consoleloggerparameters:PerformanceSummary;NoSummary /verbosity:minimal |
/distributedFileLogger |
/dfl |
Her MSBuild düğüm yapı çıkışını kendi dosyasına oturum.İlk bu dosyaların geçerli dizin konumdur.Varsayılan olarak, dosyaları adlandırılır "MSBuildnodeId.log".Kullanabileceğiniz /fileLoggerParameters dosyalar için ve diğer parametreleri fileLogger konumunu belirlemek için anahtarı. Kullanarak bir günlük dosyası adında /fileLoggerParameters anahtarın, dağıtılmış Günlükçü kullanacağı, şablon olarak bir ad verin ve her düğüm için günlük dosyasını oluştururken, o ada düğüm kimliği ekleyin. |
/distributedlogger: central logger* forwarding logger |
/dl:central logger*forwarding logger |
Her düğüm için farklı Günlükçü örneği ekleme MSBuild, gelen olayları günlüğe kaydeder.Birden çok loggers belirtmek için ayrı ayrı her Günlükçü belirtin. Günlükçü sözdizimi Günlükçü belirtmek için kullanın.Günlükçü sözdizimi için bkz /logger aşağıdaki anahtarı. Aşağıdaki örnekler bu anahtarı kullanmak nasıl kullanılacağını göstermektedir: /dl:XMLLogger,MyLogger,Version=1.0.2,Culture=neutral /dl:MyLogger,C:\My.dll*ForwardingLogger,C:\Logger.dll |
/fileLogger [sayı] |
/fl[number] |
Tek bir dosyaya geçerli dizindeki yapı çıkışını oturum.Belirtmezseniz, number, çıkış dosyasını msbuild.log olarak adlandırılır.Belirtirseniz number, çıkış dosyası msbuild adlınn .log number.Number9 1 arasında bir sayı olabilir. Kullanabileceğiniz /fileLoggerParameters dosya için ve diğer parametreleri fileLogger konumunu belirlemek için anahtarı. |
/fileloggerparameters: [sayı] parameters |
/flp:[ number]parameters |
Dosya Günlükçü ve dağıtılmış dosya Günlükçü için ek parametreler belirtir.Bu anahtar varlığını, anlamına gelir ilgili /filelogger[number] anahtarı.Number9 1 arasında bir sayı olabilir. İçin listelenen tüm parametreleri kullanabilirsiniz /consoleloggerparameters.Ayrıca, bir veya daha fazlasını şu parametreleri kullanabilirsiniz:
Aşağıdaki örnek, uyarı ve hatalar için ayrı günlük dosyaları oluşturur: /flp1:logfile=errors.txt;errorsonly /flp2:logfile=warnings.txt;warningsonly Aşağıdaki örnekler diğer olanaklar göster: /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'den olayları günlüğe kaydetmek için kullanılan Günlükçü belirtir.Birden çok loggers belirtmek için ayrı ayrı her Günlükçü belirtin. İçin aşağıdaki sözdizimini kullanan logger:[LoggerClass,]LoggerAssembly[;LoggerParameters] İçin aşağıdaki sözdizimini kullanan LoggerClass:[PartialOrFullNamespace.]LoggerClassName Derleme tam olarak bir Günlükçü içeriyorsa Günlükçü sınıfı belirtmek zorunda değilsiniz. İçin aşağıdaki sözdizimini kullanan LoggerAssembly:{AssemblyName[,StrongName] | AssemblyFile} Günlükçü parametre isteğe bağlıdır ve Günlükçü için girdiğiniz tam olarak geçirilir. 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çü devre dışı bırakmak ve olayları konsola oturum yoktur. |
Ö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 bir çözümde belirli projeleri hedeflerini 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
Yaygın MSBuild Proje Özellikleri