MSIX 패키지 번들Bundle MSIX packages

이 문서에서는 MSIX 패키징 도구를 사용하여 Windows 설치 관리자의 x86 및 x64 버전을 변환한 후 번들을 만드는 과정에 대해 설명합니다.This article describes the process of creating a bundle after converting x86 and x64 versions of your Windows installers using the MSIX Packaging Tool.

설치 관리자의 여러 아키텍처 버전을 하나의 엔터티 번들로 묶으면 Store 또는 다른 배포 위치로 번들만 업로드하면 됩니다.By bundling the multiple architecture versions of your installer into one entity, only the bundle needs to be uploaded to the Store or another distribution location. Windows 10 배포 플랫폼은 .msixbundle 패키지 형식을 인식하고 디바이스의 아키텍처에 해당하는 파일만 다운로드합니다.The Windows 10 deployment platform is aware of the .msixbundle package type and will only download the files that are applicable for your device's architecture. 특정 앱에 .msixbundle을 배포하려는 경우 MSIX 패키지만 배포하도록 되돌릴 수 없습니다.Keep in mind that if you decide to distribute an .msixbundle for a particular app, you cannot revert back to distributing just an MSIX package.

다음 섹션에서는.msixbundle을 빌드하는 단계별 접근 방법을 소개하고 있습니다.The following section presents a step-by-step approach to build an .msixbundle. 이미 Windows 설치 관리자의 기존 x86 및 x64 버전을 MSIX 패키지로 변환했다고 가정합니다.It assumes that you have already converted your existing x86 and x64 versions of the Windows installer to MSIX packages.

설치 프로그램Setup

MSIX 번들을 성공적으로 빌드하려면 다음 단계를 따라야 합니다.You will need the following setup to successfully build an MSIX bundle:

  • Windows 10 SDK(버전1809 이상)Windows 10 SDK (version 1809 or above)
  • 변환된 x64 및 x86 MSIX 패키지Converted x64 and x86 MSIX packages

1 단계: MakeAppx.exe 찾기Step 1: Find MakeAppx.exe

MakeAppx.exe는 Windows 10 SDK에서 사용할 수 있는 도구로 MSIX 패키지의 패키징 및 번들로 묶기가 가능합니다.MakeAppx.exe is a tool available in the Windows 10 SDK that allows for packaging and bundling of MSIX packages. 이 도구를 사용하여 두 개의 MSIX 패키지를 함께 번들로 묶습니다.You will use this tool to bundle the two MSIX packages together.

MakeAppx.exe를 사용하여 Windows 10 앱 패키지 또는 번들의 파일 내용을 추출할 수 있으며,MakeAppx.exe can be used to extract the file contents of a Windows 10 app package or bundle. 앱 패키지와 번들을 암호화하고 암호 해독하기도 합니다.It also encrypts and decrypts app packages and bundles.

Windows 10 SDK가 설치되면 MakeAppx.exe는 일반적으로 다음 경로에 있습니다.After the Windows 10 SDK is installed, MakeAppx.exe is usually found here:

  • [x86] - C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x86\MakeAppx.exe[x86] - C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x86\MakeAppx.exe
  • [x64] - C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x64\MakeAppx.exe[x64] - C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x64\MakeAppx.exe

2 단계: 패키지 번들Step 2: Bundle the packages

MakeApp.exe를 사용하여 패키지를 번들로 묶는 가장 쉬운 방법은 하나의 폴더에 함께 번들로 묶으려는 패키지를 모두 추가하는 것입니다.The easiest way to bundle packages with MakeApp.exe is to add all the packages that you want to bundle together in one folder. 디렉터리에는 번들로 묶을 패키지를 제외하고 다른 어떤 것도 없어야 합니다.The directory must be free of everything else except the packages that been to be bundled.

하나의 디렉터리에 번들로 묶으려는 앱 패키지를 옮깁니다(아래 스크린샷 참조).Move the app packages that you want to bundle into one directory, as shown in the following screenshot.

디렉터리의 패키지를 번들로 묶기

참고

MakeAppx.exe는 ID가 동일한 패키지만 번들로 묶습니다. 즉, AppID, 게시자 및 버전이 같아야 합니다.MakeAppx.exe only bundles packages that have the same identity, which means that the AppID, publisher, version needs to be the same. 애플리케이션 패키지에 대한 패키지 프로세서 아키텍처만 다를 수 있습니다.Only the package processor architecture for an application package can be different.

MakeAppx.exe에는 다음 명령줄 구문이 있습니다.MakeAppx.exe has the following command line syntax.

C:\> "C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x86\MakeAppx.exe" bundle /d input_directorypath 
/p <filepath>.msixbundle

다음은 명령 예제입니다.Here is an example command.

C:\> "C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x86\MakeAppx.exe" bundle /d c:\AppPackages\ 
/p c:\MyLOBApp_10.0.0.0_ph32m9x8skttmg.msixbundle

명령을 실행한 후에는 지정된 경로에 서명되지 않은 .msixbundle이 생성됩니다.After running the command, an unsigned .msixbundle will be created in the path specified. 번들로 묶기 전에는 패키지에 서명할 필요가 없습니다.Packages do not need to be signed before bundling.

3 단계: 번들 서명Step 3: Sign the bundle

번들을 만든 후에는 패키지에 서명해야 사용자에게 앱을 배포하거나 설치할 수 있습니다.After you create the bundle, you must sign the package before you can distribute the app to your users or install it.

패키지에 서명하려면 일반 코드 서명 인증서가 필요하며 Windows 10 SDK의 SignTool.exe를 사용해야 합니다.To sign a package, you will need a general code signing certificate and use SignTool.exe from the Windows 10 SDK.

최종 사용자 디바이스에 패키지를 원활하게 배포할 수 있도록 인증 기관의 신뢰할 수 있는 인증서를 사용하는 것이 좋습니다.We strongly recommend that you use a trusted cert from certificate authority as that allows for the package to be distributed and deployed on your end users devices seamlessly. 프라이빗 인증서(.pfx 파일)에 대한 액세스 권한이 있으면 아래와 같이 패키지에 서명할 수 있습니다.Once you have access to the private certificate (.pfx file), you can sign the package as shown below.

참고

SignTool.exe는 Windows 10 SDK의 MakeAppx.exe와 동일한 디렉터리에서 사용할 수 있습니다.SignTool.exe is available in the same directory as MakeAppx.exe in the Windows 10 SDK.

SignTool.exe에는 다음 명령줄 구문이 있습니다.SignTool.exe has the following command line syntax.

C:\> "C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x86\SignTool.exe" sign /fd <Hash Algorithm> /a 
/f <Path to Certificate>.pfx /p <Your Password> <File path>.msixbundle

다음은 명령 예제입니다.Here is an example command.

C:\> "C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x86\SignTool.exe" sign /fd SHA256 /a 
/f c:\private-cert.pfx /p aaabbb123 c:\MyLOBApp_10.0.0.0_ph32m9x8skttmg.msixbundle

SignTool.exe를 사용하여 앱 패키지에 서명하는 방법에 대한 자세한 내용은 이 문서를 참조하세요.For more information about signing app packages with SignTool.exe, see this article.

번들에 성공적으로 서명한 후 네트워크 공유 또는 모든 콘텐츠 배포 네트워크에서 이 번들을 호스팅하여 사용자에게 배포할 수 있습니다.After successfully signing the bundle, you are ready to host it on a network share or on any content distribution network to distribute it to your users.