MSBuild görevi

Başka bir MSBuild projesinden MSBuild projeleri oluşturur.

Parametreler

Aşağıdaki tabloda görevin parametreleri MSBuild açıklanmaktadır.

Açıklamalar

Yukarıda listelenen parametrelere ek olarak, bu görev kendi sınıfından TaskExtension devralan sınıfından Task parametreleri devralır. Bu ek parametrelerin ve açıklamalarının listesi için bkz . TaskExtension temel sınıfı.

MSBuild.exe dosyasını başlatmak için Exec görevinin kullanılmasından farklı olarak, bu görev alt projeleri oluşturmak için aynı MSBuild işlemini kullanır. Atlanabilecek önceden oluşturulmuş hedeflerin listesi üst ve alt derlemeler arasında paylaşılır. Yeni BIR MSBuild işlemi oluşturulmadığından bu görev de daha hızlıdır.

Bu görev yalnızca proje dosyalarını değil çözüm dosyalarını da işleyebilir.

Yapılandırma uzak altyapı (örneğin, bağlantı noktaları, protokoller, zaman aşımları, yeniden denemeler vb.) içerse bile, MSBuild tarafından projelerin aynı anda derlenebilmesi için gereken tüm yapılandırmalar, yapılandırma dosyası kullanılarak yapılandırılabilir hale getirilmelidir. Mümkün olduğunda, yapılandırma öğelerinin görevde görev parametreleri MSBuild olarak belirtilmesi gerekir.

MSBuild 3.5 sürümünden başlayarak, Çözüm projeleri artık derlediğinden tüm alt projelerden TargetOutputs'ı ortaya çıkarır.

Özellikleri projelere geçirme

MSBuild'in MSBuild 3.5 öncesi sürümlerinde, MSBuild öğesinde listelenen farklı projelere farklı özellik kümeleri geçirmek zor oldu. MSBuild görevinin Properties özniteliğini kullandıysanız, MSBuild görevini toplu işlemediğiniz ve öğe listesindeki her proje için koşullu olarak farklı özellikler sağlamadığınız sürece, bu görevin ayarı oluşturulan tüm projelere uygulanır.

Ancak MSBuild 3.5, MSBuild görevi kullanılarak oluşturulan farklı projeler için farklı özellikleri geçirmeniz için esnek bir yol sağlayan özellikler ve EkÖzellikler adlı iki yeni ayrılmış meta veri öğesi sağlar.

Çok işlemcili derleme avantajları

Bu yeni meta verileri kullanmanın başlıca avantajlarından biri, projelerinizi çok işlemcili bir sistemde paralel olarak oluşturduğunuzda ortaya çıkar. Meta veriler, herhangi bir toplu işlem veya koşullu MSBuild görevi gerçekleştirmek zorunda kalmadan tüm projeleri tek bir MSBuild görev çağrısında birleştirmenizi sağlar. Yalnızca tek bir MSBuild görevini çağırdığınızda, Projeler özniteliğinde listelenen tüm projeler paralel olarak derlenir. (Ancak, özniteliği MSBuild görevinde varsa BuildInParallel=true .) Daha fazla bilgi için bkz. Paralel olarak birden çok proje oluşturma.

Özellikler meta verileri

Belirtildiğinde, Özellikler meta verileri görevin Özellikler parametresini geçersiz kılarken , AdditionalProperties meta verileri parametrenin tanımlarına eklenir.

Yaygın bir senaryo, MSBuild görevini kullanarak, yalnızca farklı derleme yapılandırmalarını kullanarak birden çok çözüm dosyası derlemenizdir. Hata ayıklama yapılandırmasını kullanarak a1 çözümünü ve Yayın yapılandırmasını kullanarak a2 çözümünü oluşturmak isteyebilirsiniz. MSBuild 2.0'da bu proje dosyası aşağıdaki gibi görünür:

a.proj

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="Build">
        <MSBuild Projects="a1.sln..." Properties="Configuration=Debug"/>
        <MSBuild Projects="a2.sln" Properties="Configuration=Release"/>
    </Target>
</Project>

Bununla birlikte, Özellikler meta verilerini kullanarak, aşağıda gösterildiği gibi tek bir MSBuild görevi kullanmak için bunu basitleştirebilirsiniz:

a.proj

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <ProjectToBuild Include="a1.sln...">
            <Properties>Configuration=Debug</Properties>
        </ProjectToBuild>
        <ProjectToBuild Include="a2.sln">
            <Properties>Configuration=Release</Properties>
        </ProjectToBuild>
    </ItemGroup>
    <Target Name="Build">
        <MSBuild Projects="@(ProjectToBuild)"/>
    </Target>
</Project>

- veya -

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <ProjectToBuild Include="a1.sln..."/>
        <ProjectToBuild Include="a2.sln">
            <Properties>Configuration=Release</Properties>
        </ProjectToBuild>
    </ItemGroup>
    <Target Name="Build">
        <MSBuild Projects="@(ProjectToBuild)"
          Properties="Configuration=Debug"/>
    </Target>
</Project>

AdditionalProperties meta verileri

MsBuild görevini kullanarak iki çözüm dosyası derlediğiniz aşağıdaki senaryoyu göz önünde bulundurun: Hem Sürüm yapılandırmasını hem de biri x86 mimarisini, diğeri ia64 mimarisini kullanarak. MSBuild 2.0'da, MSBuild görevinin birden çok örneğini oluşturmanız gerekir: biri x86 Mimarisi ile Yayın yapılandırmasını kullanarak projeyi, diğeri ia64 mimarisiyle Yayın yapılandırmasını kullanarak projeyi derlemek için. Proje dosyanız aşağıdaki gibi görünür:

a.proj

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Target Name="Build">
        <MSBuild Projects="a1.sln..." Properties="Configuration=Release;
          Architecture=x86"/>
        <MSBuild Projects="a2.sln" Properties="Configuration=Release;
          Architecture=ia64"/>
    </Target>
</Project>

AdditionalProperties meta verilerini kullanarak, aşağıdakileri kullanarak tek bir MSBuild görevi kullanmak için bunu basitleştirebilirsiniz:

a.proj

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <ItemGroup>
        <ProjectToBuild Include="a1.sln...">
            <AdditionalProperties>Architecture=x86
              </AdditionalProperties>
        </ProjectToBuild>
        <ProjectToBuild Include="a2.sln">
            <AdditionalProperties>Architecture=ia64
              </AdditionalProperties>
        </ProjectToBuild>
    </ItemGroup>
    <Target Name="Build">
        <MSBuild Projects="@(ProjectToBuild)"
          Properties="Configuration=Release"/>
    </Target>
</Project>

Örnek

Aşağıdaki örnek, öğe koleksiyonu tarafından ProjectReferences belirtilen projeleri oluşturmak için görevini kullanırMSBuild. Sonuçta elde edilen hedef çıkışlar öğe koleksiyonunda AssembliesBuiltByChildProjects depolanır.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <ItemGroup>
        <ProjectReferences Include="*.*proj" />
    </ItemGroup>

    <Target Name="BuildOtherProjects">
        <MSBuild
            Projects="@(ProjectReferences)"
            Targets="Build">
            <Output
                TaskParameter="TargetOutputs"
                ItemName="AssembliesBuiltByChildProjects" />
        </MSBuild>
    </Target>

</Project>

Ayrıca bkz.

• Görevler
• Görev başvurusu