Задача AL (компоновщик сборок)

Задача AL включает AL.exe — инструмент, распространяемый с Windows SDK. Этот компоновщик сборок используется для создания сборки с манифестом из одного или нескольких файлов, являющихся модулями или файлами ресурсов. Компиляторы и среды разработки обеспечивают указанные возможности, в связи с чем необходимость в непосредственном использовании этого задания возникает достаточно редко. Компоновщик сборок особенно полезен, если нужно создать единую сборку из нескольких файлов компонентов, например при разработке на нескольких языках. Эта задача не объединяет модули в один файл сборки. Отдельные модули должны оставаться распределенными и доступными для правильной загрузки результирующей сборки. Дополнительные сведения об инструменте AL.exe см. в статье Al.exe (компоновщик сборок).

Параметры

В следующей таблице приводятся параметры задачи AL.

Параметр	Описание
AlgorithmID	Необязательный параметр String. Задает алгоритм хэширования всех файлов многофайловой сборки, кроме файла, содержащего манифест сборки. Дополнительные сведения см. в документации по параметру /algid в статье Al.exe (компоновщик сборок).
BaseAddress	Необязательный параметр String. Задает адрес для загрузки библиотеки DLL на компьютер пользователя во время выполнения. Приложения загружаются быстрее, если задан базовый адрес DLL и операционная система не перемещает библиотеки в пространстве процесса. Этот параметр соответствует свойству /baseaddress.
CompanyName	Необязательный параметр String. Задает строковое значение поля Company в сборке. Дополнительные сведения см. в документации по параметру /comp[any] в статье Al.exe (компоновщик сборок).
Configuration	Необязательный параметр String. Задает строковое значение поля Configuration в сборке. Дополнительные сведения см. в документации по параметру /config[uration] в статье Al.exe (компоновщик сборок).
Copyright	Необязательный параметр String. Задает строковое значение поля Copyright в сборке. Дополнительные сведения см. в документации по параметру /copy[right] в статье Al.exe (компоновщик сборок).
Culture	Необязательный параметр String. Задает строковое значение языка и региональных параметров для связывания со сборкой. Дополнительные сведения см. в документации по параметру /c[ulture] в статье Al.exe (компоновщик сборок).
DelaySign	Необязательный параметр Boolean. Задайте значение true, чтобы разместить в сборке только открытый ключ, или false, чтобы полностью подписать сборку. Дополнительные сведения см. в документации по параметру /delay[sign] в статье Al.exe (компоновщик сборок).
Description	Необязательный параметр String. Задает строковое значение поля Description в сборке. Дополнительные сведения см. в документации по параметру /descr[iption] в статье Al.exe (компоновщик сборок).
EmbedResources	Необязательный параметр ITaskItem[]. Внедряет указанные ресурсы в образ, содержащий манифест сборки. Эта задача копирует содержимое файла ресурсов в образ. Элементы, передаваемые в этот параметр, могут иметь вложенные необязательные метаданные LogicalName и Access. Метаданные LogicalName используются для указания внутреннего идентификатора ресурса. Для метаданных Access можно задать значение private, чтобы сделать данный ресурс невидимым для других сборок. Дополнительные сведения см. в документации по параметру /embed[resource] в статье Al.exe (компоновщик сборок).
EvidenceFile	Необязательный параметр String. Внедряет указанный файл в сборку с именем ресурса Security.Evidence. Использовать имя Security.Evidence для обычных ресурсов нельзя. Этот параметр соответствует параметру /e[vidence] в статье Al.exe (компоновщик сборок).
ExitCode	Необязательный выходной параметр Int32, доступный только для чтения. Определяет код выхода, возвращаемый выполняемой командой.
FileVersion	Необязательный параметр String. Задает строковое значение поля File Version в сборке. Дополнительные сведения см. в документации по параметру /fileversion в статье Al.exe (компоновщик сборок).
Flags	Необязательный параметр String. Задает значение для поля Flags в сборке. Дополнительные сведения см. в документации по параметру /flags в статье Al.exe (компоновщик сборок).
GenerateFullPaths	Необязательный параметр Boolean. Указывает, что в задаче должны использоваться абсолютные пути для всех файлов, имена которых присутствуют в сообщении об ошибке. Этот параметр соответствует параметру /fullpaths в статье Al.exe (компоновщик сборок).
KeyContainer	Необязательный параметр String. Задает контейнер, хранящий пару ключей. При этом сборка (ей следует присвоить строгое имя) будет подписана путем вставки открытого ключа в манифест сборки. Затем задача подпишет окончательную сборку с помощью закрытого ключа. Дополнительные сведения см. в документации по параметру /keyn[ame] в статье Al.exe (компоновщик сборок).
KeyFile	Необязательный параметр String. Задает файл, содержащий пару ключей или только открытый ключ для подписывания сборки. Компилятор вставляет открытый ключ в манифест сборки, а затем подписывает окончательную сборку закрытым ключом. Дополнительные сведения см. в документации по параметру /keyf[ile] в статье Al.exe (компоновщик сборок).
LinkResources	Необязательный параметр ITaskItem[]. Связывает указанные файлы ресурсов со сборкой. Ресурс становится частью сборки, но файл не копируется. Элементы, передаваемые в этот параметр, могут иметь вложенные необязательные метаданные LogicalName, Target и Access. Метаданные LogicalName используются для указания внутреннего идентификатора ресурса. Метаданные Target указывают путь и имя файла, в который задача копирует файл, после чего этот новый файл компилируется в сборку. Для метаданных Access можно задать значение private, чтобы сделать данный ресурс невидимым для других сборок. Дополнительные сведения см. в документации по параметру /link[resource] в статье Al.exe (компоновщик сборок).
MainEntryPoint	Необязательный параметр String. Задает полное имя (класс.метод) метода, являющегося точкой входа при преобразовании модуля в исполняемый файл. Этот параметр соответствует параметру /main в статье Al.exe (компоновщик сборок).
OutputAssembly	Необязательный выходной параметр ITaskItem. Указывает имя файла, создаваемого этой задачей. Этот параметр соответствует параметру /out в статье Al.exe (компоновщик сборок).
Platform	Необязательный параметр String. Ограничивает возможности выполнения кода одной из следующих платформ: x86, Itanium, x64 или anycpu. Значение по умолчанию — anycpu. Этот параметр соответствует параметру /platform в статье Al.exe (компоновщик сборок).
ProductName	Необязательный параметр String. Задает строковое значение поля Product в сборке. Дополнительные сведения см. в документации по параметру /prod[uct] в статье Al.exe (компоновщик сборок).
ProductVersion	Необязательный параметр String. Задает строковое значение поля ProductVersion в сборке. Дополнительные сведения см. в документации по параметру /productv[ersion] в статье Al.exe (компоновщик сборок).
ResponseFiles	Необязательный параметр String[]. Указывает файлы ответов, содержащие дополнительные параметры для прохождения к компоновщику сборок.
SdkToolsPath	Необязательный параметр String. Указывает путь к средствам пакета SDK, например resgen.exe.
SourceModules	Необязательный параметр ITaskItem[]. Один или несколько модулей для компиляции в сборку. Модули будут перечислены в манифесте результирующей сборки. Они должны будут оставаться распределенными и доступными для загрузки сборки. Элементы, передаваемые в этот параметр, могут иметь вложенные необязательные метаданные Target, указывающие путь и имя файла, в который задача копирует файл, после чего этот новый файл компилируется в сборку. Дополнительные сведения см. в документации по Al.exe (компоновщик сборок). Этот параметр соответствует списку модулей, передаваемому в Al.exe без определенного параметра.
TargetType	Необязательный параметр String. Задает формат выходного файла: library (библиотека кода), exe (консольное приложение) или win (приложение Windows). Значение по умолчанию — library. Этот параметр соответствует параметру /t[arget] в статье Al.exe (компоновщик сборок).
TemplateFile	Необязательный параметр String. Указывает сборку, от которой требуется унаследовать все метаданные сборки, кроме поля языка и региональных параметров. Указанная сборка должна иметь строгое имя. Сборка, созданная с использованием параметра TemplateFile, будет вспомогательной. Этот параметр соответствует параметру /template в статье Al.exe (компоновщик сборок).
Timeout	Необязательный параметр Int32. Задает промежуток времени в миллисекундах, после которого исполняемый файл задачи прекращается. Значение по умолчанию — Int.MaxValue. Оно указывает, что период ожидания отсутствует.
Title	Необязательный параметр String. Задает строковое значение поля Title в сборке. Дополнительные сведения см. в документации по параметру /title в статье Al.exe (компоновщик сборок).
ToolPath	Необязательный параметр String. Указывает расположение, из которого задача будет загружать базовый исполняемый файл (Al.exe). Если этот параметр не задан, задача использует путь установки пакета SDK, соответствующий версии платформы, на которой выполняется MSBuild.
Trademark	Необязательный параметр String. Задает строковое значение поля Trademark в сборке. Дополнительные сведения см. в документации по параметру /trade[mark] в статье Al.exe (компоновщик сборок).
Version	Необязательный параметр String. Указывает сведения о версии для определенной сборки. Формат строки: основной_номер_версии.дополнительный_номер_версии.сборка.редакция. Значение по умолчанию равно 0. Дополнительные сведения см. в документации по параметру /v[ersion] в статье Al.exe (компоновщик сборок).
Win32Icon	Необязательный параметр String. Внедряет в сборку ICO-файл. ICO-файл является изображением значка выходного файла в проводнике. Этот параметр соответствует параметру /win32icon в статье Al.exe (компоновщик сборок).
Win32Resource	Необязательный параметр String. Вставляет файл ресурсов Win32 (RES-файл) в выходной файл. Дополнительные сведения см. в документации по параметру /win32res в статье Al.exe (компоновщик сборок).

Параметры ToolTaskExtension

Эта задача наследуется от класса ToolTaskExtension, который наследуется от класса ToolTask, который, в свою очередь, наследуется от класса Task. Эта цепочка наследования добавляет несколько параметров в задачи, которые от них происходят.

В следующей таблице описываются параметры базовых классов:

Параметр	Описание
EchoOff	Необязательный параметр bool. Если задано значение true, то задача передает /Q в командную строку cmd.exe и командная строка не копируется в stdout.
EnvironmentVariables	Необязательный параметр массива String. Массив определений переменных среды, разделенных точкой с запятой. Каждое определение должно содержать имя и значение переменной среды, разделенные знаком равенства. Эти переменные частично передаются в порожденный исполняемый файл, дополняя или выборочно переопределяя обычный блок среды. Например, Variable1=Value1;Variable2=Value2.
ExitCode	Необязательный выходной параметр Int32, доступный только для чтения. Задает код выхода, предоставляемый выполняемой командой. Если задача зарегистрировала какие-либо ошибки, но процесс имеет код выхода 0 (успешное завершение), этот параметр имеет значение -1.
LogStandardErrorAsError	Необязательный параметр bool. Если он имеет значение true, то все сообщения, полученные в стандартном потоке ошибок, регистрируются как ошибки.
StandardErrorImportance	Необязательный параметр String. степень важности, с которой текст из стандартного потока ошибок следует регистрировать в журнале.
StandardOutputImportance	Необязательный параметр String. Степень важности, с которой текст из стандартного выходного потока следует регистрировать в журнале.
Timeout	Необязательный параметр Int32. Задает промежуток времени в миллисекундах, после которого исполняемый файл задачи прекращается. Значение по умолчанию — Int.MaxValue. Оно указывает, что период ожидания отсутствует. Время ожидания в миллисекундах.
ToolExe	Необязательный параметр string. Он может реализовываться в проектах для переопределения параметра ToolName. Задачи могут переопределять его для сохранения параметра ToolName.
ToolPath	Необязательный параметр string. Указывает расположение, откуда задача загружает базовый исполняемый файл. Если этот параметр не задан, задача использует путь установки пакета SDK, соответствующий версии платформы, на которой выполняется MSBuild.
UseCommandProcessor	Необязательный параметр bool. Если задано значение true, эта задача создает пакетный файл для командной строки и выполняет его с помощью командного процессора вместо непосредственного выполнения команды.
YieldDuringToolExecution	Необязательный параметр bool. Если задано значение true, эта задача создает узел при выполнении его задачи.

Пример

В следующем примере создается сборка с заданными параметрами.

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

См. также

• Справочные сведения о задачах
• Задачи