GenerateBootstrapper 작업GenerateBootstrapper Task

응용 프로그램과 해당 필수 조건을 검색, 다운로드, 설치할 수 있는 자동화된 방법을 제공합니다.Provides an automated way to detect, download, and install an application and its prerequisites. 이 작업은 응용 프로그램을 구성하는 모든 구성 요소에 대한 개별 설치 관리자를 통합하는 단일 설치 관리자로 사용됩니다.It serves as a single installer that integrates the separate installers for all the components making up an application.

작업 매개 변수Task Parameters

다음 표에서는 GenerateBootstrapper 작업의 매개 변수에 대해 설명합니다.The following table describes the parameters of the GenerateBootstrapper task.

  • ApplicationFile

    선택적 String 매개 변수입니다.Optional String parameter.

    모든 필수 조건이 설치된 후 부트스트래퍼가 응용 프로그램의 설치를 시작하는 데 사용할 파일을 지정합니다.Specifies the file the bootstrapper will use to begin the installation of the application after all prerequisites have been installed. BootstrapperItemsApplicationFile 매개 변수를 둘 다 지정하지 않으면 빌드 오류가 발생합니다.A build error will result if neither the BootstrapperItems nor the ApplicationFile parameter is specified.

  • ApplicationName

    선택적 String 매개 변수입니다.Optional String parameter.

    부트스트래퍼가 설치할 응용 프로그램의 이름을 지정합니다.Specifies the name of the application that the bootstrapper will install. 이 이름은 설치 중에 부트스트래퍼가 사용하는 UI에 표시됩니다.This name will appear in the UI the bootstrapper uses during installation.

  • ApplicationRequiresElevation

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 구성 요소는 대상 컴퓨터에 설치될 때 관리자 권한으로 실행됩니다.If true, the component runs with elevated permissions when it is installed on a target computer.

  • ApplicationUrl

    선택적 String 매개 변수입니다.Optional String parameter.

    응용 프로그램의 설치 관리자를 호스트 중인 웹 위치를 지정합니다.Specifies the Web location that is hosting the application's installer.

  • BootstrapperComponentFiles

    선택적 String[] 출력 매개 변수입니다.Optional String[] output parameter.

    부트스트래퍼 패키지 파일의 빌드된 위치를 지정합니다.Specifies the built location of bootstrapper package files.

  • BootstrapperItems

    선택적 ITaskItem[] 매개 변수입니다.Optional ITaskItem[] parameter.

    부트스트래퍼에 빌드할 제품을 지정합니다.Specifies the products to build into the bootstrapper. 이 매개 변수에 전달된 항목에는 다음 구문이 포함되어야 합니다.The items passed to this parameter should have the following syntax:

    <BootstrapperItem  
        Include="ProductCode">  
        <ProductName>  
            ProductName  
        </ProductName>  
    </BootstrapperItem>  
    

    Include 특성은 설치해야 하는 필수 조건의 이름을 나타내는 데 사용됩니다.The Include attribute is used to represent the name of a prerequisite which should be installed. ProductName 항목 메타데이터는 선택 사항이고, 패키지를 찾을 수 없는 경우 빌드 엔진에서 사용자에게 친숙한 이름으로 사용됩니다.The ProductName item metadata is optional, and will be used by the build engine as a user-friendly name in case the package cannot be found. ApplicationFile을 지정할 경우에만 이러한 항목이 필수 MSBuildMSBuild 입력 매개 변수입니다.These items are not required MSBuildMSBuild input parameters unless no ApplicationFile is specified. 응용 프로그램용으로 설치되어야 하는 필수 조건별로 하나의 항목을 포함해야 합니다.You should include one item for every prerequisite which must be installed for your application.

    BootstrapperItemsApplicationFile 매개 변수를 둘 다 지정하지 않으면 빌드 오류가 발생합니다.A build error will result if neither the BootstrapperItems nor the ApplicationFile parameter is specified.

  • BootstrapperKeyFile

    선택적 String 출력 매개 변수입니다.Optional String output parameter.

    setup.exe의 빌드 위치를 지정합니다.Specifies the built location of setup.exe

  • ComponentsLocation

    선택적 String 매개 변수입니다.Optional String parameter.

    설치할 설치 필수 조건을 검색할 부트스트래퍼의 위치를 지정합니다.Specifies a location for the bootstrapper to look for installation prerequisites to install. 이 매개 변수는 다음 값 중 하나를 가질 수 있습니다.This parameter can have the following values::

    • HomeSite: 필수 조건이 구성 요소 공급업체에서 호스트되고 있음을 나타냅니다.HomeSite: Indicates that the prerequisite is being hosted by the component vendor.

    • Relative: 필수 조건이 응용 프로그램의 같은 위치에 있음을 나타냅니다.Relative: Indicates that the preqrequisite is at the same location of the application.

    • Absolute: 모든 구성 요소를 중앙 URL에서 찾을 수 있음을 나타냅니다.Absolute: Indicates that all components are to be found at a centralized URL. 이 값은 ComponentsUrl 입력 매개 변수와 함께 사용해야 합니다.This value should be used in conjunction with the ComponentsUrl input parameter.

      ComponentsLocation을 지정하지 않으면 기본적으로 HomeSite가 사용됩니다.If ComponentsLocation is not specified, HomeSite is used by default.

  • ComponentsUrl

    선택적 String 매개 변수입니다.Optional String parameter.

    설치 필수 조건을 포함하는 URL을 지정합니다.Specifies the URL containing the installation prerequisites.

  • CopyComponents

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 부트스트래퍼가 모든 출력 파일을 OutputPath 매개 변수에서 지정된 경로에 복사합니다.If true, the bootstrapper copies all output files to the path specified in the OutputPath parameter. BootstrapperComponentFiles 매개 변수 값은 모두 이 경로에 기반을 둡니다.The values of the BootstrapperComponentFiles parameter should all be based on this path. false인 경우 파일이 복사되지 않고 BootstrapperComponentFiles 값은 Path 매개 변수 값에 기반을 둡니다.If false, the files are not copied, and the BootstrapperComponentFiles values are based on the value of the Path parameter. 이 매개 변수의 기본값은 true입니다.The default value of this parameter is true.

  • Culture

    선택적 String 매개 변수입니다.Optional String parameter.

    부트스트래퍼 UI 및 설치 필수 조건에 사용할 문화권을 지정합니다.Specifies the culture to use for the bootstrapper UI and installation prerequisites. 지정된 문화권을 사용할 수 없는 경우 작업에는 FallbackCulture 매개 변수 값이 사용됩니다.If the specified culture is unavailabe, the task uses the value of the FallbackCulture parameter.

  • FallbackCulture

    선택적 String 매개 변수입니다.Optional String parameter.

    부트스트래퍼 UI 및 설치 필수 조건에 사용할 보조 문화권을 지정합니다.Specifies the secondary culture to use for the bootstraper UI and installation prerequisites.

  • OutputPath

    선택적 String 매개 변수입니다.Optional String parameter.

    setup.exe 및 모든 패키지 파일을 복사할 위치를 지정합니다.Specifies the location to copy setup.exe and all package files.

  • Path

    선택적 String 매개 변수입니다.Optional String parameter.

    사용 가능한 모든 필수 조건 패키지의 위치를 지정합니다.Specifies the location of all available prerequisite packages.

  • SupportUrl

    선택적 String 매개 변수입니다.Optional String parameter.

    부트스트래퍼 설치가 실패할 경우 제공할 URL을 지정합니다.Specifies the URL to provide should the bootstrapper installation fail

  • Validate

    선택적 Boolean 매개 변수입니다.Optional Boolean parameter.

    true인 경우 부트스트래퍼가 지정된 입력 부트스트래퍼 항목에 대해 XSD 유효성 검사를 수행합니다.If true, the bootstrapper performs XSD validation on the specified input bootstrapper items. 이 매개 변수의 기본값은 false입니다.The default value of this parameter is false.

설명Remarks

이 작업은 위에 나와 있는 매개 변수 외에 Task 클래스에서 직접 상속하는 TaskExtension 클래스의 매개 변수도 상속합니다.In addition to the parameters listed above, this task inherits parameters from the TaskExtension class, which itself inherits from the Task class. 이러한 추가 매개 변수 및 해당 설명이 포함된 목록은 TaskExtension Base Class를 참조하세요.For a list of these additional parameters and their descriptions, see TaskExtension Base Class.

예제Example

다음 예제에서는 GenerateBootstrapper 작업을 사용하여 .NET Framework 2.0.NET Framework 2.0가 필수 조건으로 설치되어야 하는 응용 프로그램을 설치합니다.The following example uses the GenerateBootstrapper task to install an application that must have the .NET Framework 2.0.NET Framework 2.0 installed as a prerequisite.

<Project xmlns="http://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>  

참고 항목See Also

작업 Tasks
작업 참조Task Reference