desktop6:CustomInstall

아티클
10/30/2023

데스크톱 애플리케이션에서 데스크톱 애플리케이션과 함께 설치된 하나 이상의 추가 설치 관리자 파일(.exe 또는 .msi)을 지정할 수 있습니다. 예를 들어 타사 재배포 가능 구성 요소를 번들로 묶는 앱에 유용합니다.

참고

이 요소는 현재 Microsoft와 파트너가 게시한 특정 유형의 데스크톱 PC 게임에서만 사용할 수 있습니다. customInstallActions제한된 기능이 필요합니다.

요소 계층 구조

<패키지>

<확장>

<desktop6:Extension>

<desktop6:CustomInstall>

Syntax

<desktop6:CustomInstall
  Folder = 'A string with a value between 1 and 256 characters in length that cannot contain these characters: <, >, :, ", |, ?, or *.' 
  desktop8:RunAsUser = 'An optional boolean value.'>

  <!-- Child elements -->
  desktop6:InstallActions
  desktop6:RepairActions
  desktop6:UninstallActions?

</desktop6:CustomInstall>

키

? 선택 사항(0개 또는 1개)

특성 및 요소

특성

attribute	Description	데이터 형식	필수	기본값
폴더	모든 사용자 지정 작업에 필요한 모든 파일을 포함하는 패키지 폴더의 이름입니다. 이 폴더에는 하위 폴더가 포함될 수 있습니다.	, 또는 문자를 포함할 수 없는 길이가 1~256자`<":\|>?`인 문자열입니다.`*`	Yes

자식 요소

자식 요소	Description
InstallActions	데스크톱 애플리케이션을 처음 시작하기 전에 실행되는 설치 관리자 파일을 지정합니다.
RepairActions	사용자가 데스크톱 애플리케이션의 설정 페이지에서 복구 또는 다시 설정 옵션을 선택할 때 실행되는 설치 관리자 파일을 지정합니다.
UninstallActions	사용자가 데스크톱 애플리케이션을 제거할 때 실행되는 설치 관리자 파일을 지정합니다.

부모 요소

부모 요소	Description
desktop6:Extension	데스크톱 애플리케이션에 대한 확장 지점을 선언합니다.
desktop8:RunAsUser	작업을 현재 사용자로 실행해야 하는지 여부를 나타냅니다.

설명

이 요소에는 customInstallActions제한된 기능이 필요합니다.

OS는 desktop6:InstallAction, desktop6:RepairAction 및 desktop6 :UninstallAction 요소의 특성을 사용하여 Name 관련 설치, 복구 및 제거 작업 집합을 식별합니다. 서로 함께 실행되어야 하는 관련 작업 집합을 지정하려면 특성 값이 동일한 Name 지 확인합니다. OS는 해당 설치 또는 복구 작업이 실행된 경우에만 제거 작업을 실행합니다.

예제

<Package
  xmlns:desktop6="http://schemas.microsoft.com/appx/manifest/desktop/windows10/6"
  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
  IgnorableNamespaces="rescap desktop6">

  <!-- ... -->
  <!-- Other entries omitted for brevity. -->
  <!-- ... -->

  <Extensions>
    <desktop6:Extension Category="windows.customInstall">
      <desktop6:CustomInstall Folder="MyInstallers">
        <desktop6:InstallActions>
          <desktop6:InstallAction File="Setup_AntiCheat.exe" Name="AC_1" Arguments="/add /silent" />
        </desktop6:InstallActions>
        <desktop6:RepairActions>
          <desktop6:RepairAction File="Setup_AntiCheat.exe" Name="AC_1" Arguments="/add /silent /force" />
        </desktop6:RepairActions>
        <desktop6:UninstallActions>
          <desktop6:UninstallAction File="Setup_AntiCheat.exe" Name="AC_1" Arguments="/remove /silent" />
        </desktop6:UninstallActions>
      </desktop6:CustomInstall>
    </desktop6:Extension>
  </Extensions>

  <Capabilities>
    <rescap:Capability Name="customInstallActions"/>
  </Capabilities>
</Package>

요구 사항

항목	값
네임스페이스	`http://schemas.microsoft.com/appx/manifest/desktop/windows10/6`
Minimum OS Version	Windows 10 버전 1903(빌드 18362)

Share via