AL (linker sestavení) – úloha
Úloha AL zabalí AL.exe, nástroj, který je distribuován se sadou Windows Software Development Kit (SDK). Tento nástroj Assembly Linker slouží k vytvoření sestavení s manifestem z jednoho nebo více souborů, které jsou moduly nebo soubory prostředků. Kompilátory a vývojová prostředí už můžou tyto funkce poskytovat, takže často není nutné tuto úlohu používat přímo. Linker sestavení je nejužitečnější pro vývojáře, kteří potřebují vytvořit jedno sestavení z více souborů komponent, jako jsou například ty, které mohou být vytvořeny z vývoje ve smíšeném jazyce. Tato úloha nekombinuje moduly do jednoho souboru sestavení; aby výsledné sestavení správně načetla, musí být jednotlivé moduly stále distribuované a dostupné. Další informace o AL.exe, viz Al.exe (Assembly Linker).
Parametry
Následující tabulka popisuje parametry AL úlohy.
| Parametr | Popis |
|---|---|
AlgorithmID |
Volitelný String parametr.Určuje algoritmus, který vytvoří hodnotu hash pro všechny soubory ve vícesouborovém sestavení s výjimkou souboru, který obsahuje manifest sestavení. Další informace naleznete v dokumentaci k /algid možnosti v Al.exe (Assembly Linker). |
BaseAddress |
Volitelný String parametr.Určuje adresu, na kterou budou v počítači uživatele za běhu načteny knihovny DLL. Aplikace se načítají rychleji, pokud zadáte základní adresu knihoven DLL a nepustíte operační systém přemístit knihovny DLL v procesním prostoru. Tento parametr odpovídá /baseaddress. |
CompanyName |
Volitelný String parametr.Určuje řetězec pro Company pole v sestavení. Další informace naleznete v dokumentaci k /comp[any] možnosti v Al.exe (Assembly Linker). |
Configuration |
Volitelný String parametr.Určuje řetězec pro Configuration pole v sestavení. Další informace naleznete v dokumentaci k /config[uration] možnosti v Al.exe (Assembly Linker). |
Copyright |
Volitelný String parametr.Určuje řetězec pro Copyright pole v sestavení. Další informace naleznete v dokumentaci k /copy[right] možnosti v Al.exe (Assembly Linker). |
Culture |
Volitelný String parametr.Určuje řetězec jazykové verze přidružený k sestavení. Další informace naleznete v dokumentaci k /c[ulture] možnosti v Al.exe (Assembly Linker). |
DelaySign |
Volitelný Boolean parametr.true umístit pouze veřejný klíč do sestavení; false k úplnému podepsání sestavení. Další informace naleznete v dokumentaci k /delay[sign] možnosti v Al.exe (Assembly Linker). |
Description |
Volitelný String parametr.Určuje řetězec pro Description pole v sestavení. Další informace naleznete v dokumentaci k /descr[iption] možnosti v Al.exe (Assembly Linker). |
EmbedResources |
Volitelný ITaskItem[] parametr.Vloží zadané prostředky do image, která obsahuje manifest sestavení. Tato úloha zkopíruje obsah souboru prostředků do image. Položky předané tomuto parametru mohou mít volitelná metadata připojena k nim volané LogicalName a Access. Metadata LogicalName slouží k určení interního identifikátoru prostředku. Metadata Access lze nastavit tak private , aby prostředek nebyl viditelný pro jiná sestavení. Další informace naleznete v dokumentaci k /embed[resource] možnosti v Al.exe (Assembly Linker). |
EvidenceFile |
Volitelný String parametr.Vloží zadaný soubor do sestavení s názvem Security.Evidenceprostředku .Nemůžete použít Security.Evidence pro běžné prostředky. Tento parametr odpovídá /e[vidence] možnosti v Al.exe (Assembly Linker). |
ExitCode |
Volitelný Int32 výstupní parametr jen pro čtení.Určuje ukončovací kód poskytnutý spuštěným příkazem. |
FileVersion |
Volitelný String parametr.Určuje řetězec pro File Version pole v sestavení. Další informace naleznete v dokumentaci k /fileversion možnosti v Al.exe (Assembly Linker). |
Flags |
Volitelný String parametr.Určuje hodnotu pole Flags v sestavení. Další informace naleznete v dokumentaci k /flags možnosti v Al.exe (Assembly Linker). |
GenerateFullPaths |
Volitelný Boolean parametr.Způsobí, že úloha použije absolutní cestu pro všechny soubory, které jsou hlášeny v chybové zprávě. Tento parametr odpovídá /fullpaths možnosti v Al.exe (Assembly Linker). |
KeyContainer |
Volitelný String parametr.Určuje kontejner obsahující pár klíčů. Toto podepíše sestavení (dá sestavení silný název) tak, že vloží veřejný klíč do manifestu sestavení. Úkol pak podepíše konečné sestavení privátním klíčem. Další informace naleznete v dokumentaci k /keyn[ame] možnosti v Al.exe (Assembly Linker). |
KeyFile |
Volitelný String parametr.Určuje soubor, který obsahuje pár klíčů nebo jen veřejný klíč pro podepsání sestavení. Kompilátor vloží veřejný klíč do manifestu sestavení a poté podepíše konečné sestavení soukromým klíčem. Další informace naleznete v dokumentaci k /keyf[ile] možnosti v Al.exe (Assembly Linker). |
LinkResources |
Volitelný ITaskItem[] parametr.Pro propojení zadaných souborů prostředků se sestavením. Prostředek se stane součástí sestavení, ale soubor se nezkopíruje. Položky předané tomuto parametru mohou mít volitelná metadata připojena k nim s názvem LogicalName, Targeta Access. Metadata LogicalName slouží k určení interního identifikátoru prostředku. Metadata Target mohou zadat cestu a název souboru, do kterého úloha zkopíruje soubor, po kterém tento nový soubor zkompiluje do sestavení. Metadata Access lze nastavit tak private , aby prostředek nebyl viditelný pro jiná sestavení. Další informace naleznete v dokumentaci k /link[resource] možnosti v Al.exe (Assembly Linker). |
MainEntryPoint |
Volitelný String parametr.Určuje plně kvalifikovaný název (class.method) metody, který se má použít jako vstupní bod při převodu modulu na spustitelný soubor. Tento parametr odpovídá /main možnosti v Al.exe (Assembly Linker). |
OutputAssembly |
Povinný ITaskItem výstupní parametr. Určuje název souboru vygenerovaného touto úlohou. Tento parametr odpovídá /out možnosti v Al.exe (Assembly Linker). |
Platform |
Volitelný String parametr.Omezuje, na které platformě může tento kód běžet; musí být jedním z x86, , x64Itaniumnebo anycpu. Výchozí hodnota je anycpu. Tento parametr odpovídá /platform možnosti v Al.exe (Assembly Linker). |
ProductName |
Volitelný String parametr.Určuje řetězec pro Product pole v sestavení. Další informace naleznete v dokumentaci k /prod[uct] možnosti v Al.exe (Assembly Linker). |
ProductVersion |
Volitelný String parametr.Určuje řetězec pro ProductVersion pole v sestavení. Další informace naleznete v dokumentaci k /productv[ersion] možnosti v Al.exe (Assembly Linker). |
ResponseFiles |
Volitelný String[] parametr.Určuje soubory odpovědí, které obsahují další možnosti pro předání do linkeru sestavení. |
SdkToolsPath |
Volitelný String parametr.Určuje cestu k nástrojům sady SDK, například resgen.exe. |
SourceModules |
Volitelný ITaskItem[] parametr.Jeden nebo více modulů, které se mají zkompilovat do sestavení. Moduly budou uvedeny v manifestu výsledného sestavení a budou stále muset distribuovat a k dispozici, aby bylo možné sestavení načíst. Položky předané do tohoto parametru mohou mít další metadata, Targetkterá určují cestu a název souboru, do kterého úloha zkopíruje soubor, po kterém tento nový soubor zkompiluje do sestavení. Další informace naleznete v dokumentaci k Al.exe (Assembly Linker). Tento parametr odpovídá seznamu modulů předaných do Al.exe bez konkrétního přepínače. |
TargetType |
Volitelný String parametr.Určuje formát souboru výstupního souboru: library (knihovna kódu), exe (konzolová aplikace) nebo win (aplikace založená na Systému Windows). Výchozí hodnota je library. Tento parametr odpovídá /t[arget] možnosti v Al.exe (Assembly Linker). |
TemplateFile |
Volitelný String parametr.Určuje sestavení, ze kterého se mají dědit všechna metadata sestavení s výjimkou pole jazykové verze. Zadané sestavení musí mít silný název. Sestavení, které vytvoříte pomocí parametru TemplateFile , bude satelitní sestavení. Tento parametr odpovídá /template možnosti v Al.exe (Assembly Linker). |
Timeout |
Volitelný Int32 parametr.Určuje dobu v milisekundách, po které se spustitelný soubor úlohy ukončí. Výchozí hodnota znamená Int.MaxValue, že neexistuje žádné časové období. |
Title |
Volitelný String parametr.Určuje řetězec pro Title pole v sestavení. Další informace naleznete v dokumentaci k /title možnosti v Al.exe (Assembly Linker). |
ToolPath |
Volitelný String parametr.Určuje umístění, ze kterého úloha načte základní spustitelný soubor (Al.exe). Pokud tento parametr není zadaný, úloha použije instalační cestu sady SDK odpovídající verzi architektury, na které běží nástroj MSBuild. |
Trademark |
Volitelný String parametr.Určuje řetězec pro Trademark pole v sestavení. Další informace naleznete v dokumentaci k /trade[mark] možnosti v Al.exe (Assembly Linker). |
Version |
Volitelný String parametr.Určuje informace o verzi pro toto sestavení. Formát řetězce je major.minor.build.revision. Výchozí hodnota je 0. Další informace naleznete v dokumentaci k /v[ersion] možnosti v Al.exe (Assembly Linker). |
Win32Icon |
Volitelný String parametr.Vloží soubor .ico do sestavení. Soubor .ico dává výstupnímu souboru požadovaný vzhled v Průzkumník souborů. Tento parametr odpovídá /win32icon možnosti v Al.exe (Assembly Linker). |
Win32Resource |
Volitelný String parametr.Vloží do výstupního souboru prostředek Win32 (soubor .res ). Další informace naleznete v dokumentaci k /win32res možnosti v Al.exe (Assembly Linker). |
Parametry ToolTaskExtension
Tento úkol dědí z ToolTaskExtension třídy, která dědí ze ToolTask třídy, která sama dědí z Task třídy. Tento řetěz dědičnosti přidá několik parametrů k úkolům, které jsou z nich odvozeny.
Následující tabulka popisuje parametry základních tříd:
| Parametr | Popis |
|---|---|
| EchoOff | Volitelný bool parametr.Pokud je truetato hodnota nastavena , tento úkol předá příkazový řádek cmd.exe příkazový řádek tak, aby se příkazový řádek nezkopíroval do stdout. |
| EnvironmentVariables | Volitelný String parametr pole.Pole definic proměnných prostředí oddělené středníky Každá definice by měla určovat název proměnné prostředí a hodnotu oddělenou symbolem rovná se. Tyto proměnné se předávají do vytvářeného spustitelného souboru kromě pravidelného bloku prostředí nebo selektivně přepisují. Například, Variable1=Value1;Variable2=Value2. |
| ExitCode | Volitelný Int32 výstupní parametr jen pro čtení.Určuje ukončovací kód, který poskytuje spuštěný příkaz. Pokud úloha protokolovala nějaké chyby, ale proces měl ukončovací kód 0 (úspěch), je nastaven na hodnotu -1. |
| LogStandardErrorAsError | Volitelný bool parametr.Pokud truese všechny zprávy přijaté ve standardním chybovém streamu zaprotokolují jako chyby. |
| StandardErrorImportance | Volitelný String parametr.Důležitost, se kterou se má protokolovat text ze standardního datového proudu chyb |
| StandardOutputImportance | Volitelný String parametr.Důležitost, se kterou se má protokolovat text ze standardního výstupního datového proudu |
| Timeout | Volitelný Int32 parametr.Určuje dobu v milisekundách, po které se spustitelný soubor úlohy ukončí. Výchozí hodnota znamená Int.MaxValue, že neexistuje žádné časové období. Časový limit je v milisekundách. |
| ToolExe | Volitelný string parametr.Projekty můžou tuto implementaci implementovat, aby přepsaly ToolName. Úkoly můžou tuto možnost přepsat, aby se zachoval název ToolName. |
| ToolPath | Volitelný string parametr.Určuje umístění, ze kterého úloha načte základní spustitelný soubor. Pokud tento parametr není zadaný, úloha použije instalační cestu sady SDK, která odpovídá verzi architektury, na které běží nástroj MSBuild. |
| UseCommandProcessor | Volitelný bool parametr.Pokud je tato úloha nastavená na truehodnotu , vytvoří pro příkazový řádek dávkový soubor a spustí ho pomocí procesoru příkazů místo přímého spuštění příkazu. |
| YieldDuringToolExecution | Volitelný bool parametr.Pokud je tato hodnota nastavená na true, tento úkol při provádění úkolu získá uzel. |
Příklad
Následující příklad vytvoří sestavení se zadanými možnostmi.
<AL
EmbedResources="@(EmbeddedResource)"
Culture="%(EmbeddedResource.Culture)"
TemplateFile="@(IntermediateAssembly)"
KeyContainer="$(KeyContainerName)"
KeyFile="$(KeyOriginatorFile)"
DelaySign="$(DelaySign)"
OutputAssembly=
"%(EmbeddedResource.Culture)\$(TargetName).resources.dll">
<Output TaskParameter="OutputAssembly"
ItemName="SatelliteAssemblies"/>
</AL>