Mengemas CLI yang dapat dieksekusi sebagai MSIX

Panduan ini memandu Anda mengemas executable baris perintah yang ada sebagai paket MSIX untuk distribusi melalui Windows Package Manager (winget), Microsoft Store, atau distribusi langsung.

Prasyarat

  • Anda ingin mengemas executable CLI yang sudah ada (.exe)
  • Windows 10 versi 1809 atau yang lebih baru

Steps

1. Atur aplikasi CLI Anda

Tempatkan CLI Anda yang dapat dieksekusi dan dependensi apa pun di folder khusus:

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

2. Instal winapp CLI

winget install microsoft.winappcli --source winget

3. Hasilkan appxmanifest.xml

winapp manifest generate --executable .\yourcli.exe

Ini membuat file appxmanifest.xml dengan nilai default yang diambil dari executable Anda.

4. Mengonfigurasi manifes

Sunting file appxmanifest.xml yang dihasilkan untuk menambahkan alias eksekusi, menyembunyikan aplikasi dari Menu Mulai, dan memperbarui detail aplikasi.

4.1 Menambahkan namespace yang diperlukan

uap5 Tambahkan namespace ke Package elemen :

<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 Sembunyikan dari menu Mulai

<uap:VisualElements> Dalam elemen , tambahkan 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 Menambahkan alias eksekusi

Tambahkan ekstensi dalam <Application> elemen :

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

Ganti yourcli.exe dengan nama perintah yang diinginkan untuk CLI Anda.

4.4 Memperbarui metadata aplikasi

Perbarui bagian Identity, Properties, dan VisualElements agar sesuai dengan aplikasi CLI Anda.

5. Hasilkan sertifikat pengembangan (opsional)

Untuk pengujian dan distribusi lokal di luar Microsoft Store:

cd ~
winapp cert generate
winapp cert install

Penting

Simpan sertifikat pengembangan Anda di luar folder yang berisi CLI Anda yang dapat dieksekusi untuk menghindari secara tidak sengaja menyertakannya dalam paket.

6. Paketkan CLI Anda

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

Ini membuat .msix file di direktori saat ini.

Tip

  • Microsoft Store menandatangani MSIX untuk Anda, tidak perlu menandatangani sebelum pengiriman.
  • Anda mungkin memerlukan paket MSIX terpisah untuk setiap arsitektur yang Anda dukung (x64, Arm64).
  • Last updated on