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.