AL (linker sestavení) – úloha

  • Článek

Ú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>

Viz také