Úlohy AL (Assembly Linker)
Program AL.exe, nástroj, který je distribuován s obtéká úlohy AL Windows Software Development Kit (SDK).Tento nástroj Assembly Linker lze vytvořit z jednoho nebo více souborů, které jsou buď moduly nebo zdrojové soubory manifestu sestavení.Kompilátory a vývojová prostředí již poskytují tyto možnosti, takže není často nutné použít tento úkol přímo.Assembly Linker je nejužitečnější vývojáři museli vytvořit jediné sestavení z více souborů součásti, například ty, které mohou vyrobené z vývoje jiných jazyků.Tento úkol není kombinovat moduly do jediné sestavení souboru; jednotlivé moduly musí být stále k dispozici, aby výsledné sestavení správně načíst a distribuovaných.Další informace o souboru AL.exe viz Program al.exe (Assembly Linker).
Parametry
Následující tabulka popisuje parametry AL úkolu.
Parametr |
Description |
|---|---|
AlgorithmID |
Volitelný String parametr. Určuje algoritmus pro všechny soubory v multifile sestavení kromě souboru, který obsahuje manifestu sestavení algoritmu hash.Další informace naleznete v dokumentaci k /algid možnost Program al.exe (Assembly Linker). |
BaseAddress |
Volitelný String parametr. Určuje adresu, kdy bude načtena knihovna DLL v počítači uživatele v době spuštění.Aplikací načtena rychleji, pokud zadáte základní adresa knihovny DLL, nikoli umožní přemístit knihovny DLL v prostoru procesu operačního systému.Tento parametr odpovídá možnosti [adresa] /base v Program al.exe (Assembly Linker). |
CompanyName |
Volitelný String parametr. Určuje řetězec, který Company v sestavení.Další informace naleznete v dokumentaci k /comp[any] možnost Program al.exe (Assembly Linker). |
Configuration |
Volitelný String parametr. Určuje řetězec, který Configuration v sestavení.Další informace naleznete v dokumentaci k /config[uration] možnost Program al.exe (Assembly Linker). |
Copyright |
Volitelný String parametr. Určuje řetězec, který Copyright v sestavení.Další informace naleznete v dokumentaci k /copy[right] možnost Program al.exe (Assembly Linker). |
Culture |
Volitelný String parametr. Určuje řetězec kultury přidružit sestavení.Další informace naleznete v dokumentaci k /c[ulture] možnost Program al.exe (Assembly Linker). |
DelaySign |
Volitelný Boolean parametr. trueUmístěte veřejný klíč sestavení; falsek podepsání plně sestavení.Další informace naleznete v dokumentaci k /delay[sign] možnost Program al.exe (Assembly Linker). |
Description |
Volitelný String parametr. Určuje řetězec, který Description v sestavení.Další informace naleznete v dokumentaci k /descr[iption] možnost Program al.exe (Assembly Linker). |
EmbedResources |
Volitelný ITaskItem[] parametr. Vloží zadané zdroje obrazu, která obsahuje manifestu sestavení.Tento úkol zkopíruje obsah souboru prostředků do obrazu.Položky předán tento parametr může mít volitelné metadata připojená k jejich nazývá LogicalName a Access.LogicalName Metadat se používá k určení interní identifikátor prostředku.Access Metadat může být nastavena na private pro prostředek nejsou viditelné na ostatních sestaveních.Další informace naleznete v dokumentaci k /embed[resource] možnost Program al.exe (Assembly Linker). |
EvidenceFile |
Volitelný String parametr. Vloží zadaný soubor sestavení s názvem zdroje Security.Evidence. Nelze použít Security.Evidence běžných prostředků.Tento parametr odpovídá /e[vidence] možnost Program al.exe (Assembly Linker). |
ExitCode |
Volitelný Int32 výstupní parametr pouze pro čtení. Určuje kód ukončení poskytované příkaz spuštěný. |
FileVersion |
Volitelný String parametr. Určuje řetězec, který File Version v sestavení.Další informace naleznete v dokumentaci k /fileversion možnost Program al.exe (Assembly Linker). |
Flags |
Volitelný String parametr. Určuje hodnotu Flags v sestavení.Další informace naleznete v dokumentaci k /flags možnost Program al.exe (Assembly Linker). |
GenerateFullPaths |
Volitelný Boolean parametr. Způsobí, že úloha použijte absolutní cestu pro všechny soubory, které jsou hlášeny v chybové zprávě.Tento parametr odpovídá /fullpaths možnost Program al.exe (Assembly Linker). |
KeyContainer |
Volitelný String parametr. Určuje kontejner, který obsahuje dvojice klíčů.To bude podepsání sestavení (nazvěte ji silné) vložením veřejný klíč do manifestu sestavení.Úkol bude Finální montáž pak podepsat pomocí soukromého klíče.Další informace naleznete v dokumentaci k /keyn[ame] možnost Program al.exe (Assembly Linker). |
KeyFile |
Volitelný String parametr. Určuje soubor, který obsahuje dvojici klíčů nebo právě veřejný klíč k podepsání sestavení.Kompilátor vloží v manifestu sestavení veřejný klíč a potom podepíše konečnou montáž pomocí soukromého klíče.Další informace naleznete v dokumentaci k /keyf[ile] možnost Program al.exe (Assembly Linker). |
LinkResources |
Volitelný ITaskItem[] parametr. Propojí určený prostředek soubory sestavení.Zdroj stává součástí sestavení, ale soubor nebude zkopírován.Položky předán tento parametr může mít volitelné metadata připojená k jejich nazývá LogicalName, Target, a Access.LogicalName Metadat se používá k určení interní identifikátor prostředku.Target Metadata můžete zadat cestu a název souboru, do kterého úkol zkopíruje soubor, po které kompiluje tento nový soubor do sestavení.Access Metadat může být nastavena na private pro prostředek nejsou viditelné na ostatních sestaveních.Další informace naleznete v dokumentaci k /link[resource] možnost Program al.exe (Assembly Linker). |
MainEntryPoint |
Volitelný String parametr. Určuje úplný název (class.method) metody při převodu do spustitelného souboru modulu používá vstupní bod.Tento parametr odpovídá /main možnost Program al.exe (Assembly Linker). |
OutputAssembly |
Požadované ITaskItem výstupní parametr. Určuje název souboru vytvořený úkol.Tento parametr odpovídá /out možnost Program al.exe (Assembly Linker). |
Platform |
Volitelný String parametr. Omezuje platformy, které lze tento kód spustit; must be one of x86, Itanium, x64, or anycpu.Výchozí je anycpu.Tento parametr odpovídá /platform možnost Program al.exe (Assembly Linker). |
ProductName |
Volitelný String parametr. Určuje řetězec, který Product v sestavení.Další informace naleznete v dokumentaci k /prod[uct] možnost Program al.exe (Assembly Linker). |
ProductVersion |
Volitelný String parametr. Určuje řetězec, který ProductVersion v sestavení.Další informace naleznete v dokumentaci k /productv[ersion] možnost Program al.exe (Assembly Linker). |
ResponseFiles |
Volitelný String[] parametr. Určuje soubory odpovědi, které obsahují další možnosti projít do Assembly Linker. |
SdkToolsPath |
Volitelný String parametr. Určuje cestu k SDK nástroje, například resgen.exe. |
SourceModules |
Volitelný ITaskItem[] parametr. Jeden nebo více modulů vypracovávají do sestavení.Moduly budou uvedeny v manifestu sestavení výsledného a bude stále třeba distribuovaných a v pořadí načtení sestavení.Položky předán tento parametr může mít další metadata nazývá Target, který určuje cestu a název souboru, do kterého úkol zkopíruje soubor, po které kompiluje tento nový soubor do sestavení.Další informace naleznete v dokumentaci k Program al.exe (Assembly Linker).Tento parametr odpovídá seznamu modulů předaných do souboru Al.exe bez specifického přepínače. |
TargetType |
Volitelný String parametr. Určuje formát výstupního souboru: library (kód knihovny) exe (aplikace konzoly), nebo win (aplikace v systému Windows).Výchozí je library.Tento parametr odpovídá /t[arget] možnost Program al.exe (Assembly Linker). |
TemplateFile |
Volitelný String parametr. Určuje sestavení, ze kterého dědí všechna metadata sestavení, s výjimkou pole kultury.Zadané sestavení musí mít silný název. Sestavení, které vytvoříte TemplateFile bude mít parametr satelitní sestavení.Tento parametr odpovídá /template možnost Program al.exe (Assembly Linker). |
Timeout |
Volitelný Int32 parametr. Určuje dobu v milisekundách, po jejichž uplynutí je ukončeno spustitelný soubor úlohy.Výchozí hodnota je Int.MaxValue, neexistuje žádné období časového limitu. |
Title |
Volitelný String parametr. Určuje řetězec, který Title v sestavení.Další informace naleznete v dokumentaci k /title možnost Program al.exe (Assembly Linker). |
ToolPath |
Volitelný String parametr. Určuje umístění, kde bude úkol načíst podkladové spustitelný soubor (program Al.exe).Pokud není tento parametr zadán, použije úloha SDK Instalační cestu odpovídající verzi rozhraní se systémem MSBuild. |
Trademark |
Volitelný String parametr. Určuje řetězec, který Trademark v sestavení.Další informace naleznete v dokumentaci k /trade[mark] možnost Program 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žnost Program al.exe (Assembly Linker). |
Win32Icon |
Volitelný String parametr. Vloží soubor ICO sestavení.Soubor ICO dává výstupní soubor v Průzkumníku souborů požadovaný vzhled.Tento parametr odpovídá /win32icon možnost Program al.exe (Assembly Linker). |
Win32Resource |
Volitelný String parametr. Vloží výstupní soubor prostředku Win32 (res soubor).Další informace naleznete v dokumentaci k /win32res možnost Program al.exe (Assembly Linker). |
Poznámky
Kromě výše uvedených parametrů, zdědí tento úkol parametry z ToolTaskExtension dědí třídu, která sama ToolTask třídy.Seznam těchto další parametry a jejich popis naleznete v ToolTaskExtension základní třída.
Příklad
Následující příklad vytvoří sestavení zadané možnosti.
<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>