다음을 통해 공유

GenerateBootstrapper 작업

애플리케이션 및 필수 구성 요소를 검색, 다운로드 및 설치하는 자동화된 방법을 제공합니다. 애플리케이션을 구성하는 모든 구성 요소에 대해 별도의 설치 관리자를 통합하는 단일 설치 관리자 역할을 합니다.

작업 매개 변수

다음은 작업의 매개 변수에 대해 설명합니다 GenerateBootstrapper .

  • ApplicationFile

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

    모든 필수 구성 요소가 설치된 후 부트스트래퍼가 애플리케이션 설치를 시작하는 데 사용할 파일을 지정합니다. 매개 변수나 ApplicationFile 매개 변수를 BootstrapperItems 지정하지 않으면 빌드 오류가 발생합니다.

  • ApplicationName

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

    부트스트래퍼가 설치할 애플리케이션의 이름을 지정합니다. 이 이름은 부트스트래퍼가 설치하는 동안 사용하는 UI에 표시됩니다.

  • ApplicationRequiresElevation

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

    이 경우 true구성 요소는 대상 컴퓨터에 설치될 때 상승된 권한으로 실행됩니다.

  • ApplicationUrl

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

    애플리케이션의 설치 관리자를 호스팅하는 웹 위치를 지정합니다.

  • BootstrapperComponentFiles

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

    부트스트래퍼 패키지 파일의 빌드된 위치를 지정합니다.

  • BootstrapperItems

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

    부트스트래퍼에 빌드할 제품을 지정합니다. 이 매개 변수에 전달된 항목에는 다음 구문이 있어야 합니다.

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

    이 특성은 Include 설치해야 하는 필수 구성 요소의 이름을 나타냅니다. 항목 메타데이터는 ProductName 선택 사항이며 패키지를 찾을 수 없는 경우 빌드 엔진에서 사용자 친화적인 이름으로 사용됩니다. 이러한 항목은 지정되지 않는 한 ApplicationFile MSBuild 입력 매개 변수가 필요하지 않습니다. 애플리케이션에 설치해야 하는 모든 필수 구성 요소에 대해 하나의 항목을 포함해야 합니다.

    매개 변수나 ApplicationFile 매개 변수를 BootstrapperItems 지정하지 않으면 빌드 오류가 발생합니다.

  • BootstrapperKeyFile

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

    setup.exe 기본 제공 위치를 지정합니다.

  • ComponentsLocation

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

    부트스트래퍼가 설치할 설치 필수 구성 요소를 찾을 위치를 지정합니다. 이 매개 변수에는 다음 값이 있을 수 있습니다.

    • HomeSite: 필수 구성 요소가 구성 요소 공급업체에서 호스팅되고 있음을 나타냅니다.

    • Relative: 필수 구성 요소가 애플리케이션의 동일한 위치에 있음을 나타냅니다.

    • Absolute: 모든 구성 요소가 중앙 URL에서 찾을 수 있음을 나타냅니다. 이 값은 입력 매개 변수와 함께 ComponentsUrl 사용해야 합니다.

      지정 HomeSite 하지 않으면 ComponentsLocation 기본적으로 사용됩니다.

  • ComponentsUrl

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

    설치 필수 구성 요소가 포함된 URL을 지정합니다.

  • CopyComponents

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

    이 경우 true부트스트래퍼는 모든 출력 파일을 매개 변수에 지정된 경로에 OutputPath 복사합니다. 매개 변수의 BootstrapperComponentFiles 값은 모두 이 경로를 기반으로 해야 합니다. 파일이 복사되지 않고 값이 BootstrapperComponentFiles 매개 변수 값을 기반으로 하는 Path 경우 false 이 매개 변수의 기본값은 .입니다 true.

  • Culture

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

    부트스트래퍼 UI 및 설치 필수 구성 요소에 사용할 문화권을 지정합니다. 지정한 문화권을 사용할 수 없는 경우 작업은 매개 변수 값을 FallbackCulture 사용합니다.

  • FallbackCulture

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

    부트스트래퍼 UI 및 설치 필수 구성 요소에 사용할 보조 문화권을 지정합니다.

  • OutputPath

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

    setup.exe 모든 패키지 파일을 복사할 위치를 지정합니다.

  • Path

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

    사용 가능한 모든 필수 구성 요소 패키지의 위치를 지정합니다.

  • SupportUrl

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

    부트스트래퍼 설치가 실패할 경우 제공할 URL을 지정합니다.

  • Validate

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

    이 경우 true부트스트래퍼는 지정된 입력 부트스트래퍼 항목에 대해 XSD 유효성 검사를 수행합니다. 이 매개 변수의 기본값은 .입니다 false.

비고

위에 나열된 매개 변수 외에도 이 작업은 클래스에서 매개 변수를 TaskExtension 상속하며, 이 매개 변수는 클래스에서 Task 상속됩니다. 이러한 추가 매개 변수 및 해당 설명 목록은 TaskExtension 기본 클래스를 참조하세요.

Example

다음 예제에서는 태스크를 GenerateBootstrapper 사용하여 필수 구성 요소로 .NET Framework 4.8이 설치되어 있어야 하는 애플리케이션을 설치합니다.

<ItemGroup>
  <BootstrapperFile Include="Microsoft.Net.Framework.4.8">
    <ProductName>.NET Framework 4.8</ProductName>
  </BootstrapperFile>
</ItemGroup>

<Target Name="CustomBootstrapper">
  <GenerateBootstrapper
    ApplicationFile="MyApp.exe"
    BootstrapperItems="@(BootstrapperFile)"
    OutputPath="$(OutputPath)"
    ComponentsLocation="Relative" />
</Target>

참고하십시오

  • Last updated on