CLI 실행 파일을 MSIX로 패키징

이 가이드에서는 Windows Package Manager(winget), Microsoft Store 또는 직접 배포를 통해 배포할 MSIX 패키지로 기존 명령줄 실행 파일을 패키징하는 방법을 안내합니다.

필수 조건

  • 패키지하려는 기존 CLI 실행 파일(.exe)
  • Windows 10 버전 1809 이상

단계

1. CLI 애플리케이션 구성

CLI 실행 파일 및 모든 종속성을 전용 폴더에 배치합니다.

mkdir MyCliPackage
cd MyCliPackage
# Copy your CLI executable and dependencies here

2. winapp CLI 설치

winget install microsoft.winappcli --source winget

3. appxmanifest.xml 생성

winapp manifest generate --executable .\yourcli.exe

그러면 실행 파일에서 기본값이 채워진 파일이 만들어집니다 appxmanifest.xml .

4. 매니페스트 구성

생성된 appxmanifest.xml 별칭을 편집하여 실행 별칭을 추가하고, 시작 메뉴에서 앱을 숨기고, 애플리케이션 세부 정보를 업데이트합니다.

4.1 필수 네임스페이스 추가

요소에 uap5 네임스페이스를 추가합니다.Package

<Package
  xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
  ...
  xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
  xmlns:uap5="http://schemas.microsoft.com/appx/manifest/uap/windows10/5"
  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
  IgnorableNamespaces="uap uap5 rescap">

4.2 시작 메뉴에서 숨기기

<uap:VisualElements> 요소에 AppListEntry="none"을/를 추가합니다.

<uap:VisualElements
    DisplayName="YourApp"
    Description="My Application"
    BackgroundColor="transparent"
    Square150x150Logo="Assets\Square150x150Logo.png"
    Square44x44Logo="Assets\Square44x44Logo.png"
    AppListEntry="none">
</uap:VisualElements>

4.3 실행 별칭 추가

요소 내에 확장을 추가합니다.<Application>

<Extensions>
  <uap5:Extension Category="windows.appExecutionAlias">
    <uap5:AppExecutionAlias>
      <uap5:ExecutionAlias Alias="yourcli.exe" />
    </uap5:AppExecutionAlias>
  </uap5:Extension>
</Extensions>

원하는 명령어로 yourcli.exe를 대체하십시오.

4.4 애플리케이션 메타데이터 업데이트

CLI 애플리케이션과 일치하도록 Identity, Properties, 및 VisualElements 섹션을 업데이트합니다.

5. 개발 인증서 생성(선택 사항)

Microsoft Store 외부의 로컬 테스트 및 배포:

cd ~
winapp cert generate
winapp cert install

중요합니다

개발 인증서를 패키지에 실수로 포함하지 않도록 CLI 실행 파일이 포함된 폴더 외부에 보관합니다.

6. CLI(명령줄 인터페이스) 패키지하기

winapp pack .\MyCliPackage --cert path\to\devcert.pfx

그러면 현재 디렉터리에 파일이 만들어집니다 .msix .

팁 (조언)

  • Microsoft Store에서 MSIX에 서명합니다. 제출하기 전에 서명할 필요가 없습니다.
  • 지원하는 각 아키텍처(x64, Arm64)에 대해 별도의 MSIX 패키지가 필요할 수 있습니다.
  • Last updated on