Udostępnij za pośrednictwem

Opakowywanie pliku wykonywalnego CLI jako MSIX

Ten przewodnik przeprowadzi Cię przez proces pakowania istniejącego pliku wykonywalnego wiersza polecenia jako pakietu MSIX do dystrybucji za pośrednictwem systemu Windows Package Manager (winget), Sklepu Microsoft lub dystrybucji bezpośredniej.

Wymagania wstępne

  • Istniejący plik wykonywalny interfejsu wiersza polecenia (.exe), który chcesz spakować
  • Windows 10 w wersji 1809 lub nowszej

Kroki

1. Zorganizuj swoją aplikację CLI (interfejsu wiersza polecenia)

Umieść plik wykonywalny interfejsu wiersza polecenia (CLI) i wszystkie zależności w dedykowanym folderze.

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

2. Instalowanie interfejsu wiersza polecenia winapp

winget install microsoft.winappcli --source winget

3. Generowanie appxmanifest.xml

winapp manifest generate --executable .\yourcli.exe

Spowoduje to utworzenie pliku appxmanifest.xml z wartościami domyślnymi pochodzącymi z pliku wykonywalnego.

4. Konfigurowanie manifestu

Edytuj wygenerowany appxmanifest.xml element, aby dodać alias wykonawczy, ukryć aplikację w menu Start i zaktualizować informacje o aplikacji.

4.1. Dodaj wymaganą przestrzeń nazw

Dodaj przestrzeń nazw uap5 do elementu 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 Ukryj z menu Start

W elemencie <uap:VisualElements> dodaj 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 Dodawanie aliasu uruchamiania

Dodaj rozszerzenie w elemecie <Application> :

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

Zastąp yourcli.exe odpowiednią nazwą polecenia dla CLI.

4.4 Aktualizowanie metadanych aplikacji

Zaktualizuj sekcje Identity, Properties i VisualElements, aby pasowały do twojej aplikacji CLI.

5. Generowanie certyfikatu programistycznego (opcjonalnie)

Na potrzeby lokalnego testowania i dystrybucji poza sklepem Microsoft Store:

cd ~
winapp cert generate
winapp cert install

Ważna

Przechowuj certyfikat rozwoju poza folderem zawierającym plik wykonywalny CLI, aby uniknąć przypadkowego dołączania go do pakietu.

6. Opakuj interfejs wiersza polecenia

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

Spowoduje to utworzenie .msix pliku w bieżącym katalogu.

Wskazówka

  • Sklep Microsoft Store podpisuje plik MSIX, dlatego nie trzeba się podpisywać przed przesłaniem.
  • Może być konieczne oddzielne pakiety MSIX dla każdej obsługiwanej architektury (x64, Arm64).
  • Last updated on