Condividi tramite

Creazione del pacchetto di un eseguibile dell'interfaccia della riga di comando come MSIX

Questa guida ti guida su come impacchettare un eseguibile della riga di comando esistente come pacchetto MSIX per la distribuzione tramite Windows Package Manager (winget), Microsoft Store o direttamente.

Prerequisiti

  • Eseguibile esistente dell'interfaccia della riga di comando (.exe) che si desidera confezionare
  • Windows 10 versione 1809 o successiva

Steps

1. Organizzare l'applicazione CLI

Inserire l'eseguibile CLI e tutte le dipendenze in una cartella dedicata:

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

2. Installare il CLI di winapp

winget install microsoft.winappcli --source winget

3. Generare il appxmanifest.xml

winapp manifest generate --executable .\yourcli.exe

Verrà creato un appxmanifest.xml file con valori predefiniti popolati dal file eseguibile.

4. Configurare il manifesto

Modificare l'oggetto generato appxmanifest.xml per aggiungere un alias di esecuzione, nascondere l'app dal menu Start e aggiornare i dettagli dell'applicazione.

4.1 Aggiungere lo spazio dei nomi obbligatorio

Aggiungere il uap5 spazio dei nomi all'elemento 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 Nascondi dal menu Start

Nell'elemento <uap:VisualElements> aggiungere 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 Aggiungere l'alias di esecuzione

Aggiungere l'estensione all'interno dell'elemento <Application> :

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

Sostituire yourcli.exe con il nome del comando desiderato per la CLI.

4.4 Aggiornare i metadati dell'applicazione

Aggiorna le sezioni Identity, Properties e VisualElements in modo che corrispondano all'applicazione CLI.

5. Generare un certificato di sviluppo (facoltativo)

Per i test e la distribuzione locali all'esterno di Microsoft Store:

cd ~
winapp cert generate
winapp cert install

Importante

Mantenere il certificato di sviluppo all'esterno della cartella contenente l'eseguibile dell'interfaccia della riga di comando per evitare di includerlo accidentalmente nel pacchetto.

6. Pacchettizzare la tua CLI

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

Verrà creato un .msix file nella directory corrente.

Suggerimento

  • Microsoft Store firma MSIX per te, non è necessario firmare prima dell'invio.
  • Potrebbero essere necessari pacchetti MSIX separati per ogni architettura supportata (x64, Arm64).
  • Last updated on