LC — Zadanie
Opakowuje plik LC.exe, który generuje plik licencji na podstawie pliku licx. Aby uzyskać więcej informacji na temat pliku LC.exe, zobacz Lc.exe (Kompilator licencji).
Parametry
W poniższej tabeli opisano parametry zadania LC
.
Parametr | Opis |
---|---|
LicenseTarget |
Wymagany parametr interfejsu ITaskItem. Określa plik wykonywalny, dla którego są generowane pliki licencji . |
NoLogo |
Opcjonalny Boolean parametr.Pomija wyświetlanie transparentu startowego firmy Microsoft. |
OutputDirectory |
Opcjonalny String parametr.Określa katalog, w którym mają być umieszczane wyjściowe pliki licencji . |
OutputLicense |
Opcjonalny ITaskItem parametr wyjściowy. Określa nazwę pliku licencji . Jeśli nie określisz nazwy, zostanie użyta nazwa pliku licx , a plik licencji zostanie umieszczony w katalogu zawierającym plik licx . |
ReferencedAssemblies |
Opcjonalny ITaskItem[] parametr.Określa składniki, do których należy się odwołać podczas generowania pliku licencji . |
SdkToolsPath |
Opcjonalny String parametr.Określa ścieżkę do narzędzi zestawu SDK, takich jak resgen.exe. |
Sources |
Wymagany parametr interfejsu ITaskItem[] .Określa elementy zawierające składniki licencjonowane do uwzględnienia w pliku licencji . Aby uzyskać więcej informacji, zobacz dokumentację przełącznika /complist w pliku Lc.exe (kompilator licencji). |
Parametry toolTaskExtension
To zadanie dziedziczy z ToolTaskExtension klasy dziedziczonej ToolTask po klasie, która dziedziczy się po Task klasie. Ten łańcuch dziedziczenia dodaje kilka parametrów do zadań, które pochodzą z nich.
W poniższej tabeli opisano parametry klas bazowych:
Parametr | Opis |
---|---|
EchoOff | Opcjonalny bool parametr.Gdy jest ustawiona wartość true , to zadanie przekazuje /Q do wiersza polecenia cmd.exe , tak aby wiersz polecenia nie został skopiowany do pliku stdout. |
EnvironmentVariables | Opcjonalny String parametr tablicy.Tablica definicji zmiennych środowiskowych oddzielona średnikami. Każda definicja powinna określać nazwę zmiennej środowiskowej i wartość oddzieloną znakiem równości. Te zmienne są przekazywane do zduplikowanego pliku wykonywalnego oprócz zwykłego bloku środowiska lub selektywnego zastępowania. Na przykład Variable1=Value1;Variable2=Value2 . |
ExitCode | Opcjonalny Int32 parametr tylko do odczytu.Określa kod zakończenia udostępniany przez wykonane polecenie. Jeśli zadanie zarejestrowało błędy, ale proces miał kod zakończenia 0 (powodzenie), jest to ustawione na -1. |
LogStandardErrorAsError | Opcjonalny bool parametr.Jeśli true program , wszystkie komunikaty odebrane w standardowym strumieniu błędów są rejestrowane jako błędy. |
StandardErrorImportance | Opcjonalny String parametr.Ważność rejestrowania tekstu ze standardowego strumienia błędów. |
StandardOutputImportance | Opcjonalny String parametr.Ważność, za pomocą której ma być rejestrowany tekst ze standardowego strumienia wychodzącego. |
Timeout | Opcjonalny Int32 parametr.Określa czas w milisekundach, po którym plik wykonywalny zadania zostanie zakończony. Wartość domyślna to Int.MaxValue , co oznacza, że nie ma limitu czasu. Limit czasu wynosi w milisekundach. |
ToolExe | Opcjonalny string parametr.Projekty mogą implementować tę funkcję, aby zastąpić element ToolName. Zadania mogą zastąpić tę wartość, aby zachować wartość ToolName. |
ToolPath | Opcjonalny string parametr.Określa lokalizację, z której zadanie ładuje źródłowy plik wykonywalny. Jeśli ten parametr nie zostanie określony, zadanie używa ścieżki instalacyjnej zestawu SDK odpowiadającej wersji platformy z uruchomionym programem MSBuild. |
UseCommandProcessor | Opcjonalny bool parametr.Po ustawieniu true wartości to zadanie tworzy plik wsadowy dla wiersza polecenia i wykonuje go przy użyciu procesora poleceń zamiast bezpośredniego wykonywania polecenia. |
YieldDuringToolExecution | Opcjonalny bool parametr.Gdy jest ustawiona wartość true , to zadanie daje węzeł, gdy jego zadanie jest wykonywane. |
Przykład
W poniższym przykładzie użyto LC
zadania do kompilowania licencji.
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<!-- Item declarations, etc -->
<Target Name="CompileLicenses">
<LC
Sources="@(LicxFile)"
LicenseTarget="$(TargetFileName)"
OutputDirectory="$(IntermediateOutputPath)"
OutputLicenses="$(IntermediateOutputPath)$(TargetFileName).licenses"
ReferencedAssemblies="@(ReferencePath);@(ReferenceDependencyPaths)">
<Output
TaskParameter="OutputLicenses"
ItemName="CompiledLicenseFile"/>
</LC>
</Target>
</Project>