Komut satırında MSBuild - C++

Genel olarak, proje özelliklerini ayarlamak ve MSBuild sistemini çağırmak için Visual Studio kullanmanızı öneririz. Ancak, MSBuild aracını doğrudan komut isteminden kullanabilirsiniz. Derleme işlemi, oluşturabileceğiniz ve düzenleyebileceğiniz bir proje dosyasındaki (.vcxproj) bilgilerle denetlenebilir. Proje dosyası derleme aşamalarına, koşullarına ve olaylarına göre derleme seçeneklerini belirtir. Ayrıca, sıfır veya daha fazla komut satırı seçeneği bağımsız değişkeni belirtebilirsiniz.

msbuild.exe [ project_file ] [ options ]

Proje dosyasında belirtilen belirli özellikleri ve hedefleri geçersiz kılmak için /target (veya /t) ve /property (veya /p) komut satırı seçeneklerini kullanın.

Proje dosyasının temel işlevlerinden biri, projenize uygulanan belirli bir işlem olan bir hedef ve bu işlemi gerçekleştirmek için gereken giriş ve çıkışları belirtmektir. Proje dosyası, varsayılan hedefi içerebilen bir veya daha fazla hedef belirtebilir.

Her hedef bir veya daha fazla görevden oluşan bir diziden oluşur. Her görev, bir yürütülebilir komut içeren bir .NET Framework sınıfıyla temsil edilir. Örneğin, CL görevi cl.exe komutunu içerir.

Görev parametresi, sınıf görevinin bir özelliğidir ve genellikle yürütülebilir komutun komut satırı seçeneğini temsil eder. Örneğin, FavorSizeOrSpeed görevin parametresi CL /Os ve /Ot derleyici seçeneklerine karşılık gelir.

Ek görev parametreleri MSBuild altyapısını destekler. Örneğin, Sources görev parametresi diğer görevler tarafından kullanılabilecek bir görev kümesini belirtir. MSBuild görevleri hakkında daha fazla bilgi için bkz . Görev Başvurusu.

Çoğu görev için dosya adları, yollar ve dize, sayısal veya Boole parametreleri gibi girişler ve çıkışlar gerekir. Örneğin, ortak giriş derlenecek bir .cpp kaynak dosyasının adıdır. Önemli bir giriş parametresi, derleme yapılandırmasını ve platformunu belirten bir dizedir; örneğin, "Debug|Win32". Girişler ve çıkışlar, bir ItemGroup öğede bulunan bir veya daha fazla kullanıcı tanımlı XML Item öğesi tarafından belirtilir.

Proje dosyası, kullanıcı tanımlı özellikleri ve ItemDefinitionGroupöğeleri de belirtebilir. Özellikler ve öğeler, derlemede değişken olarak kullanılabilecek ad/değer çiftlerini oluşturur. Bir çiftin ad bileşeni bir makro tanımlar ve değer bileşeni makro değerini bildirir. Özellik makrosna $(name) gösterimi kullanılarak erişilir ve öğe makrosna %(ad) gösterimi kullanılarak erişilir.

Proje dosyasındaki diğer XML öğeleri makroları test edebilir ve sonra herhangi bir makronun değerini koşullu olarak ayarlayabilir veya derlemenin yürütülmesini denetleyebilir. Makro adları ve değişmez değer dizeleri, yol ve dosya adı gibi yapılar oluşturmak için birleştirilebilir. Komut satırında /property seçeneği bir proje özelliğini ayarlar veya geçersiz kılar. Komut satırında öğelere başvurulamaz.

MSBuild sistemi, bir hedefi başka bir hedef öncesinde veya sonrasında koşullu olarak yürütebilir. Ayrıca sistem, hedefin tükettiği dosyaların yaydığı dosyalardan daha yeni olup olmadığına bağlı olarak bir hedef oluşturabilir.

MSBuild hakkında daha fazla bilgi için bkz:

• MSBuild kavramlarına MSBuild'e Genel Bakış.

• MSBuild sistemi hakkında MSBuild Başvuru Başvurusu bilgileri.

• Proje Dosyası Şema Başvurusu MSBuild XML Şeması öğelerini öznitelikleri ve üst ve alt öğeleriyle birlikte listeler. Özellikle ItemGroup, PropertyGroup, Target ve Task öğelerini not edin.

• Komut Satırı Başvurusu msbuild.exe ile kullanabileceğiniz komut satırı bağımsız değişkenlerini ve seçeneklerini açıklar.

• Görev Başvurusu MSBuild görevlerini açıklar. Özellikle Visual C++'a özgü bu görevlere dikkat edin: BscMake Görevi, CL Görevi, CPPClean Görevi, LIB Görevi, Görev Bağla, MIDL Görevi, MT Görevi, RC Görevi, SetEnv Görevi, VCMessage Görevi

Bu Bölümde

Süre	Tanım
İzlenecek yol: C++ Projesi Oluşturmak için MSBuild Kullanma	MSBuild kullanarak Visual Studio C++ projesi oluşturmayı gösterir.
Nasıl Yapılır: MSBuild Projelerinde Derleme Olaylarını Kullanma	Derleme başlamadan önce derlemedeki bir particuler aşamasında gerçekleşen bir eylemin nasıl belirtileceğini gösterir; bağlantı adımı başlamadan önce; veya derleme bittikten sonra.
Nasıl Yapılır: MSBuild Projelerine Özel Derleme Adımı Ekleme	Derleme dizisine kullanıcı tanımlı bir aşamanın nasıl ekleneceğini gösterir.
Nasıl Yapılır: MSBuild Projelerine Özel Derleme Araçları Ekleme	Derleme aracının belirli bir dosyayla nasıl ilişkilendirileceklerini gösterir.
Nasıl Yapılır: Özel Araçlarla Proje Özelliklerini Tümleştirme	Proje özelliklerine özel bir araç için seçeneklerin nasıl ekleneceğini gösterir.
Nasıl Yapılır: Hedef Framework ve Platform Araç Kümesini Değiştirme	Birden çok çerçeve veya araç kümesi için proje derlemeyi gösterir.

Ayrıca bkz.

Komut satırından MSVC araç takımını kullanma