AL(어셈블리 링커) 작업
AL 작업은 Windows SDK(소프트웨어 개발 키트)와 함께 배포되는 도구인 AL.exe를 래핑합니다. 이 어셈블리 링커 도구는 모듈 또는 리소스 파일에 해당하는 하나 이상의 파일에 있는 매니페스트로 어셈블리를 생성하는 데 사용됩니다. 컴파일러 및 개발 환경에서 이러한 기능을 이미 제공할 수 있으므로 이 작업을 직접 사용할 필요가 없는 경우가 많습니다. 어셈블리 링커는 혼합 언어 개발에서 생성될 수 있는 것과 같은 여러 구성 요소 파일에서 단일 어셈블리를 만들어야 하는 개발자에게 가장 유용합니다. 이 작업은 모듈을 단일 어셈블리 파일로 결합하지 않습니다. 결과 어셈블리가 올바르게 로드되려면 여전히 개별 모듈이 분산되어야 하고 사용 가능해야 하기 때문입니다. AL.exe에 대한 자세한 내용은 Al.exe(어셈블리 링커)를 참조하세요.
매개 변수
다음 표에서는 AL 작업의 매개 변수에 대해 설명합니다.
| 매개 변수 | Description |
|---|---|
AlgorithmID |
선택적 String 매개 변수입니다.어셈블리 매니페스트가 포함된 파일을 제외하고 다중 파일 어셈블리에 있는 모든 파일을 해시하는 알고리즘을 지정합니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /algid 옵션에 대한 설명서를 참조하세요. |
BaseAddress |
선택적 String 매개 변수입니다.런타임에 DLL이 사용자의 컴퓨터에 로드되는 주소를 지정합니다. 운영 체제가 프로세스 공간에서 DLL을 재배치하게 하지 않고 DLL의 기본 주소를 직접 지정하면 애플리케이션의 로드 속도가 빨라집니다. 이 매개 변수는 /baseaddress에 해당합니다. |
CompanyName |
선택적 String 매개 변수입니다.어셈블리의 Company 필드에 대한 문자열을 지정합니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /comp[any] 옵션에 대한 설명서를 참조하세요. |
Configuration |
선택적 String 매개 변수입니다.어셈블리의 Configuration 필드에 대한 문자열을 지정합니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /config[uration] 옵션에 대한 설명서를 참조하세요. |
Copyright |
선택적 String 매개 변수입니다.어셈블리의 Copyright 필드에 대한 문자열을 지정합니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /copy[right] 옵션에 대한 설명서를 참조하세요. |
Culture |
선택적 String 매개 변수입니다.어셈블리에 연결할 문화권 문자열을 지정합니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /c[ulture] 옵션에 대한 설명서를 참조하세요. |
DelaySign |
선택적 Boolean 매개 변수입니다.어셈블리에 공개 키만 배치하려면 true이고, 어셈블리에 완전하게 서명하려면 false입니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /delay[sign] 옵션에 대한 설명서를 참조하세요. |
Description |
선택적 String 매개 변수입니다.어셈블리의 Description 필드에 대한 문자열을 지정합니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /descr[iption] 옵션에 대한 설명서를 참조하세요. |
EmbedResources |
선택적 ITaskItem[] 매개 변수입니다.어셈블리 매니페스트가 포함된 이미지에 지정된 리소스를 포함합니다. 이 작업은 이미지에 리소스 파일의 내용을 복사합니다. 이 매개 변수에 전달된 항목에는 LogicalName 및 Access라는 선택적 메타데이터가 연결될 수 있습니다. LogicalName 메타데이터는 리소스에 대한 내부 식별자를 지정하는 데 사용됩니다. 해당 리소스가 다른 어셈블리에 표시되지 않게 하려면 Access 메타데이터를 private로 설정할 수 있습니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /embed[resource] 옵션에 대한 설명서를 참조하세요. |
EvidenceFile |
선택적 String 매개 변수입니다.어셈블리에 지정된 파일을 Security.Evidence라는 리소스 이름으로 포함합니다.기본 리소스에는 Security.Evidence를 사용할 수 없습니다. 이 매개 변수는 Al.exe(어셈블리 링커)의 /e[vidence] 옵션에 해당합니다. |
ExitCode |
선택적 Int32 읽기 전용 출력 매개 변수입니다.실행한 명령에서 제공하는 종료 코드를 지정합니다. |
FileVersion |
선택적 String 매개 변수입니다.어셈블리의 File Version 필드에 대한 문자열을 지정합니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /fileversion 옵션에 대한 설명서를 참조하세요. |
Flags |
선택적 String 매개 변수입니다.어셈블리의 Flags 필드에 대한 값을 지정합니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /flags 옵션에 대한 설명서를 참조하세요. |
GenerateFullPaths |
선택적 Boolean 매개 변수입니다.오류 메시지에 보고되는 파일에 대해 이 작업은 절대 경로를 사용합니다. 이 매개 변수는 Al.exe(어셈블리 링커)의 /fullpaths 옵션에 해당합니다. |
KeyContainer |
선택적 String 매개 변수입니다.키 쌍을 보관하는 컨테이너를 지정합니다. 어셈블리 매니페스트에 공개 키를 삽입하여 어셈블리에 서명(강력한 이름을 부여)합니다. 그런 다음 이 작업은 프라이빗 키를 사용하여 최종 어셈블리에 서명합니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /keyn[ame] 옵션에 대한 설명서를 참조하세요. |
KeyFile |
선택적 String 매개 변수입니다.어셈블리에 서명하기 위한 키 쌍 또는 공개 키를 포함하는 파일을 지정합니다. 컴파일러는 퍼블릭 키를 어셈블리 매니페스트에 삽입한 다음 프라이빗 키를 사용하여 최종 어셈블리에 서명합니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /keyf[ile] 옵션에 대한 설명서를 참조하세요. |
LinkResources |
선택적 ITaskItem[] 매개 변수입니다.지정한 리소스 파일을 어셈블리에 연결합니다. 리소스가 어셈블리의 일부가 되지만 파일은 복사되지 않습니다. 이 매개 변수에 전달된 항목에는 LogicalName, Target 및 Access라는 선택적 메타데이터가 연결될 수 있습니다. LogicalName 메타데이터는 리소스에 대한 내부 식별자를 지정하는 데 사용됩니다. Target 메타데이터는 작업이 파일을 복사하는 경로 및 파일 이름을 지정할 수 있습니다. 그런 후에 이 새 파일을 어셈블리로 컴파일합니다. 해당 리소스가 다른 어셈블리에 표시되지 않게 하려면 Access 메타데이터를 private로 설정할 수 있습니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /link[resource] 옵션에 대한 설명서를 참조하세요. |
MainEntryPoint |
선택적 String 매개 변수입니다.모듈을 실행 파일로 변환할 때 진입점으로 사용할 메서드의 정규화된 이름(class.method)을 지정합니다. 이 매개 변수는 Al.exe(어셈블리 링커)의 /main 옵션에 해당합니다. |
OutputAssembly |
필수 ITaskItem 출력 매개 변수입니다. 이 작업에서 생성한 파일의 이름을 지정합니다. 이 매개 변수는 Al.exe(어셈블리 링커)의 /out 옵션에 해당합니다. |
Platform |
선택적 String 매개 변수입니다.이 코드를 실행할 수 있는 플랫폼을 제한하며, x86, Itanium, x64 또는 anycpu 중 하나여야 합니다. 기본값은 anycpu입니다. 이 매개 변수는 Al.exe(어셈블리 링커)의 /platform 옵션에 해당합니다. |
ProductName |
선택적 String 매개 변수입니다.어셈블리의 Product 필드에 대한 문자열을 지정합니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /prod[uct] 옵션에 대한 설명서를 참조하세요. |
ProductVersion |
선택적 String 매개 변수입니다.어셈블리의 ProductVersion 필드에 대한 문자열을 지정합니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /productv[ersion] 옵션에 대한 설명서를 참조하세요. |
ResponseFiles |
선택적 String[] 매개 변수입니다.어셈블리 링커를 통과하기 위한 추가 옵션을 포함하는 응답 파일을 지정합니다. |
SdkToolsPath |
선택적 String 매개 변수입니다.resgen.exe와 같은 SDK 도구에 대한 경로를 지정합니다. |
SourceModules |
선택적 ITaskItem[] 매개 변수입니다.어셈블리로 컴파일할 하나 이상의 모듈입니다. 모듈은 결과 어셈블리의 매니페스트에 나열되며 어셈블리가 로드되기 위해 여전히 분산되고 사용 가능해야 합니다. 이 매개 변수로 전달된 항목은 작업이 파일을 복사하는 경로 및 파일 이름을 지정하는 Target이라는 추가 메타데이터를 포함할 수 있습니다. 작업은 파일을 복사한 후에 이 새 파일을 어셈블리로 컴파일합니다. 자세한 내용은 Al.exe(어셈블리 링커)에 대한 설명서를 참조하세요. 이 매개 변수는 특정 스위치 없이 Al.exe로 전달되는 모듈 목록에 해당합니다. |
TargetType |
선택적 String 매개 변수입니다.출력 파일의 파일 형식 즉, library(코드 라이브러리), exe(콘솔 애플리케이션) 또는 win(Windows 기반 애플리케이션)을 지정합니다. 기본값은 library입니다. 이 매개 변수는 Al.exe(어셈블리 링커)의 /t[arget] 옵션에 해당합니다. |
TemplateFile |
선택적 String 매개 변수입니다.culture 필드를 제외한 모든 어셈블리 메타데이터를 상속받을 상위 어셈블리를 지정합니다. 지정된 어셈블리에는 강력한 이름이 있어야 합니다. TemplateFile 매개 변수를 사용하여 만든 어셈블리는 위성 어셈블리가 됩니다. 이 매개 변수는 Al.exe(어셈블리 링커)의 /template 옵션에 해당합니다. |
Timeout |
선택적 Int32 매개 변수입니다.작업 실행 파일이 얼마 후에 종료될 지를 밀리초 단위로 지정합니다. 기본값은 시간 제한이 없음을 나타내는 Int.MaxValue입니다. |
Title |
선택적 String 매개 변수입니다.어셈블리의 Title 필드에 대한 문자열을 지정합니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /title 옵션에 대한 설명서를 참조하세요. |
ToolPath |
선택적 String 매개 변수입니다.작업에서 내부 실행 파일(Al.exe)을 로드할 위치를 지정합니다. 이 매개 변수를 지정하지 않으면 작업에서는 MSBuild를 실행하고 있는 프레임워크 버전에 해당하는 SDK 설치 경로가 사용됩니다. |
Trademark |
선택적 String 매개 변수입니다.어셈블리의 Trademark 필드에 대한 문자열을 지정합니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /trade[mark] 옵션에 대한 설명서를 참조하세요. |
Version |
선택적 String 매개 변수입니다.이 어셈블리의 버전 정보를 지정합니다. 문자열의 형식은 major.minor.build.revision입니다. 기본값은 0입니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /v[ersion] 옵션에 대한 설명서를 참조하세요. |
Win32Icon |
선택적 String 매개 변수입니다..ico 파일을 어셈블리에 삽입합니다. .ico 파일을 사용하면 파일 탐색기에서 출력 파일을 원하는 모양으로 나타납니다. 이 매개 변수는 Al.exe(어셈블리 링커)의 /win32icon 옵션에 해당합니다. |
Win32Resource |
선택적 String 매개 변수입니다.Win32 리소스(.res 파일)를 출력 파일에 삽입합니다. 자세한 내용은 Al.exe(어셈블리 링커)의 /win32res 옵션에 대한 설명서를 참조하세요. |
ToolTaskExtension 매개 변수
이 작업은 Task 클래스에서 상속되는 ToolTask 클래스에서 상속되는 ToolTaskExtension 클래스에서 상속됩니다. 이 상속 체인은 매개 변수에서 파생되는 작업에 해당 매개 변수 몇 개를 추가합니다.
다음 표에서는 기본 클래스의 매개 변수에 대해 설명합니다.
| 매개 변수 | Description |
|---|---|
| EchoOff | 선택적 bool 매개 변수입니다.true로 설정된 경우 이 작업은 명령줄이 stdout으로 복사되지 않도록 /Q를 cmd.exe 명령줄로 전달합니다. |
| 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 매개 변수입니다.작업에서 내부 실행 파일을 로드할 위치를 지정합니다. 이 매개 변수를 지정하지 않으면 작업에서는 MSBuild를 실행하고 있는 프레임워크 버전에 해당하는 SDK 설치 경로가 사용됩니다. |
| 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>