Słownik programu MSBuild

Te terminy służą do opisywania aparatu Microsoft Build Engine (MSBuild) i jego składników.

AssemblyFoldersEx

Lokalizacja rejestru, w której dostawcy innej firmy przechowują ścieżki dla każdej wersji platformy, w której obsługują rozpoznawanie czasu projektowania, może szukać zestawów referencyjnych.

przetwarzanie wsadowe

Przetwarzanie wsadowe oznacza dzielenie elementów na różne kategorie znane jako partie na podstawie metadanych elementu, a następnie jednorazowe uruchamianie elementu docelowego lub zadania przy użyciu każdej partii. Przetwarzanie wsadowe to odpowiednik struktury MSBuild dla-pętli. Aby uzyskać więcej informacji, zobacz Batching (Przetwarzanie wsadowe).

zakres kompilacji

Zakres kompilacji opisuje obiekt MSBuild, na przykład właściwość globalną, która jest potencjalnie widoczna dla projektu i dla wszystkich projektów podrzędnych utworzonych w kompilacji wieloprojektowej.

projekt podrzędny

Zobacz projekt, element podrzędny.

condition

Wiele elementów programu MSBuild można zdefiniować warunkowo; oznacza to, że Condition atrybut pojawia się w elemecie . Zawartość elementów warunkowych jest ignorowana, chyba że warunek zwróci wartość true. Aby uzyskać więcej informacji, zobacz Warunki.

definicja, element

Zobacz definicję elementu.

emituj element

W fazie wykonywania kompilacji elementy mogą być tworzone lub modyfikowane przez zadania, które mają elementy podrzędne Output , które mają ItemName atrybut . Mówi się, że zadanie "emituje" nowe elementy.

emituj właściwość

W fazie wykonywania kompilacji właściwości mogą być tworzone lub modyfikowane przez zadania, które mają elementy podrzędne Output , które mają PropertyName atrybut . Mówi się, że zadanie "emituje" nową właściwość.

faza oceny

Ocena to pierwsza faza kompilacji projektu. Wszystkie właściwości i elementy są oceniane w kolejności, w jakiej są wyświetlane w projekcie. Zaimportowane projekty są oceniane w miarę ich napotkania w projekcie. Cele i zadania nie są uruchamiane do momentu fazy wykonywania, a wszystkie właściwości lub elementy, które będą zadeklarować lub emitować, są ignorowane podczas oceny.

faza wykonywania

Wykonanie jest drugą fazą kompilacji projektu. Wybrane obiekty docelowe są kompilowane, a zadania są uruchamiane. Właściwości i elementy można tworzyć lub modyfikować w porównaniu z ich wartościami oceny.

function, właściwość

Zobacz funkcję właściwości.

funkcja, element

Zobacz funkcję item.

element

Elementy są danymi wejściowymi w systemie kompilacji i są pogrupowane w typy elementów na podstawie ich nazw elementów. Elementy zazwyczaj reprezentują pliki. Ponieważ elementy są nazwane przez typ elementu, do którego należą, terminy i wartość elementu mogą być używane zamiennie. Aby uzyskać więcej informacji, zobacz Elementy.

definicja elementu

Grupy definicji elementów zawierają definicje elementów, które dodają domyślne metadane do dowolnego typu elementu. Podobnie jak dobrze znane metadane, domyślne metadane są skojarzone ze wszystkimi elementami określonego typu elementu. Domyślne metadane można jawnie zastąpić w definicji elementu. Aby uzyskać więcej informacji, zobacz Definicje elementów.

funkcja item

Funkcje elementów uzyskują informacje o elementach w projekcie. Te funkcje upraszczają pobieranie elementów Distinct() i są szybsze niż pętle przez elementy. Istnieją funkcje do manipulowania ścieżkami elementów i ciągami. Aby uzyskać więcej informacji, zobacz Funkcje elementu.

metadane elementu

Zobacz metadane, element.

typ elementu

Typy elementów są nazwanymi listami elementów, których można użyć jako parametrów dla zadań podrzędnych. Zadania używają wartości elementów do wykonania kroków procesu kompilacji. Aby uzyskać więcej informacji, zobacz Elementy.

metadane, element

Metadane elementu to kolekcja par nazwa-wartość, które są skojarzone z elementem. Metadane zawierają opisowe informacje o elemencie i są opcjonalne, z wyjątkiem dobrze znanych metadanych. Aby uzyskać więcej informacji, zobacz Elementy.

metadane, dobrze znane

Dobrze znane metadane to metadane elementu tylko do odczytu, które są inicjowane przy użyciu wstępnie zdefiniowanej wartości. Dobrze znane metadane zawierają opisowe informacje dotyczące elementu, który odwołuje się do pliku. Na przykład wartość dobrze znanych metadanych o nazwie FullPath jest pełną ścieżką do pliku, do którego odwołuje się odwołanie. Aby uzyskać więcej informacji, zobacz Elementy.

przeznaczanie dla wielu platform

Możliwość kierowania wielu różnych struktur środowiska CLR z programu MSBuild i programu Visual Studio do projektu aplikacji lub zestawu.

profil

Podzbiór pełnej struktury. Służy to do zminimalizowania ilości, którą należy pobrać na maszynę.

plik projektu

Plik projektu zawiera skrypt MSBuild, który kontroluje kompilację. Pliki projektu zwykle mają rozszerzenie pliku, które kończy się plikiem proj, takim jak .csproj lub vbproj. Pliki projektu mogą importować pliki właściwości i pliki docelowe.

właściwość

Właściwość jest parą klucz-wartość, która służy do kontrolowania procesu kompilacji. Aby uzyskać więcej informacji, zobacz Właściwości programu MSBuild.

właściwość, środowisko

Właściwość środowiska jest właściwością, która jest automatycznie inicjowana do wartości zmiennej środowiskowej systemu, która ma taką samą nazwę. Aby uzyskać więcej informacji, zobacz Właściwości programu MSBuild.

plik właściwości

Plik właściwości to plik projektu zawierający głównie grupy właściwości i grupy elementów, które prowadzą kompilację. Zgodnie z konwencją ma rozszerzenie pliku .props. Pliki właściwości są zwykle importowane na początku skojarzonych plików projektu.

właściwość, funkcja

Funkcja właściwości jest właściwością systemową lub metodą, która może służyć do oceny skryptów MSBuild. Metody właściwości mogą służyć do odczytywania czasu systemowego, porównywania ciągów, dopasowywania wyrażeń regularnych i wykonywania innych akcji. Aby uzyskać więcej informacji, zobacz Funkcje właściwości.

funkcja właściwości, zagnieżdżona

Funkcje właściwości mogą być łączone w celu utworzenia bardziej złożonych funkcji. Na przykład

$([MSBuild]::BitwiseAnd(32, $([System.IO.File]::GetAttributes(tempFile))))

Aby uzyskać więcej informacji, zobacz Funkcje właściwości.

właściwość, globalna

Właściwość globalna to para klucz-wartość używana do kontrolowania procesu kompilacji. Właściwości globalne są ustawiane w wierszu polecenia lub przy użyciu Properties atrybutu zadania MSBuild i nie można ich modyfikować w fazie oceny kompilacji. Aby uzyskać więcej informacji, zobacz Właściwości programu MSBuild.

właściwość, lokalna

Właściwość lokalna to para klucz-wartość używana do kontrolowania procesu kompilacji. Ten termin jest używany tylko do rozróżniania właściwości, która nie jest właściwością globalną.

właściwość, rejestr

Właściwość rejestru ma wartość ustawioną przy użyciu specjalnej składni, która odczytuje wartość podklucza rejestru systemowego. Aby uzyskać więcej informacji, zobacz Właściwości programu MSBuild.

właściwość, zarezerwowana

Właściwość zarezerwowana to para klucz-wartość używana do kontrolowania procesu kompilacji. Właściwości zarezerwowane są automatycznie inicjowane do wstępnie zdefiniowanych wartości. Aby uzyskać więcej informacji, zobacz Właściwości programu MSBuild.

zakres projektu

Zakres projektu opisuje obiekt MSBuild, na przykład właściwość lokalną, która jest widoczna tylko w pliku zawierającym projekt i do wszystkich importowanych projektów.

projekt, element podrzędny

Projekt podrzędny jest tworzony przez zadanie MSBuild podczas kompilacji projektu. Ten nowy projekt jest elementem podrzędnym projektu, który zawiera lub importuje obiekt docelowy zawierający zadanie MSBuild. Projekt podrzędny dziedziczy globalne właściwości projektu nadrzędnego, chyba że zostaną zmodyfikowane przez Properties atrybut .

lista redist

Lista redystrybucji: lista zestawów, które odpowiadają danej strukturze.

zestaw referencyjny

Zestaw używany w czasie projektowania do tworzenia aplikacji. Zestaw referencyjny może mieć usunięty rzeczywisty kod i interfejsy prywatne, pozostawiając tylko metadane i interfejsy publiczne.

właściwość rejestru

Zobacz właściwość, rejestr.

target

Element docelowy grupuje zadania w określonej kolejności i uwidacznia sekcje pliku projektu jako punkty wejścia w procesie kompilacji. Aby uzyskać więcej informacji, zobacz Cele.

element docelowy, budynek

Zobacz element docelowy, uruchomiony.

element docelowy, ocenianie

Ze względu na kompilację przyrostowa elementy docelowe muszą być analizowane pod kątem potencjalnych zmian we właściwościach i elementach. Nawet jeśli element docelowy zostanie pominięty, należy wprowadzić te zmiany. Ocena celu oznacza przeprowadzenie tej analizy i wprowadzenie tych zmian. Aby uzyskać więcej informacji, zobacz Incremental builds (Kompilacje przyrostowe).

element docelowy, wykonywanie

Wykonanie elementu docelowego oznacza ocenę i wykonywanie wszystkich zadań, które nie mają warunków lub których warunki mają wartość true. Podczas kompilacji przyrostowej obiekty docelowe mogą być pomijane lub wykonywane, ale są one zawsze oceniane. Aby uzyskać więcej informacji, zobacz target, ocena.

element docelowy, uruchomiony

Element docelowy, który ma warunek, który daje w wyniku wartość false, nie jest uruchamiany, czyli nie ma wpływu na kompilację. Obiekty docelowe, które są uruchamiane, są wykonywane lub pomijane. W obu przypadkach element docelowy jest oceniany. Aby uzyskać więcej informacji, zobacz target, ocena.

element docelowy, pomijanie

Jeśli kompilacja przyrostowa ustali, że wszystkie pliki wyjściowe są aktualne, element docelowy zostanie pominięty, czyli zostanie obliczony element docelowy, ale zadania w obiekcie docelowym nie są wykonywane. Aby uzyskać więcej informacji, zobacz target, ocena.

moniker platformy docelowej

Nazwa opisująca strukturę (na przykład . NETFramework, Silverlight itp.), wersja i profil (np. klient, serwer itp.), który chcesz kierować.

pakiet docelowy

Lista zestawów, które są dystrybuowane z daną strukturą i zestawem zestawów referencyjnych dla tej struktury.

plik targets

Plik docelowy to plik projektu zawierający głównie obiekty docelowe i zadania, które prowadzą kompilację. Zgodnie z konwencją ma rozszerzenie pliku .targets. Pliki docelowe są zwykle importowane na końcu skojarzonych plików projektu.

task

Zadania to jednostki kodu wykonywalnego używanego przez projekty MSBuild do wykonywania operacji kompilacji. Na przykład zadanie może skompilować pliki wejściowe lub uruchomić narzędzie zewnętrzne. Aby uzyskać więcej informacji, zobacz Zadania.

transform

Przekształcenie jest konwersją jeden do jednego kolekcji elementów na inną. Oprócz umożliwienia projektu konwersji kolekcji elementów przekształcenie umożliwia elementowi docelowemu identyfikowanie bezpośredniego mapowania między danymi wejściowymi i wyjściowymi. Aby uzyskać więcej informacji, zobacz Przekształcenia.

dobrze znane metadane

Zobacz metadane, dobrze znane.

Zobacz też

• MSBuild