Udostępnij za pośrednictwem


Cele programu MSBuild

Cele grupowania zadań w określonej kolejności i proces kompilacji i być rozkładane na mniejsze jednostki.Na przykład jeden obiekt docelowy może usunąć wszystkie pliki w katalogu wyjściowego do przygotowania do budowy, podczas gdy inny kompiluje wejścia dla projektu i umieszcza je w pustego katalogu.Aby uzyskać więcej informacji na temat zadań, zobacz Program MSBuild zadań.

Deklarując obiekty docelowe w pliku projektu

Obiekty docelowe są zadeklarowane w pliku projektu z Cel element.Na przykład następujący kod XML tworzy element docelowy o nazwie konstrukcja, która następnie wywołuje zadanie Csc typ kompilacji zapasu.

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

Jak program MSBuild właściwości można ponownie zdefiniować cele.Na przykład:

<Target Name="AfterBuild" >
    <Message Text="First occurrence" />
</Target>
<Target Name="AfterBuild" >
    <Message Text="Second occurrence" />
</Target>

Jeśli AfterBuild jest wykonywana, wyświetla tylko "drugie wystąpienie".

Miejsce docelowe-zamówienie

Obiekty docelowe są zamawiane, jeśli dane wejściowe do jednego celu zależy od danych wyjściowych innego obiektu docelowego.Istnieje kilka sposobów, aby określić kolejność w których cele uruchomić.

  • Cele początkowe

  • Domyślne elementy docelowe

  • Pierwszy element docelowy

  • Miejsce docelowe zależności

  • BeforeTargetsi AfterTargets (MSBuild 4.0)

Element docelowy nigdy nie działa dwa razy podczas kompilacji pojedynczej, nawet jeśli zależy kolejnych docelowej w kompilacji.Gdy uruchomiony jest obiektem docelowym, jego wkład do kompilacji zostało ukończone.

Szczegóły i więcej informacji na temat cel budowania zamówienia, zobacz Zamówienie docelowej.

Miejsce docelowe dozowania

Element docelowy może mieć Outputs atrybut, który określa metadane w postaci % (metadane).Jeśli tak, program MSBuild działa docelowy raz dla każdej wartości unikatowe metadane, grupowanie lub "Grupowanie" elementy, które mają wartość metadanych.Na przykład:

<ItemGroup>
    <Reference Include="System.Core">
      <RequiredTargetFramework>3.5</RequiredTargetFramework>
    </Reference>
    <Reference Include="System.Xml.Linq">
      <RequiredTargetFramework>3.5</RequiredTargetFramework>
    </Reference>
    <Reference Include="Microsoft.CSharp">
      <RequiredTargetFramework>4.0</RequiredTargetFramework>
    </Reference>
</ItemGroup>
<Target Name="AfterBuild"
    Outputs="%(Reference.RequiredTargetFramework)">
    <Message Text="Reference:
      @(Reference->'%(RequiredTargetFramework)')" />
</Target>

partie towarów odniesienia przez ich metadane RequiredTargetFramework.Dane wyjściowe obiektu docelowego wygląda następująco:

Reference: 3.5;3.5
Reference: 4.0

Cel dozowania rzadko jest używany w prawdziwym buduje.Grupowanie zadań jest częściej.Aby uzyskać więcej informacji, zobacz Program MSBuild tworzenie pakietów wsadowych..

Przyrostowe kompilacje

Przyrostowe kompilacje są wersje, które są zoptymalizowane tak, że cele z plików wyjściowych, które są aktualne w odniesieniu do ich odpowiednich plików wejściowych nie są wykonywane.Element docelowy może mieć zarówno Inputs i Outputs atrybuty, wskazującą, jakie elementy cel wejściową i jakie elementy to produkuje jako dane wyjściowe.

Jeśli wszystkie elementy dane wyjściowe są aktualne, MSBuild pomija cel, co znacznie zwiększa szybkość kompilacji.Jest to nazywane przyrostowe kompilacji, miejsce docelowe.Jeśli tylko niektóre pliki są aktualne, MSBuild wykonuje docelowej bez aktualnych elementów.Jest to częściowe budować przyrostowe obiektu docelowego.Aby uzyskać więcej informacji, zobacz Buduje przyrostowe.

Zobacz też

Zadania

Jak: Użyj tej samej lokalizacji docelowej w wielu plikach programu Project

Inne zasoby

Pojęcia dotyczące programu MSBuild