GenerateBootstrapper 작업
응용 프로그램과 해당 필수 구성 요소를 검색, 다운로드 및 설치하는 자동화된 방법을 제공합니다. 응용 프로그램을 구성하는 모든 구성 요소에 대한 별도의 설치 관리자를 통합하는 단일 설치 관리자로 사용됩니다.
작업 매개 변수
다음 표에서는 GenerateBootstrapper 작업의 매개 변수에 대해 설명합니다.
Parameter |
설명 |
|---|---|
ApplicationFile |
선택적 String 매개 변수입니다. 모든 필수 구성 요소가 설치된 후 부트스트래퍼에서 응용 프로그램 설치를 시작하기 위해 사용할 파일을 지정합니다. BootstrapperItems 및 ApplicationFile 매개 변수를 모두 지정하지 않으면 빌드 오류가 발생합니다. |
ApplicationName |
선택적 String 매개 변수입니다. 부트스트래퍼에서 설치할 응용 프로그램 이름을 지정합니다. 설치하는 동안 부트스트래퍼에서 사용하는 UI에 이 이름이 표시됩니다. |
ApplicationRequiresElevation |
선택적 Boolean 매개 변수입니다. true인 경우 대상 컴퓨터에 구성 요소가 설치되어 있으면 설치한 구성 요소를 고급 권한으로 실행합니다. |
ApplicationUrl |
선택적 String 매개 변수입니다. 응용 프로그램 설치 관리자를 호스팅하고 있는 웹 위치를 지정합니다. |
BootstrapperComponentFiles |
선택적 String[] 출력 매개 변수입니다. 부트스트래퍼 패키지 파일의 빌드 위치를 지정합니다. |
BootstrapperItems |
선택적 ITaskItem[] 매개 변수입니다. 부트스트래퍼에 빌드할 제품을 지정합니다. 이 매개 변수에 전달된 항목은 다음 구문을 따라야 합니다. Include 특성은 설치해야 하는 필수 구성 요소의 이름을 나타내는 데 사용됩니다. ProductName 항목 메타데이터는 선택 사항이며, 패키지를 찾을 수 없는 경우에 사용자에게 친숙한 이름으로 빌드 엔진에서 사용됩니다. ApplicationFile을 지정하지 않는 경우, 이 항목에는 MSBuild 입력 매개 변수가 필요하지 않습니다. 응용 프로그램에 설치해야 하는 각 필수 구성 요소마다 하나의 항목을 포함해야 합니다. BootstrapperItems 및 ApplicationFile 매개 변수를 모두 지정하지 않으면 빌드 오류가 발생합니다. |
BootstrapperKeyFile |
선택적 String 출력 매개 변수입니다. setup.exe의 빌드 위치를 지정합니다. |
ComponentsLocation |
선택적 String 매개 변수입니다. 부트스트래퍼에서 설치할 설치 필수 구성 요소를 찾을 위치를 지정합니다. 이 매개 변수는 다음 값을 가질 수 있습니다.
ComponentsLocation이 지정되지 않은 경우, 기본적으로 HomeSite가 사용됩니다. |
ComponentsUrl |
선택적 String 매개 변수입니다. 설치 필수 구성 요소를 포함하는 URL을 지정합니다. |
CopyComponents |
선택적 Boolean 매개 변수입니다. true인 경우, 부트스트래퍼에서 모든 출력 파일을 OutputPath 매개 변수에 지정된 경로로 복사합니다. BootstrapperComponentFiles 매개 변수 값은 모두 이 경로를 기준으로 해야 합니다. false인 경우, 파일이 복사되지 않으며 BootstrapperComponentFiles 값은 Path 매개 변수 값을 기준으로 합니다. 이 매개 변수의 기본값은 true입니다. |
Culture |
선택적 String 매개 변수입니다. 부트스트래퍼 UI와 설치 필수 구성 요소에서 사용할 culture를 지정합니다. 지정된 culture를 사용할 수 없는 경우, 작업에서는 FallbackCulture 매개 변수 값을 사용합니다. |
FallbackCulture |
선택적 String 매개 변수입니다. 부트스트래퍼 UI와 설치 필수 구성 요소에서 사용할 보조 culture를 지정합니다. |
OutputPath |
선택적 String 매개 변수입니다. setup.exe와 모든 패키지 파일을 복사할 위치를 지정합니다. |
Path |
선택적 String 매개 변수입니다. 사용 가능한 모든 필수 구성 요소 패키지의 위치를 지정합니다. |
SupportUrl |
선택적 String 매개 변수입니다. 부트스트래퍼 설치가 실패할 경우 제공할 URL을 지정합니다. |
Validate |
선택적 Boolean 매개 변수입니다. true인 경우, 부트스트래퍼에서 지정된 입력 부트스트래퍼 항목에 대해 XSD 유효성 검사를 수행합니다. 이 매개 변수의 기본값은 false입니다. |
설명
위에 나열된 매개 변수 외에도 이 작업은 Task 클래스에서 상속하는 TaskExtension 클래스의 매개 변수를 상속합니다. 추가 매개 변수 목록과 해당 설명은 TaskExtension 기본 클래스를 참조하십시오.
예제
다음 예제에서는 GenerateBootstrapper 작업을 사용하여 .NET Framework 2.0이 필수 구성 요소로 설치되어야 하는 응용 프로그램을 설치합니다.
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<BootstrapperFile Include="Microsoft.Net.Framework.2.0">
<ProductName>Microsoft .NET Framework 2.0</ProductName>
</BootstrapperFile>
</ItemGroup>
<Target Name="BuildBootstrapper">
<GenerateBootstrapper
ApplicationFile="WindowsApplication1.application"
ApplicationName="WindowsApplication1"
ApplicationUrl="http://mycomputer"
BootstrapperItems="@(BootstrapperFile)"
OutputPath="C:\output" />
</Target>
</Project>