AL (Assembly Linker, Tarea)
La tarea AL contiene AL.exe, una herramienta que se distribuye con Kit de desarrollo de software de Windows (SDK).La herramienta Assembly Linker se utiliza para crear un ensamblado con un manifiesto a partir de uno o varios archivos que pueden ser módulos o archivos de recursos.Los compiladores y los entornos de desarrollo pueden proporcionar estas capacidades, por lo que a menudo no hace falta utilizar esta tarea directamente.La herramienta resulta de más utilidad para los programadores que necesitan crear un único ensamblado a partir de varios archivos de componentes, como los que se pueden producir en desarrollos de lenguajes combinados.Esta tarea no combina los módulos en un único archivo de ensamblado; los módulos individuales deben distribuirse y estar disponibles para que el ensamblado resultante se cargue correctamente.Para obtener más información sobre AL.exe, vea Al.exe (Assembly Linker).
Parámetros
En la siguiente tabla se describen los parámetros de la tarea AL.
Parámetro |
Descripción |
|---|---|
AlgorithmID |
Parámetro String opcional. Especifica un algoritmo para generar un valor de clave hash para todos los archivos en un ensamblado de múltiples archivos, exceptuando el archivo que contiene el manifiesto del ensamblado.Para obtener más información, consulte la documentación sobre la opción /algid en Al.exe (Assembly Linker). |
BaseAddress |
Parámetro String opcional. Especifica la dirección donde se cargará un archivo DLL en el equipo del usuario en tiempo de ejecución.Las aplicaciones se cargan con mayor rapidez si se especifica la dirección base de los archivos DLL, en lugar de dejar que el sistema operativo cambie la ubicación de los mismos en el espacio de procesos.Este parámetro corresponde a la opción /base[dirección] de Al.exe (Assembly Linker). |
CompanyName |
Parámetro String opcional. Especifica una cadena para el campo Company del ensamblado.Para obtener más información, consulte la documentación sobre la opción /comp[any] en Al.exe (Assembly Linker). |
Configuration |
Parámetro String opcional. Especifica una cadena para el campo Configuration del ensamblado.Para obtener más información, consulte la documentación sobre la opción /config[uration] en Al.exe (Assembly Linker). |
Copyright |
Parámetro String opcional. Especifica una cadena para el campo Copyright del ensamblado.Para obtener más información, consulte la documentación sobre la opción /copy[right] en Al.exe (Assembly Linker). |
Culture |
Parámetro String opcional. Especifica la cadena de referencia cultural que se ha de asociar al ensamblado.Para obtener más información, consulte la documentación sobre la opción /c[ulture] en Al.exe (Assembly Linker). |
DelaySign |
Parámetro Boolean opcional. true para colocar sólo la clave pública en el ensamblado; false para firmar completamente el ensamblado.Para obtener más información, consulte la documentación sobre la opción /delay[sign] en Al.exe (Assembly Linker). |
Description |
Parámetro String opcional. Especifica una cadena para el campo Description del ensamblado.Para obtener más información, consulte la documentación sobre la opción /descr[iption] en Al.exe (Assembly Linker). |
EmbedResources |
Parámetro ITaskItem[] opcional. Incrusta los recursos especificados en la imagen que contiene el manifiesto del ensamblado.Esta tarea copia el contenido del archivo de recursos en la imagen.Los elementos pasados a este parámetro pueden tener metadatos opcionales adjuntos a los mismos denominados LogicalName y Access.Los metadatos LogicalName se utilizan para especificar el identificador interno del recurso.Los metadatos Access se pueden establecer en private para que el recurso no sea visible para otros ensamblados.Para obtener más información, consulte la documentación sobre la opción /embed[resource] en Al.exe (Assembly Linker). |
EvidenceFile |
Parámetro String opcional. Incrusta el archivo especificado en el ensamblado con el nombre de recurso de Security.Evidence. No se puede utilizar Security.Evidence para los recursos habituales.Este parámetro corresponde a la opción /e[vidence] de Al.exe (Assembly Linker). |
ExitCode |
Parámetro de salida de sólo lectura Int32 opcional. Especifica el código de salida proporcionado por el comando ejecutado. |
FileVersion |
Parámetro String opcional. Especifica una cadena para el campo File Version del ensamblado.Para obtener más información, consulte la documentación sobre la opción /fileversion en Al.exe (Assembly Linker). |
Flags |
Parámetro String opcional. Especifica un valor para el campo Flags del ensamblado.Para obtener más información, consulte la documentación sobre la opción /flags en Al.exe (Assembly Linker). |
GenerateFullPaths |
Parámetro Boolean opcional. Hace que la tarea use la ruta de acceso absoluta de los archivos que se enumeran en un mensaje de error.Este parámetro corresponde a la opción /fullpaths de Al.exe (Assembly Linker). |
KeyContainer |
Parámetro String opcional. Especifica un contenedor que contiene un par de claves.De este modo, el ensamblado se firmará (recibirá un nombre seguro) mediante la inserción de una clave pública en el manifiesto del ensamblado.La tarea firmará después el ensamblado final con la clave privada.Para obtener más información, consulte la documentación sobre la opción /keyn[ame] en Al.exe (Assembly Linker). |
KeyFile |
Parámetro String opcional. Especifica un archivo que contiene un par de claves o simplemente una clave pública para firmar un ensamblado.El compilador inserta la clave pública en el manifiesto del ensamblado y firma después el ensamblado final con la clave privada.Para obtener más información, consulte la documentación sobre la opción /keyf[ile] en Al.exe (Assembly Linker). |
LinkResources |
Parámetro ITaskItem[] opcional. Vincula los archivos de recursos especificados a este ensamblado.El recurso pasa a formar parte del ensamblado, pero el archivo no se copia.Los elementos pasados a este parámetro pueden tener asociados metadatos opcionales que se denominan LogicalName, Target y Access.Los metadatos LogicalName se utilizan para especificar el identificador interno del recurso.Los metadatos Target pueden especificar el nombre de archivo y la ruta de acceso donde la tarea copia el archivo, tras lo cual compila este nuevo archivo en el ensamblado.Los metadatos Access se pueden establecer en private para que el recurso no sea visible para otros ensamblados.Para obtener más información, consulte la documentación sobre la opción /link[resource] en Al.exe (Assembly Linker). |
MainEntryPoint |
Parámetro String opcional. Especifica el nombre completo (class.method) del método que se utilizará como punto de entrada al convertir un módulo en un archivo ejecutable.Este parámetro corresponde a la opción /main de Al.exe (Assembly Linker). |
OutputAssembly |
Parámetro de salida ITaskItem requerido. Especifica el nombre del archivo generado por esta tarea.Este parámetro corresponde a la opción /out de Al.exe (Assembly Linker). |
Platform |
Parámetro String opcional. Limita en qué plataforma se puede ejecutar este código; debe ser x86, Itanium, x64 o anycpu.El valor predeterminado es anycpu.Este parámetro corresponde a la opción /platform de Al.exe (Assembly Linker). |
ProductName |
Parámetro String opcional. Especifica una cadena para el campo Product del ensamblado.Para obtener más información, consulte la documentación sobre la opción /prod[uct] en Al.exe (Assembly Linker). |
ProductVersion |
Parámetro String opcional. Especifica una cadena para el campo ProductVersion del ensamblado.Para obtener más información, consulte la documentación sobre la opción /productv[ersion] en Al.exe (Assembly Linker). |
ResponseFiles |
Parámetro String[] opcional. Especifica los archivos de respuesta que contienen las opciones adicionales que deben pasarse al Assembly Linker. |
SdkToolsPath |
Parámetro String opcional. Especifica la ruta de acceso a las herramientas del SDK, tales como resgen.exe. |
SourceModules |
Parámetro ITaskItem[] opcional. Uno o más módulos que se compilarán en un ensamblado.Los módulos aparecerán en una lista en el manifiesto del ensamblado resultante, y tendrán que distribuirse y estar disponibles para poder cargar el ensamblado.Los elementos que se pasan a este parámetro pueden tener metadatos adicionales denominados Target, que especifican la ruta y el nombre de archivo en el que la tarea copia el archivo, tras lo cual compilará este nuevo archivo en el ensamblado.Para obtener más información, consulte la documentación existente sobre Al.exe (Assembly Linker).Este parámetro corresponde a la lista de módulos pasados a Al.exe sin un modificador concreto. |
TargetType |
Parámetro String opcional. Especifica el formato del archivo de salida: library (biblioteca de códigos), exe (aplicación de consola), o win (aplicación basada en Windows).El valor predeterminado es library.Este parámetro corresponde a la opción /t[arget] de Al.exe (Assembly Linker). |
TemplateFile |
Parámetro String opcional. Especifica el ensamblado que se utilizará para heredar todos los metadatos del ensamblado, salvo el campo correspondiente a la referencia cultural.El ensamblado especificado debe tener un nombre seguro. El ensamblado creado con el parámetro TemplateFile será un ensamblado satélite.Este parámetro corresponde a la opción /template de Al.exe (Assembly Linker). |
Timeout |
Parámetro Int32 opcional. Especifica el tiempo, en milisegundos, tras el cual se termina la tarea ejecutable.El valor predeterminado es Int.MaxValue; es decir, no existe tiempo de espera. |
Title |
Parámetro String opcional. Especifica una cadena para el campo Title del ensamblado.Para obtener más información, consulte la documentación sobre la opción /title en Al.exe (Assembly Linker). |
ToolPath |
Parámetro String opcional. Especifica la ubicación desde la que la tarea cargará el archivo ejecutable subyacente (Al.exe).Si no se especifica este parámetro, la tarea utiliza la ruta de acceso de instalación de SDK correspondiente a la versión de Framework que está ejecutando MSBuild. |
Trademark |
Parámetro String opcional. Especifica una cadena para el campo Trademark del ensamblado.Para obtener más información, consulte la documentación sobre la opción /trade[mark] en Al.exe (Assembly Linker). |
Version |
Parámetro String opcional. Especifica la información de versión de este ensamblado.El formato de la cadena es major.minor.build.revision.El valor predeterminado es 0.Para obtener más información, consulte la documentación sobre la opción /v[ersion] en Al.exe (Assembly Linker). |
Win32Icon |
Parámetro String opcional. Inserta un archivo .ico en el ensamblado.El archivo .ico proporciona al archivo de salida la apariencia deseada en el Explorador de archivos.Este parámetro corresponde a la opción /win32icon de Al.exe (Assembly Linker). |
Win32Resource |
Parámetro String opcional. Inserta un recurso de Win32 (archivo .res) en el archivo de salida.Para obtener más información, consulte la documentación sobre la opción /win32res en Al.exe (Assembly Linker). |
Comentarios
Además de los parámetros mencionados anteriormente, esta tarea hereda los parámetros de la clase ToolTaskExtension, que hereda de la clase ToolTask.Para obtener una lista de estos parámetros adicionales y sus descripciones, vea ToolTaskExtension (Clase base).
Ejemplo
En el ejemplo siguiente se crea un ensamblado con las opciones 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>