사용자 지정 앱 설치 관리자 환경을 만드는 방법

아티클
10/21/2023

참고 항목

이 앱 설치 관리자 기능은 일시적으로 롤백되었으며 지금은 작동하지 않습니다. 이 기능을 다시 가져올 계획이므로 나중에 다시 검사 추가 업데이트를 받으세요.

앱 설치 관리자 앱은 MSIX 애플리케이션을 설치하는 모든 사용자에게 일관된 환경을 제공하는 모든 MSIX 설치에 사용됩니다. 이 일관성은 좋지만 개발자가 사용자에게 제공하는 설치 환경을 사용자 지정할 수 있는 기능도 제공하고자 합니다. 이 기능은 Windows 10 1709 이상에서 사용할 수 있습니다.

사용자 지정 MSIXAppInstallerData.xml 파일 만들기

앱 설치 관리자 환경을 사용자 지정해야 하는 첫 번째 작업은 사용자 지정 xml 파일입니다. 고유한 설치 관리자 환경을 만들기 위해 앱 설치 관리자 UX의 여러 기능을 사용자 지정할 수 있습니다. 파일 이름을 MSIXAppInstallerData.xml로 저장해야 합니다.

사용자 지정에 사용할 수 있는 매개 변수 목록은 다음과 같습니다.

앱 설치 관리자 UX 설정	설명
UX::AccentColor	앱 설치 관리자의 테마 컬러를 변경하는 16진수 코드
UX::FontFamily	글꼴 패밀리
UX::AllowUserInteraction	부울입니다. true이면 사용자는 '준비되면 시작' 검사box(기본적으로 검사)를 볼 수 있으며 설치를 취소하는 옵션이 있습니다.
UX::BackgroundColor	앱 설치 관리자의 배경색을 변경하는 16진수 코드
UX::AppNameInTitle	부울입니다. true이면 앱 이름이 설치 관리자 창 제목에 표시됩니다.
HyperLinkFontSize	하이퍼 링크 글꼴 크기입니다.
아이콘::HorizontalAlignment	창 내의 아이콘 맞춤입니다. 왼쪽, 가운데, 오른쪽
아이콘::로고	아이콘 위치에 연결
아이콘::TopMarging	아이콘의 위쪽에서 애플리케이션 창의 위쪽까지의 여백입니다.
단추::HorizontalAlignment	창 내의 단추 맞춤입니다. 왼쪽, 가운데, 오른쪽
Buttons::Text	설치 단추에 추가할 추가 텍스트
Buttons::IsSecondaryButtonAccent	부울입니다.
LaunchWhenReady::HorizontalAlignment	'준비되면 시작'에 대한 검사 상자의 맞춤입니다. 가운데, 왼쪽.
AppInformation::Mode	추가 정보 표시 형식입니다. 보통, 플라이아웃
하이퍼링크::TopMargin	하이퍼링크와 단추 사이의 여백을 지정합니다.
하이퍼링크::Text	하이퍼링크로 표시할 텍스트
하이퍼링크::Url	링크
하이퍼링크:: HorizontalAlignment	창 내의 하이퍼링크 맞춤입니다. 왼쪽, 가운데, 오른쪽

샘플 xml:


<?xml version="1.0" encoding="utf-8"?> 

<AppInstallerUX xmlns="http://schemas.microsoft.com/msix/appinstallerux"  

xmlns:ux="http://schemas.microsoft.com/msix/appinstallerux" 

xmlns:ux2="http://schemas.microsoft.com/msix/appinstallerux/2" 

IgnorableNamespaces="ux ux2" Version="1.0.0"> 

  <UX AccentColor="#DE781F" FontFamily="Segoe UI" AllowUserInteraction="false" BackgroundColor="#F3F3F3"  

  AppNameInTitle="true"  

  HyperLinkFontSize="12"> 

    <Icon HorizontalAlignment="center" Logo="Images\Contoso96x96.png" TopMargin="70"/> 

    <Buttons HorizontalAlignment="center" Text="Contoso" IsSecondaryButtonAccent="false"/> 

    <LaunchWhenReady HorizontalAlignment="center"/> 

    <AppInformation Mode="flyout" /> 

    <HyperLinks TopMargin="30"> 

      <HyperLink  Text="Terms &amp; conditions" Url="https://support.microsoft.com/" HorizontalAlignment="center"/> 

    </HyperLinks> 

  </UX> 

</AppInstallerUX>

파일을 'MsixAppInstallerData.xml'로 저장합니다.

MSIX 애플리케이션에 xml 파일 추가

MSIX 패키징 도구 사용 – 패키지 편집기

MSIX 패키징 도구에서 패키지 편집기를 사용하여 MSIX 애플리케이션 열기
패키지 파일로 이동하여 'Msix.AppInstaller.Data'라는 패키지 루트 아래에 새 폴더를 추가합니다.
새로 만든 폴더에 MSIXAppInstallerData.xml 파일을 추가합니다.
MSIX 패키지 저장 – 버전을 증가시키고 패키지에 서명해야 합니다.

문제 해결

파일 이름은 MSIXAppInstallerData.xml이어야 합니다.
파일은 MSIXAppInstallerData 폴더에 있어야 합니다.
폴더는 패키지 파일의 패키지 루트 아래에 있어야 합니다.
OS 버전 및 앱 설치 관리자 버전 확인
xml 파일의 유효성을 두 번 검사

다른 문제가 발생하거나 기술 커뮤니티의 MSIX 팀에 연락하는 경우 피드백을 제출하세요.