MakeAppx.exe를 사용하여 MSIX 패키지 또는 번들 만들기

MakeAppx.exe 는 앱 패키지(.msix 또는 .appx) 및 앱 패키지 번들(.msixbundle 또는 .appxbundle)을 모두 만듭니다. 또한 MakeAppx.exe 는 앱 패키지 또는 번들에서 파일을 추출하고 앱 패키지 및 번들을 암호화하거나 암호 해독합니다. 이 도구는 Windows 10 SDK에 포함되어 있으며 명령 프롬프트 또는 스크립트 파일에서 사용할 수 있습니다.

MakeApp.exe를 사용하여 데스크톱 앱을 패키지하는 방법에 대한 자세한 내용은 데스크톱 앱 패키지를 수동으로 참조하세요.

MakeAppx.exe 사용

SDK의 설치 경로에 따라 MakeAppx.exe가 Windows 10 PC에 있는 위치입니다.

• C:\Program Files (x86)\Windows Kits\10\bin\<build number>\<architecture>\makeappx.exe

여기서 <아키텍처> 는 x86, x64, arm, arm64 또는 chpe입니다. 또는 다음 위치에 있을 수 있습니다.

• C:\Program Files (x86)\Windows Kits\10\App Certification Kit\makeappx.exe

MakeAppx.exe 구문 및 옵션

일반 MakeAppx.exe 구문:

MakeAppx <command> [options]      

다음 표에서는 MakeAppx.exe에 대한 명령을 설명합니다.

이 옵션 목록은 모든 명령에 적용됩니다.

다음 목록에는 가능한 인수가 포함되어 있습니다.

앱 패키지 만들기

앱 패키지는 .msix 또는 .appx 패키지 파일에 패키지된 앱 파일의 전체 집합입니다. pack 명령을 사용하여 앱 패키지를 만들려면 패키지 위치에 대한 콘텐츠 디렉터리 또는 매핑 파일을 제공해야 합니다. 패키지를 만드는 동안 암호화할 수도 있습니다. 패키지를 암호화하려면 /ep를 사용하고 키 파일(/kf) 또는 전역 테스트 키(/kt)를 사용하는지 지정해야 합니다. 암호화된 패키지를 만드는 방법에 대한 자세한 내용은 패키지 또는 번들 암호화 또는 암호 해독을 참조 하세요.

pack 명령과 관련된 옵션:

다음 사용 예제에서는 pack 명령에 대한 몇 가지 가능한 구문 옵션을 보여 줍니다.

MakeAppx pack [options] /d <content directory> /p <output package name>
MakeAppx pack [options] /f <mapping file> /p <output package name>
MakeAppx pack [options] /m <app package manifest> /f <mapping file> /p <output package name>
MakeAppx pack [options] /r /m <app package manifest> /f <mapping file> /p <output package name>
MakeAppx pack [options] /d <content directory> /ep <encrypted output package name> /kf <key file>
MakeAppx pack [options] /d <content directory> /ep <encrypted output package name> /kt

다음은 pack 명령에 대한 명령줄 예제를 보여 줍니다.

MakeAppx pack /v /h SHA256 /d "C:\My Files" /p MyPackage.msix
MakeAppx pack /v /o /f MyMapping.txt /p MyPackage.msix
MakeAppx pack /m "MyApp\AppxManifest.xml" /f MyMapping.txt /p AppPackage.msix
MakeAppx pack /r /m "MyApp\AppxManifest.xml" /f MyMapping.txt /p ResourcePackage.msix
MakeAppx pack /v /h SHA256 /d "C:\My Files" /ep MyPackage.emsix /kf MyKeyFile.txt
MakeAppx pack /v /h SHA256 /d "C:\My Files" /ep MyPackage.emsix /kt

앱 번들 만들기

앱 번들은 앱 패키지와 비슷하지만 번들은 사용자가 다운로드하는 앱의 크기를 줄일 수 있습니다. 앱 번들은 언어별 자산, 다양한 이미지 크기 조정 자산 또는 특정 버전의 Microsoft DirectX에 적용되는 리소스에 유용합니다. 암호화된 앱 패키지를 만드는 것과 마찬가지로 묶는 동안 앱 번들을 암호화할 수도 있습니다. 앱 번들을 암호화하려면 /ep 옵션을 사용하고 키 파일(/kf) 또는 전역 테스트 키(/kt)를 사용하는지 여부를 지정합니다. 암호화된 번들을 만드는 방법에 대한 자세한 내용은 패키지 또는 번들 암호화 또는 암호 해독을 참조 하세요.

번들 명령과 관련된 옵션:

번들 버전이 지정되지 않았거나 "0.0.0.0"으로 설정된 경우 현재 날짜-시간을 사용하여 번들이 만들어집니다.

다음 사용 예제에서는 번들 명령에 대한 몇 가지 가능한 구문 옵션을 보여 줍니다.

MakeAppx bundle [options] /d <content directory> /p <output bundle name>
MakeAppx bundle [options] /f <mapping file> /p <output bundle name>
MakeAppx bundle [options] /d <content directory> /ep <encrypted output bundle name> /kf MyKeyFile.txt
MakeAppx bundle [options] /f <mapping file> /ep <encrypted output bundle name> /kt

다음 블록에는 번들 명령에 대한 예제가 포함되어 있습니다 .

MakeAppx bundle /v /d "C:\My Files" /p MyBundle.msixbundle
MakeAppx bundle /v /o /bv 1.0.1.2096 /f MyMapping.txt /p MyBundle.msixbundle
MakeAppx bundle /v /o /bv 1.0.1.2096 /f MyMapping.txt /ep MyBundle.emsixbundle /kf MyKeyFile.txt
MakeAppx bundle /v /o /bv 1.0.1.2096 /f MyMapping.txt /ep MyBundle.emsixbundle /kt

패키지 또는 번들에서 파일 추출

MakeAppx.exe는 앱 패키징 및 번들링 외에도 기존 패키지의 압축을 풀거나 풀 수 있습니다. 추출된 파일의 대상으로 콘텐츠 디렉터리를 제공해야 합니다. 암호화된 패키지 또는 번들에서 파일을 추출하려는 경우 /ep 옵션을 사용하여 파일의 암호를 해독하고, 키 파일(/kf) 또는 전역 테스트 키(/kt)를 사용하여 암호 해독할지 여부를 지정하는 동시에 파일을 해독하고 추출할 수 있습니다. 패키지 또는 번들 암호 해독에 대한 자세한 내용은 패키지 또는 번들 암호화 또는 암호 해독을 참조 하세요.

명령 압축 풀기 및 언버들 해제와 관련된 옵션:

다음 사용 예제에서는 unpack 및 unbundle 명령에 대한 몇 가지 가능한 구문 옵션을 보여 줍니다.

MakeAppx unpack [options] /p <input package name> /d <output directory>
MakeAppx unpack [options] /ep <encrypted input package name> /d <output directory> /kf <key file>
MakeAppx unpack [options] /ep <encrypted input package name> /d <output directory> /kt

MakeAppx unbundle [options] /p <input bundle name> /d <output directory>
MakeAppx unbundle [options] /ep <encrypted input bundle name> /d <output directory> /kf <key file>
MakeAppx unbundle [options] /ep <encrypted input bundle name> /d <output directory> /kt

다음 블록에는 unpack 및 unbundle 명령을 사용하는 예제가 포함되어 있습니다.

MakeAppx unpack /v /p MyPackage.msix /d "C:\My Files"
MakeAppx unpack /v /ep MyPackage.emsix /d "C:\My Files" /kf MyKeyFile.txt
MakeAppx unpack /v /ep MyPackage.emsix /d "C:\My Files" /kt

MakeAppx unbundle /v /p MyBundle.msixbundle /d "C:\My Files"
MakeAppx unbundle /v /ep MyBundle.emsixbundle /d "C:\My Files" /kf MyKeyFile.txt
MakeAppx unbundle /v /ep MyBundle.emsixbundle /d "C:\My Files" /kt

패키지 또는 번들 암호화 또는 암호 해독

MakeAppx.exe 도구는 기존 패키지 또는 번들을 암호화하거나 암호 해독할 수도 있습니다. 패키지 이름, 출력 패키지 이름 및 암호화 또는 암호 해독에서 키 파일(/kf) 또는 전역 테스트 키(/kt)를 사용해야 하는지 여부를 제공해야 합니다.

암호화 및 암호 해독은 Visual Studio 패키징 마법사를 통해 사용할 수 없습니다.

명령 암호화 및 암호 해독과 관련된 옵션:

다음 사용 예제에서는 암호화 및 암호 해독 명령에 대한 몇 가지 가능한 구문 옵션을 보여 줍니다.

MakeAppx encrypt [options] /p <package name> /ep <output package name> /kf <key file>
MakeAppx encrypt [options] /p <package name> /ep <output package name> /kt

MakeAppx decrypt [options] /ep <package name> /p <output package name> /kf <key file>
MakeAppx decrypt [options] /ep <package name> /p <output package name> /kt

다음 블록에는 암호화 및 암호 해독 명령을 사용하는 예제가 포함되어 있습니다.

MakeAppx.exe encrypt /p MyPackage.msix /ep MyEncryptedPackage.emsix /kt
MakeAppx.exe encrypt /p MyPackage.msix /ep MyEncryptedPackage.emsix /kf MyKeyFile.txt

MakeAppx.exe decrypt /p MyPackage.msix /ep MyEncryptedPackage.emsix /kt
MakeAppx.exe decrypt p MyPackage.msix /ep MyEncryptedPackage.emsix /kf MyKeyFile.txt

키 파일

키 파일은 "[Keys]" 문자열이 포함된 줄과 각 패키지를 암호화할 키를 설명하는 줄로 시작해야 합니다. 각 키는 따옴표로 된 문자열 쌍으로 표시되며 공백이나 탭으로 구분됩니다. 첫 번째 문자열은 base64로 인코딩된 32 바이트 키 ID를 나타내고 두 번째 문자열은 base64로 인코딩된 32 바이트 암호화 키를 나타냅니다. 키 파일은 간단한 텍스트 파일이어야 합니다.

키 파일의 예:

[Keys]
"OWVwSzliRGY1VWt1ODk4N1Q4R2Vqc04zMzIzNnlUREU="    "MjNFTlFhZGRGZEY2YnVxMTBocjd6THdOdk9pZkpvelc="

파일 매핑

매핑 파일은 "[Files]" 문자열이 포함된 줄과 패키지에 추가할 파일을 설명하는 줄로 시작해야 합니다. 각 파일은 공백 또는 탭으로 구분된 따옴표로 된 경로 쌍으로 설명됩니다. 각 파일은 원본(디스크) 및 대상(패키지 내)을 나타냅니다. 매핑 파일은 간단한 텍스트 파일이어야 합니다.

매핑 파일의 예(/m 옵션 제외):

[Files]
"C:\MyApp\StartPage.html"               "default.html"
"C:\Program Files (x86)\example.txt"    "misc\example.txt"
"\\MyServer\path\icon.png"              "icon.png"
"my app files\readme.txt"               "my app files\readme.txt"
"CustomManifest.xml"                    "AppxManifest.xml"

매핑 파일을 사용하는 경우 /m 옵션을 사용할지 여부를 선택할 수 있습니다. /m 옵션을 사용하면 사용자가 생성된 매니페스트에 포함할 매핑 파일의 리소스 메타데이터를 지정할 수 있습니다. /m 옵션을 사용하는 경우 매핑 파일에 "[ResourceMetadata]" 줄로 시작하는 섹션과 "ResourceDimensions" 및 "ResourceId"를 지정하는 줄이 있어야 합니다. 앱 패키지에 여러 "ResourceDimensions"가 포함될 수 있지만 "ResourceId"는 하나만 있을 수 있습니다.

매핑 파일의 예(/m 옵션 사용):

[ResourceMetadata]
"ResourceDimensions"                    "language-en-us"
"ResourceId"                            "English"

[Files]
"images\en-us\logo.png"                 "en-us\logo.png"
"en-us.pri"                             "resources.pri"

MakeAppx.exe에서 수행하는 의미 체계 유효성 검사

MakeAppx.exe 는 가장 일반적인 배포 오류를 catch하고 앱 패키지가 유효한지 확인하는 데 도움이 되도록 설계된 제한된 수식 유효성 검사를 수행합니다. MakeAppx.exe를 사용하는 동안 유효성 검사를 건너뛰려면 /nv 옵션을 참조하세요.

이 유효성 검사는 다음을 보장합니다.

• 패키지 매니페스트에서 참조되는 모든 파일은 앱 패키지에 포함됩니다.
• 애플리케이션에는 두 개의 동일한 키가 없습니다.
• 애플리케이션은 SMB, FILE, MS-WWA-WEB, MS-WWA 목록에서 사용할 수 없는 프로토콜을 등록하지 않습니다.

일반적인 오류만 catch하도록 설계되어 있으므로 완전한 의미 체계 유효성 검사는 아닙니다. MakeAppx.exe에서 빌드된 패키지는 설치 가능하지 않습니다.