CLI yürütülebilir dosyasını MSIX olarak paketleme

Bu kılavuz, mevcut komut satırı yürütülebilir dosyasını Windows Package Manager (winget), Microsoft Store veya doğrudan dağıtım aracılığıyla dağıtım için MSIX paketi olarak paketleme konusunda size yol gösterir.

Önkoşullar

  • Paketlemek istediğiniz mevcut bir CLI yürütülebilir dosyası (.exe)
  • Windows 10 sürüm 1809 veya üzeri

Adımlar

1. CLI uygulamanızı düzenleme

CLI yürütülebilir dosyanızı ve bağımlılıklarınızı ayrılmış bir klasöre yerleştirin:

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

2. winapp CLI'yi yükleme

winget install microsoft.winappcli --source winget

3. appxmanifest.xml oluşturma

winapp manifest generate --executable .\yourcli.exe

Bu, yürütülebilir dosyanızdan doldurulan varsayılan değerlere sahip bir appxmanifest.xml dosya oluşturur.

4. Bildirimi yapılandırma

Çalıştırma takma adı eklemek, uygulamayı Başlat menüsünden gizlemek ve uygulama ayrıntılarını güncelleştirmek için oluşturulan appxmanifest.xml öğesini düzenleyin.

4.1 Gerekli ad alanını ekleme

Ad alanını uap5Package öğesine ekleyin:

<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 Başlat menüsünden gizle

<uap:VisualElements> öğesine ekleyinAppListEntry="none":

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

Çalıştırma takma adı ekle

öğesinin içine uzantıyı <Application> ekleyin:

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

yourcli.exe değerini CLI'nız için istenen komut adıyla değiştirin.

4.4 Uygulama meta verilerini güncelleştirme

Identity, Propertiesve VisualElements bölümlerini CLI uygulamanızla eşleşecek şekilde güncelleştirin.

5. Geliştirme sertifikası oluşturma (isteğe bağlı)

Microsoft Store dışında yerel test ve dağıtım için:

cd ~
winapp cert generate
winapp cert install

Önemli

Yanlışlıkla pakete eklemekten kaçınmak için geliştirme sertifikanızı CLI yürütülebilir dosyanızı içeren klasörün dışında tutun.

6. CLI'nızı paketleme

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

Bu, geçerli dizinde bir .msix dosya oluşturur.

Tavsiye

  • Microsoft Store MSIX'i sizin için imzalar, göndermeden önce imzalamanız gerekmez.
  • Desteklediğiniz her mimari (x64, Arm64) için ayrı MSIX paketlerine ihtiyacınız olabilir.
  • Last updated on