MSBuild

Bu Microsoft Build Engine, uygulamalar için bir platformdur. MSBuild olarak da bilinen bu altyapı, derleme platformunun yazılım işleme ve derleme işlemlerini kontrol eden bir proje dosyası için bir XML şeması sağlar. Visual Studio, MSBuild kullanır, MSBuild veri türüne Visual Studio. Projeniz msbuild.exe çözüm dosyanıza bir uygulama kullanarak, uygulamanın yüklenmemiş olduğu ortamlarda Visual Studio ve derlemeniz gerekir.

Visual Studio yönetilen MSBuild yüklemek ve derlemek için MSBuild kullanır. Visual Studio (.csproj, .vbproj, .vcxproj ve diğerleri) proje dosyaları, IDE kullanarak bir proje derlemeniz zaman yürütülen MSBuild XML kodunu içerir. Visual Studio tüm gerekli ayarları ve derleme işlemlerini tipik geliştirme çalışmaları yapmak için içeri aktarabilirsiniz, ancak bunları bir XML düzenleyicisi kullanarak veya Visual Studio içinde genişletebilirsiniz veya değiştirebilirsiniz.

C++ için MSBuild bilgi için bkz. MSBuild (C++).

Aşağıdaki örnekler, IDE yerine komut MSBuild derlemeleri ne zaman çalıştırabilirsiniz Visual Studio göstermektedir.

• Visual Studio yüklü değil. (MSBuild olmadan Visual Studioindirin.)

• MSBuild'nin 64 bit sürümünü kullanmak ve Visual Studio 2019 veya önceki bir sürümü kullanıyorsanız. Bu MSBuild genellikle gereksizdir, ancak daha fazla belleğe MSBuild izin verir.

• Bir derlemeyi birden çok işlemde çalıştırmak istediğiniz. Ancak, C++ ve C# projelerinde aynı sonucu elde etmek için IDE'yi kullanabilirsiniz.

• Derleme sistemini değiştirmek istediğiniz. Örneğin, aşağıdaki eylemleri etkinleştirmek istiyor olabilir:

  • Dosyaları derleyiciye ulaşmadan önce ön işleme.

  • Derleme çıkışlarını farklı bir yere kopyalayın.

  • Derleme çıkışlarından sıkıştırılmış dosyalar oluşturun.

  • İşleme sonrası adımını yapma. Örneğin, bir derlemeyi farklı bir sürümle damgalamak istiyor olabilir.

IDE'de kod Visual Studio ancak derlemeleri çalıştırmak için MSBuild. Başka bir alternatif olarak, IDE'de bir geliştirme bilgisayarına kod oluşturabilirsiniz ancak birden çok MSBuild tümleştirilmiş kod derlemek için komut MSBuild çalıştırabilirsiniz. .NET Core projeleri derlemek için MSBuild kullanan .NET Core komut satırı arabirimini (CLI)de kullanabilirsiniz.

Bu makalede, genel bakış ve MSBuild. Giriş niteliğindeki bir öğretici için bkz. Adım adım kılavuz: MSBuild.

Komut MSBuild komut isteminde komut satırı kullanma

Komut isteminde MSBuild çalıştırmak için, uygun komut satırı seçenekleriyleMSBuild.exe'ye bir proje dosyası iletirsiniz. Komut satırı seçenekleri özellikleri ayarlamaya, belirli hedefleri yürütmeye ve derleme işlemini kontrol altına alan diğer seçenekleri ayarlamaya olanak sağlar. Örneğin, myProj.proj dosyasını özelliği olarak ayarlanmış şekilde oluşturmak için aşağıdaki komut satırı söz Configuration dizimlerini Debug kullanabilirsiniz.

MSBuild.exe MyProj.proj -property:Configuration=Debug

Komut satırı seçeneklerini MSBuild daha fazla bilgi için bkz. Komut satırı başvurusu.

Project dosyası

MSBuild, basit ve genişletilebilir XML tabanlı bir proje dosyası biçimi kullanır. Bu MSBuild dosyası biçimi, geliştiricilerin, farklı işletim sistemleri ve yapılandırmalar için nasıl geliştir edileceklerini ve nasıl oluşturacaklarını açıklamalarını sağlar. Buna ek olarak, proje dosyası biçimi geliştiricilerin derlemelerin üründe farklı projeler arasında tutarlı bir şekilde gerçekleştirilemeleri için ayrı dosyalarda dikkate alınarak yeniden kullanılabilir derleme kuralları yazmalarına olanak sağlar.

Derleme Visual Studio, projeye özgü mantığı proje dosyanıza depolar ve standart derleme mantığını tanımlamak için .props ve .targets gibi uzantılara sahip içe aktarılan MSBuild XML dosyalarını kullanır. .props dosyaları, MSBuild özelliklerini, .targets dosyaları ise MSBuild tanımlar. Bu içeri aktarmalar bazen Visual Studio proje dosyasında görünür, ancak .NET Core, .NET 5 ve .NET 6 projeleri gibi daha yeni projelerde proje dosyasında içeri aktarmaları görmüyorsanız; bunun yerine, bir SDK başvurusu görüyorsunuz. Bunlar SDK stili projeler olarak adlandırılır. .NET SDK gibi bir SDK'ya başvurarak .props ve .target dosyalarının içeri aktarmaları SDK tarafından örtülü olarak belirtilir.

Aşağıdaki bölümlerde, proje dosyası biçimindeki temel MSBuild açıklanmaktadır. Temel proje dosyası oluşturma hakkında bir öğretici için bkz. Kılavuz: Sıfırdan MSBuild proje dosyası oluşturma.

Özellikler

Özellikler, derlemeleri yapılandırmak için kullanılan anahtar/değer çiftlerini temsil ediyor. Özellikler, bir PropertyGroup öğesinin alt öğesi olarak özelliğin adına sahip bir öğe oluşturarak bildirildi. Örneğin, aşağıdaki kod değerine sahip BuildDir adlı bir özellik Build oluşturur.

<PropertyGroup>
    <BuildDir>Build</BuildDir>
</PropertyGroup>

öğesine öznitelik yerleştirerek koşullu olarak bir Condition özellik tanımlayabilirsiniz. Koşul olarak değerlendirilmediği sürece koşullu öğelerin içeriği true yoksayılır. Aşağıdaki örnekte, Configuration henüz tanımlanmamışsa öğesi tanımlanmıştır.

<Configuration  Condition=" '$(Configuration)' == '' ">Debug</Configuration>

Özelliklere proje dosyası boyunca $( söz dizimi kullanılarak <PropertyName> başvurulabilirsiniz. Örneğin, ve kullanarak önceki örneklerde yer alan özelliklere $(BuildDir) $(Configuration) başvurabilirsiniz.

Özellikler hakkında daha fazla bilgi için bkz. MSBuild.

Bileşen

Öğeler derleme sistemine giriştir ve genellikle dosyaları temsil eder. Öğeler, kullanıcı tanımlı öğe adlarına göre öğe türleri olarak gruplandı. Bu öğe türleri, derleme işleminin adımlarını gerçekleştirmek için tek tek öğeleri kullanan görevler için parametre olarak kullanılabilir.

Öğeler, öğe türünün adı bir ItemGroup öğesinin alt öğesi olarak olan bir öğe oluşturarak proje dosyasında bildirildi. Örneğin, aşağıdaki kod iki dosya içeren Compile adlı bir öğe türü oluşturur.

<ItemGroup>
    <Compile Include = "file1.cs"/>
    <Compile Include = "file2.cs"/>
</ItemGroup>

Öğe türlerine proje dosyası boyunca @( söz dizimi kullanılarak <ItemType> başvurulabilirsiniz. Örneğin, örnekteki öğe türüne kullanılarak @(Compile) başvurulabilirsiniz.

Bu MSBuild, öğe ve öznitelik adları büyük/büyük/büyük harfe duyarlıdır. Ancak özellik, öğe ve meta veri adları değildir. Aşağıdaki örnek , veya başka bir büyük/küçük harf varyasyonu öğe türünü oluşturur ve öğe türüne Compile comPile "one.cs;two.cs" değerini verir.

<ItemGroup>
  <Compile Include="one.cs" />
  <Compile Include="two.cs" />
</ItemGroup>

Öğeler joker karakterler kullanılarak bildirebilirsiniz ve daha gelişmiş derleme senaryoları için ek meta veriler içerebilir. Öğeler hakkında daha fazla bilgi için bkz. Öğeler.

Görev

Görevler, projelerin derleme işlemlerini gerçekleştirmek için MSBuild yürütülebilir kod birimleridir. Örneğin, bir görev giriş dosyalarını derler veya bir dış araç çalıştırabilirsiniz. Görevler yeniden kullanılabilir ve farklı projelerde farklı geliştiriciler tarafından paylaşılır.

Bir görevin yürütme mantığı yönetilen kodda yazılır ve UsingTask öğesi MSBuild ile eşlenmiş. Arabirimi uygulayan bir yönetilen tür yazarak kendi görevinizi ITask yazabilirsiniz. Görevleri yazma hakkında daha fazla bilgi için bkz. Görev yazma.

MSBuild gereksinimlerinize uyacak şekilde değiştirebilirsiniz ortak görevleri içerir. Örnek olarak,dosyaları kopyalayıp dizin oluşturan MakeDirve Visual C# kaynak kodu dosyalarını derleye Cscörnek olarak verilmiştir. Kullanılabilir görevlerin kullanım bilgileriyle birlikte listesi için bkz. Görev başvurusu.

Bir görev, bir MSBuild hedef öğenin alt öğesi olarak görev adına sahip bir öğe oluşturarak bir proje dosyasında yürütülür. Görevler genellikle öğesinin öznitelikleri olarak geçirilen parametreleri kabul eder. Hem MSBuild özellikleri hem de öğeleri parametre olarak kullanılabilir. Örneğin, aşağıdaki kod MakeDir görevini çağırarak önceki örnekte bildirilen BuildDir özelliğin değerini iletir.

<Target Name="MakeBuildDirectory">
    <MakeDir  Directories="$(BuildDir)" />
</Target>

Görevler hakkında daha fazla bilgi için bkz. Görevler.

Hedef

Grup görevlerini belirli bir sırada birlikte hedefler ve proje dosyasının bölümlerini derleme sürecine giriş noktaları olarak sunar. Hedefler genellikle okunabilirliği artırmak ve genişlemeye olanak sağlamak için mantıksal bölümler halinde gruplanmıştır. Derleme adımlarını hedeflere bozmak, kodun bu bölümünü her hedefe kopyalamadan derleme işleminin bir parçasını diğer hedeflerden çağırmaya olanak sağlar. Örneğin, derleme işleminin birkaç giriş noktasının oluşturulacak başvurular gerektirmesi, başvuruların oluşturulacak bir hedef oluşturması ve ardından bu hedefi gerekli olduğu her giriş noktasından çalıştırması gerekir.

Hedefler, Target öğesi kullanılarak proje dosyasında bildirildi. Örneğin, aşağıdaki kod adlı bir hedef oluşturur ve daha sonra önceki örnekte bildirilen öğe listesine sahip Compile Csc görevini çağıran.

<Target Name="Compile">
    <Csc Sources="@(Compile)" />
</Target>

Daha gelişmiş senaryolarda hedefler, aralarındaki ilişkileri tanımlamak ve bağımlılık analizi gerçekleştirmek için kullanılabilir. Böylece, hedef güncelse derleme işleminin tüm bölümleri atlanabilir. Hedefler hakkında daha fazla bilgi için bkz. Hedefler.

Derleme günlükleri

Derleme hatalarını, uyarıları ve iletileri konsola veya başka bir çıkış cihazına günlüğe alabilirsiniz. Daha fazla bilgi için bkz. Derleme günlüklerini alma veMSBuild.

MSBuild'de Visual Studio

Visual Studio, yönetilen MSBuild derleme bilgilerini depolamak için MSBuild proje dosyası biçimini kullanır. Project arabirimi kullanılarak eklenen veya değiştirilen Visual Studio ayarları içinde yansıtıldı. * her proje için oluşturulan proj dosyası. Visual Studio yönetilen projeler derlemek için MSBuild barındırılan bir örnek kullanır. Bu, yönetilen bir projenin Visual Studio komut isteminde (Visual Studio yüklü olsa bile) ve sonuçların aynı olacağını ifade ediyor.

Visual Studio'de MSBuild kullanma hakkında bir öğretici için bkz. MSBuild.

Çoklu hedef

Bir Visual Studio kullanarak, bir uygulamayı derlemek için uygulamanın çeşitli sürümlerinden herhangi biri üzerinde .NET Framework. Örneğin, bir uygulamayı 32 bitlik bir platformda .NET Framework 2.0'da çalıştıracak şekilde derleyebilirsiniz ve aynı uygulamayı 64 bitlik bir platformda .NET Framework 4.5 üzerinde çalıştıracak şekilde derleyebilirsiniz. Birden fazla çerçeveye derleme özelliği multitargeting olarak adlandırılmıştır.

Çoklu hedeflere sahip olmak için aşağıdaki avantajlardan faydalanır:

• 3.5 ve 4.7.2 gibi .NET Framework önceki sürümlerini hedef alan uygulamalar geliştirebilirsiniz.

• Hedef çerçevenin önceden tanımlanmış bir alt kümesi olan bir çerçeve profilini hedefleyebilirsiniz.

• Geçerli sürümü için bir hizmet paketi .NET Framework, hedefleyabilirsiniz.

• Çoklu hedefleme, bir uygulamanın yalnızca hedef çerçevede ve platformda kullanılabilen işlevleri kullanmalarını garantiler.

Daha fazla bilgi için bkz. Çoklu Hedef.

Ayrıca bkz.

Başvuru

• MSBuild başvurusu
  Başvuru bilgilerini içeren konulara bağlantılar.

• Sözlük
  Yaygın kullanılan MSBuild tanımlar.