Tarefa do AL (do Assembly Linker)
A tarefa AL quebra AL.exe, uma ferramenta que é distribuída com o Windows Software Development Kit (SDK). Esta ferramenta Assembly Linker é usada para criar um assembly com um manifesto de um ou mais arquivos que estão em módulos ou arquivos de recurso. Compiladores e ambientes de desenvolvimento podem já oferecer estas capacidades, portanto, geralmente não é necessário usar essa tarefa diretamente. O Assembly Linker é mais útil para desenvolvedores que precisam criar um único assembly a partir de vários arquivos de componentes, como aqueles que poderiam ser produzidos por um desenvolvimento multi-idiomas. Esta tarefa não combinar os módulos em um arquivo de assembly único; os módulos individuais ainda devem ser distribuído e disponível para o assembly resultante carregar corretamente. Para obter mais informações sobre AL.exe, consulte AL.exe (do Assembly Linker).
Parâmetros
A tabela a seguir descreve os parâmetros da AL de tarefas.
Parâmetro |
Descrição |
|---|---|
AlgorithmID |
Opcional String parâmetro. Especifica um algoritmo para hash todos os arquivos em um conjunto de vários arquivos, exceto o arquivo que contém o manifesto conjunto. Para obter mais informações, consulte a documentação para o /algid opção na AL.exe (do Assembly Linker). |
BaseAddress |
Opcional String parâmetro. Especifica o endereço no qual uma DLL será carregada no computador do usuário em tempo de execução. Aplicativos carregada mais rapidamente se você especificar o endereço básico de rather than as DLLs, permitindo que o Operating System realocar as DLLs no espaço de processo. Este parâmetro corresponde à opção /base [endereço] AL.exe (do Assembly Linker). |
CompanyName |
Opcional String parâmetro. Especifica uma seqüência de caracteres para o Company campo no assembly. Para obter mais informações, consulte a documentação para o /comp[any] opção na AL.exe (do Assembly Linker). |
Configuration |
Opcional String parâmetro. Especifica uma seqüência de caracteres para o Configuration campo no assembly. Para obter mais informações, consulte a documentação para o /config[uration] opção na AL.exe (do Assembly Linker). |
Copyright |
Opcional String parâmetro. Especifica uma seqüência de caracteres para o Copyright campo no assembly. Para obter mais informações, consulte a documentação para o /copy[right] opção na AL.exe (do Assembly Linker). |
Culture |
Opcional String parâmetro. Especifica a sequência cultura para associar ao conjunto. Para obter mais informações, consulte a documentação para o /c[ulture] opção na AL.exe (do Assembly Linker). |
DelaySign |
Opcional Boolean parâmetro. truepara colocar somente a chave pública do assembly; falsepara assinar uma assembly totalmente. Para obter mais informações, consulte a documentação para o /delay[sign] opção na AL.exe (do Assembly Linker). |
Description |
Opcional String parâmetro. Especifica uma seqüência de caracteres para o Description campo no assembly. Para obter mais informações, consulte a documentação para o /descr[iption] opção na AL.exe (do Assembly Linker). |
EmbedResources |
Opcional ITaskItem[] parâmetro. Incorpora os recursos especificados na imagem que contém o manifesto do assembly. Esta tarefa copia o conteúdo do arquivo de recurso na imagem. Os itens passados para este parâmetro podem ter metadados opcionais anexados a eles chamado LogicalName e Access. O LogicalName metadados é usado para especificar o identificador interno para o recurso. O Access metadados podem ser definido como private para tornar o recurso não é visível para outros assemblies. Para obter mais informações, consulte a documentação para o /embed[resource] opção na AL.exe (do Assembly Linker). |
EvidenceFile |
Opcional String parâmetro. Incorpora o arquivo especificado no assembly com o nome do recurso de Security.Evidence. Não é possível usar Security.Evidence para recursos regulares. Este parâmetro corresponde do /e[vidence] opção na AL.exe (do Assembly Linker). |
ExitCode |
Opcional Int32 saída somente leitura parâmetro. Especifica o código de saída fornecido pelo comando executado. |
FileVersion |
Opcional String parâmetro. Especifica uma seqüência de caracteres para o File Version campo no assembly. Para obter mais informações, consulte a documentação para o /fileversion opção na AL.exe (do Assembly Linker). |
Flags |
Opcional String parâmetro. Especifica um valor para o Flags campo no assembly. Para obter mais informações, consulte a documentação para o /flags opção na AL.exe (do Assembly Linker). |
GenerateFullPaths |
Opcional Boolean parâmetro. Faz com que a tarefa para usar o caminho absoluto para arquivos que são relatados em uma mensagem de erro. Este parâmetro corresponde do /fullpaths opção na AL.exe (do Assembly Linker). |
KeyContainer |
Opcional String parâmetro. Especifica um contêiner que contém um par de chaves. Isso irá assinar o assembly (dar um nome forte) inserindo-se em uma chave pública no manifesto do assembly. A tarefa será, em seguida, assinar uma assembly final com a chave particular. Para obter mais informações, consulte a documentação para o /keyn[ame] opção na AL.exe (do Assembly Linker). |
KeyFile |
Opcional String parâmetro. Especifica um arquivo que contém um par de chaves ou apenas uma chave pública para assinar um assembly. O compilador insere a chave pública no manifesto montagem e depois assina montagem final com a chave particular. Para obter mais informações, consulte a documentação para o /keyf[ile] opção na AL.exe (do Assembly Linker). |
LinkResources |
Opcional ITaskItem[] parâmetro. Vincula os arquivos de recurso especificado a um assembly. O recurso se torna parte do assembly, mas o arquivo não é copiado. Os itens passados para este parâmetro podem ter metadados opcionais anexados a eles chamado LogicalName, Target, e Access. O LogicalName metadados é usado para especificar o identificador interno para o recurso. O Target metadados podem especificar o caminho e nome de arquivo ao qual a tarefa copia o arquivo, após o qual ele compila esse novo arquivo para o assembly. O Access metadados podem ser definido como private para tornar o recurso não é visível para outros assemblies. Para obter mais informações, consulte a documentação para o /link[resource] opção na AL.exe (do Assembly Linker). |
MainEntryPoint |
Opcional String parâmetro. Especifica o nome totalmente qualificado (class.method) do método para usar como ponto de entrada ao converter um módulo para um arquivo executável. Este parâmetro corresponde do /main opção na AL.exe (do Assembly Linker). |
OutputAssembly |
Obrigatório ITaskItem parâmetro de saída. Especifica o nome do arquivo gerado por essa tarefa. Este parâmetro corresponde do /out opção na AL.exe (do Assembly Linker). |
Platform |
Opcional String parâmetro. Limita o que plataforma este código pode ser executado; must be one of x86, Itanium, x64, or anycpu. O padrão é anycpu. Este parâmetro corresponde do /platform opção na AL.exe (do Assembly Linker). |
ProductName |
Opcional String parâmetro. Especifica uma seqüência de caracteres para o Product campo no assembly. Para obter mais informações, consulte a documentação para o /prod[uct] opção na AL.exe (do Assembly Linker). |
ProductVersion |
Opcional String parâmetro. Especifica uma seqüência de caracteres para o ProductVersion campo no assembly. Para obter mais informações, consulte a documentação para o /productv[ersion] opção na AL.exe (do Assembly Linker). |
ResponseFiles |
Opcional String[] parâmetro. Especifica os arquivos de resposta que contenham opções adicionais para passar para o vinculador do Assembly. |
SdkToolsPath |
Opcional String parâmetro. Especifica o caminho para as ferramentas do SDK, como, por exemplo, Resgen. exe. |
SourceModules |
Opcional ITaskItem[] parâmetro. Um ou mais módulos para ser compilado em um assembly. Os módulos serão listados no manifesto do assembly resultante e ainda precisará distribuído e disponível para carregar o assembly. Os itens passados para este parâmetro podem ter metadados adicionais chamado Target, que especifica o caminho e nome de arquivo ao qual a tarefa copia o arquivo, após o qual ele compila esse novo arquivo para o assembly. Para obter mais informações, consulte a documentação de AL.exe (do Assembly Linker). Este parâmetro corresponde à lista de módulos passados em Al.exe sem um switch específico. |
TargetType |
Opcional String parâmetro. Especifica o formato de arquivo do arquivo de saída: library(biblioteca de código), exe (aplicativo de console), ou win (aplicativo baseado no Windows). O padrão é library. Este parâmetro corresponde do /t[arget] opção na AL.exe (do Assembly Linker). |
TemplateFile |
Opcional String parâmetro. Especifica o conjunto do qual herdar todos os metadados do assembly, exceto o campo da cultura. O assembly especificado deve ter um nome forte. Um assembly que você cria com o TemplateFile parâmetro será um assembly satélite. Este parâmetro corresponde do /template opção na AL.exe (do Assembly Linker). |
Timeout |
Opcional Int32 parâmetro. Especifica a quantidade de tempo, em milissegundos, após o qual a tarefa executável é encerrada. O valor padrão é Int.MaxValue, indicando que não há nenhum período de tempo limite. |
Title |
Opcional String parâmetro. Especifica uma seqüência de caracteres para o Title campo no assembly. Para obter mais informações, consulte a documentação para o /title opção na AL.exe (do Assembly Linker). |
ToolPath |
Opcional String parâmetro. Especifica o local de onde a tarefa será carregado o arquivo executável subjacente (Al.exe). Se este parâmetro não for especificado, a tarefa usa o caminho de instalação do SDK correspondentes à versão do framework que está executando o MSBuild. |
Trademark |
Opcional String parâmetro. Especifica uma seqüência de caracteres para o Trademark campo no assembly. Para obter mais informações, consulte a documentação para o /trade[mark] opção na AL.exe (do Assembly Linker). |
Version |
Opcional String parâmetro. Especifica as informações de versão para este assembly. O formato da seqüência de caracteres é major.minor.build.revision. O valor padrão é 0. Para obter mais informações, consulte a documentação para o /v[ersion] opção na AL.exe (do Assembly Linker). |
Win32Icon |
Opcional String parâmetro. Insere um arquivo.ico na montagem. O arquivo.ico oferece o arquivo de saída a aparência desejada no Windows Explorer. Este parâmetro corresponde do /win32icon opção na AL.exe (do Assembly Linker). |
Win32Resource |
Opcional String parâmetro. Insere um recurso do Win32 (arquivo. res) no arquivo de saída. Para obter mais informações, consulte a documentação para o /win32res opção na AL.exe (do Assembly Linker). |
Comentários
Além de para os parâmetros listados acima, esta tarefa herda os parâmetros da ToolTaskExtension , a própria classe herda o ToolTask classe. Para obter uma lista desses parâmetros adicionais e suas descrições, consulte Classe Base de ToolTaskExtension.
Exemplo
O exemplo a seguir cria um assembly com as opções especificadas.
<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>