Freigeben über

Verpacken eines ausführbaren Kommandozeilenprogramms (CLI) als MSIX

Dieser Leitfaden führt Sie durch das Verpacken einer vorhandenen ausführbaren Befehlszeile als MSIX-Paket für die Verteilung über Windows Package Manager (Winget), den Microsoft Store oder die direkte Verteilung.

Voraussetzungen

  • Eine vorhandene ausführbare CLI -Datei (.exe), die Sie packen möchten
  • Windows 10 Version 1809 oder höher

Schritte

1. Organisieren Ihrer CLI-Anwendung

Platzieren Sie die ausführbare Befehlszeilenschnittstelle und alle Abhängigkeiten in einem dedizierten Ordner:

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

2. Installieren der winapp CLI

winget install microsoft.winappcli --source winget

3. Generieren Sie die appxmanifest.xml

winapp manifest generate --executable .\yourcli.exe

Dadurch wird eine appxmanifest.xml-Datei erstellt, die mit Standardwerten aus Ihrer ausführbaren Datei gefüllt ist.

4. Konfigurieren des Manifests

Bearbeiten Sie das generierte appxmanifest.xml, um einen Ausführungsalias hinzuzufügen, die App im Startmenü auszublenden und die Anwendungsdetails zu aktualisieren.

4.1 Hinzufügen des erforderlichen Namespaces

Fügen Sie dem uap5 Element den Package Namespace hinzu:

<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 Im Startmenü ausblenden

Fügen Sie im <uap:VisualElements> Element Folgendes hinzu 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 Hinzufügen von Ausführungsalias

Fügen Sie die Erweiterung innerhalb des <Application> Elements hinzu:

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

Ersetzen Sie yourcli.exe durch den gewünschten Befehlsnamen für Ihre CLI.

4.4 Aktualisieren von Anwendungsmetadaten

Aktualisieren Sie die Abschnitte Identity, Properties und VisualElements, damit sie Ihrer CLI-Anwendung entsprechen.

5. Generieren eines Entwicklungszertifikats (optional)

Für lokale Tests und Verteilung außerhalb des Microsoft Store:

cd ~
winapp cert generate
winapp cert install

Von Bedeutung

Bewahren Sie Das Entwicklungszertifikat außerhalb des Ordners auf, der Die ausführbare Datei ihrer CLI enthält, um zu vermeiden, dass es versehentlich in das Paket eingeschlossen wird.

6. Packen Sie Ihre CLI

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

Dadurch wird eine .msix Datei im aktuellen Verzeichnis erstellt.

Tipp

  • Der Microsoft Store signiert das MSIX für Sie, sodass Sie es nicht vor der Übermittlung signieren müssen.
  • Möglicherweise benötigen Sie separate MSIX-Pakete für jede architektur, die Sie unterstützen (x64, Arm64).
  • Last updated on