Condividi tramite

Comandi (MSIX)

Installazione

Passaggio 1: installa .NET Windows Runtime

Se non lo hai già fatto, installa l'ultima versione di .NET 8 Desktop Runtime. Questo è un requisito per eseguire la CLI per sviluppatori di Microsoft Store.

Il modo più semplice per installarlo è utilizzare winget:

winget install Microsoft.DotNet.DesktopRuntime.8

Passaggio 2: Installare l'interfaccia della riga di comando per sviluppatori di Microsoft Store in Windows

Puoi scaricare la CLI per sviluppatori di Microsoft Store da Microsoft Store. In alternativa, puoi utilizzare winget:

winget install "Microsoft Store Developer CLI"

Passaggio 1: installa .NET macOS Runtime

Se non lo hai già fatto, installa l'ultima versione di .NET 8 Runtime. Questo è un requisito per eseguire la CLI per sviluppatori di Microsoft Store.

Passaggio 2: Installare l'interfaccia della riga di comando per sviluppatori di Microsoft Store in macOS

Puoi scaricare .tar.gz macOS per la specifica architettura (x64 o Arm64) dalla pagina delle versioni della CLI per sviluppatori di Microsoft Store. Una volta scaricato, estrai l'archivio e inseriscilo nel tuo PERCORSO, come preferisci, ad esempio:

mkdir MSStoreCLI
curl https://github.com/microsoft/msstore-cli/releases/latest/download/MSStoreCLI-osx-x64.tar.gz -o MSStoreCLI-osx-x64.tar.gz
tar -xvf MSStoreCLI-osx-x64.tar.gz -C ./MSStoreCLI
sudo cp -R MSStoreCLI/. /usr/local/bin

In alternativa, puoi utilizzare brew:

brew install microsoft/msstore-cli/msstore-cli

Passaggio 1: installa .NET Linux Runtime

Se non lo hai già fatto, installa l'ultima versione di .NET 8 Runtime. Questo è un requisito per eseguire la CLI per sviluppatori di Microsoft Store.

Passaggio 2: Installare l'interfaccia della riga di comando per sviluppatori di Microsoft Store in Linux

Puoi scaricare .tar.gz Linux per la specifica architettura (x64 o Arm64) dalla pagina delle versioni della CLI per sviluppatori di Microsoft Store. Una volta scaricato, estrai l'archivio e inseriscilo nel tuo PERCORSO, come preferisci, ad esempio:

mkdir MSStoreCLI
wget https://github.com/microsoft/msstore-cli/releases/latest/download/MSStoreCLI-linux-x64.tar.gz
tar -xvf MSStoreCLI-linux-x64.tar.gz -C ./MSStoreCLI
sudo cp -R MSStoreCLI/. /usr/local/bin

In alternativa, puoi utilizzare brew:

brew install microsoft/msstore-cli/msstore-cli

Comando Info

Stampa la configurazione esistente.

Usage

msstore info

Options

Opzione Descrizione
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Riconfigurare il comando

Riconfigura la CLI per sviluppatori di Microsoft Store. È possibile specificare un segreto client o un certificato. I certificati possono essere forniti tramite l'identificazione personale o fornendo un percorso di file (con o senza password).

Usage

msstore reconfigure

Options

Opzione Descrizione
-t, --tenantId (identificatore del tenant) Specifica l'ID tenant da utilizzare.
-s, --IdVenditore Specifica l'ID venditore da utilizzare.
-c, --clientId Specifica l'ID client da utilizzare.
-cs, --clientSecret Specifica il segreto client da utilizzare.
-ct, --improntaCertificato Specificare l'identificazione personale del certificato da usare.
-cfp, --certificateFilePath Specificare il percorso del file del certificato da usare.
-cp, --certificatePassword (password del certificato) Specificare la password del certificato da usare.
--resettare Reimposta solo le credenziali, senza ricominciare da capo.
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Comando impostazioni

Modifica le impostazioni della CLI per sviluppatori di Microsoft Store.

Usage

msstore settings

Options

Opzione Descrizione
-t, --abilitaTelemetria Abilita (vuoto/vero) o Disabilita (falso) la telemetria.
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

SetPDN Sotto-Comando

Imposta la proprietà Nome visualizzato dell'editore utilizzata dal comando init.

Usage

msstore settings setpdn <publisherDisplayName>

Argomenti

Argomento Descrizione
publisherDisplayName La proprietà Nome visualizzato editore che verrà impostata a livello globale.

Options

Opzione Descrizione
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Comando App

Sotto-comando Descrizione
elenco Elenca tutte le applicazioni nel tuo account.
Ottieni Ottiene i dettagli di un'applicazione specifica.

App - Elenco - Uso

msstore apps list

Options

Opzione Descrizione
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

App - Ottieni - Utilizzo

msstore apps get <productId>

Argomenti

Argomento Descrizione
productId L'ID prodotto del negozio.

Options

Opzione Descrizione
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Comando Invio

Sotto-comando Descrizione
stato Ottiene lo stato di un invio.
Ottieni Ottiene i metadati e le informazioni sul pacchetto di un invio specifico.
getListingAssets Ottiene le risorse dell'elenco di un invio specifico.
updateMetadata Aggiorna i metadati di un invio specifico.
sondaggio Esamina lo stato di un invio.
pubblica Pubblica un invio specifico.
eliminare Elimina un invio specifico.

Invio - Stato - Utilizzo

msstore submission status <productId>

Argomenti

Argomento Descrizione
productId L'ID prodotto del negozio.

Options

Opzione Descrizione
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Invio - Ottieni - Utilizzo

msstore submission get <productId>

Argomenti

Argomento Descrizione
productId L'ID prodotto del negozio.

Options

Opzione Descrizione
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Invio - GetListingAssets - Utilizzo

msstore submission getListingAssets <productId>

Argomenti

Argomento Descrizione
productId L'ID prodotto del negozio.

Options

Opzione Descrizione
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Invio - Aggiorna metadati - Utilizzo

msstore submission updateMetadata <productId> <metadata>

Argomenti

Argomento Descrizione
productId L'ID prodotto del negozio.
metadata Rappresentazione dei metadati JSON aggiornata.

Options

Opzione Descrizione
-s, --skipInitialPolling (salta il sondaggio iniziale) Ignorare il polling iniziale prima di eseguire l'azione. [valore predefinito: Falso]
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Invio - Sondaggio - Utilizzo

msstore submission poll <productId>

Argomenti

Argomento Descrizione
productId L'ID prodotto del negozio.

Options

Opzione Descrizione
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Invio - Pubblicazione - Utilizzo

msstore submission publish <productId>

Argomenti

Argomento Descrizione
productId L'ID prodotto del negozio.

Options

Opzione Descrizione
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Invio - Eliminazione - Utilizzo

msstore submission delete <productId>

Argomenti

Argomento Descrizione
productId L'ID prodotto del negozio.

Options

Opzione Descrizione
--no-confirm Indica che non è richiesta la conferma. [valore predefinito: Falso]
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Comando Init

Il comando init ti aiuta a configurare la tua applicazione per la pubblicazione su Microsoft Store. Attualmente supporta i seguenti tipi di applicazioni:

  • Windows App SDK/WinUI 3
  • UWP (Piattaforma Universale Windows)
  • .NET MAUI
  • Flutter
  • Elettrone
  • React Native per desktop
  • PWA

Esempi di utilizzo

Windows App SDK/WinUI 3

msstore init "C:\path\to\winui3_app"

UWP (Piattaforma Universale Windows)

msstore init "C:\path\to\uwp_app"

.NET MAUI

msstore init "C:\path\to\maui_app"

Flutter

msstore init "C:\path\to\flutter_app"

Elettrone

msstore init "C:\path\to\electron_app"

React Native per desktop

msstore init "C:\path\to\react_native_app"

Nota

Per Electron, nonché React Native per i progetti desktop, sono supportati sia Npm che Yarn . La presenza del Yarn file di blocco (yarn.lock) verrà usata per determinare quale gestione pacchetti usare, quindi assicurarsi di archiviare il file di blocco nel sistema di controllo del codice sorgente.

PWA

msstore init https://contoso.com --output .

Argomenti

Argomento Descrizione
pathOrUrl Il percorso della directory principale in cui si trova il file di progetto o un URL pubblico che punta a una PWA.

Options

Opzione Descrizione
-n, --publisherDisplayName Il nome visualizzato dell'editore utilizzato per configurare l'applicazione. Se fornito, evita una chiamata API aggiuntiva.
--pacchetto Se supportato dal tipo di app, comprime automaticamente il progetto.
--pubblicare Se supportato dal tipo di app, pubblica automaticamente il progetto. Implica '--package true'
-f, --idVolo Specifica l'ID anteprima in cui verrà pubblicato il pacchetto.
-prp, --percentualeDistribuzionePacchetto Specifica la percentuale di implementazione del pacchetto. Il valore deve essere compreso tra 0 e 100.
-a, --arch Le architetture in relazione alle quali creare. Se non fornita, verrà utilizzata l'architettura predefinita per il sistema operativo corrente e il tipo di progetto. Valori consentiti: "x86", "x64", "arm64". Utilizzato solo insieme a '--package true'.
-o, --uscita La directory di output in cui verrà archiviata l'app in pacchetto. Se non fornita, verrà utilizzata la directory predefinita per ogni diverso tipo di app.
-ver, --version La versione utilizzata durante la creazione dell'app. Se non fornita, verrà utilizzata la versione del file di progetto.

Comando Pacchetto

Ti aiuta a creare pacchetti dell'applicazione Microsoft Store come MSIX.

Esempi di utilizzo

Windows App SDK/WinUI 3

msstore package "C:\path\to\winui3_app"

UWP (Piattaforma Universale Windows)

msstore package "C:\path\to\uwp_app"

.NET MAUI

msstore package "C:\path\to\maui_app"

Flutter

msstore package "C:\path\to\flutter_app"

Elettrone

msstore package "C:\path\to\electron_app"

React Native per desktop

msstore package "C:\path\to\react_native_app"

PWA

msstore package "C:\path\to\pwa_app"

Argomenti

Opzione Descrizione
pathOrUrl Il percorso della directory principale in cui si trova il file di progetto o un URL pubblico che punta a una PWA.

Options

Opzione Descrizione
-o, --uscita La directory di output in cui verrà archiviata l'app in pacchetto. Se non fornita, verrà utilizzata la directory predefinita per ogni diverso tipo di app.
-a, --arch Le architetture in relazione alle quali creare. Se non fornita, verrà utilizzata l'architettura predefinita per il sistema operativo corrente e il tipo di progetto. Valori consentiti: "x86", "x64", "arm64".
-ver, --version La versione utilizzata durante la creazione dell'app. Se non fornita, verrà utilizzata la versione del file di progetto.

Comando Publish

Pubblica la tua applicazione su Microsoft Store.

Esempi di utilizzo

Windows App SDK/WinUI 3

msstore publish "C:\path\to\winui3_app"

UWP (Piattaforma Universale Windows)

msstore publish "C:\path\to\uwp_app"

.NET MAUI

msstore publish "C:\path\to\maui_app"

Flutter

msstore publish "C:\path\to\flutter_app"

Elettrone

msstore publish "C:\path\to\electron_app"

React Native per desktop

msstore publish "C:\path\to\react_native_app"

PWA

msstore publish "C:\path\to\pwa_app"

Argomenti

Opzione Descrizione
pathOrUrl Il percorso della directory principale in cui si trova il file di progetto o un URL pubblico che punta a una PWA.

Options

Opzione Descrizione
-i, --inputFile Percorso del file '.msix' o '.msixupload' da usare per il comando di pubblicazione. Se non fornito, la CLI proverà a trovare il miglior candidato in base all'argomento 'pathOrUrl'.
-id, --appId (identificativo applicazione) Specifica l'ID dell'applicazione. Necessario solo se il progetto non è stato inizializzato in precedenza con il comando 'init'.
-nc, --noCommit (nessuna conferma di commit) Disabilita il commit dell'invio, mantenendolo nello stato bozza.
-f, --idVolo Specifica l'ID anteprima in cui verrà pubblicato il pacchetto.
-prp, --percentualeDistribuzionePacchetto Specifica la percentuale di implementazione del pacchetto. Il valore deve essere compreso tra 0 e 100.

Comando Voli

Sotto-comando Descrizione
elenco Recupera tutti i voli per l'applicazione specificata.
Ottieni Recupera un volo per l'applicazione specificata e il volo.
eliminare Elimina un volo per l'applicazione e il volo specificati.
create Crea un flight per l'applicazione e il flight specificati.
presentazione Eseguire invii di progetti e attività correlate all'invio.

Voli - Elenco - Utilizzo

msstore flights list <productId>

Argomenti

Argomento Descrizione
productId ID prodotto.

Options

Opzione Descrizione
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Voli - Ottieni - Utilizzo

msstore flights get <productId> <flightId>

Argomenti

Argomento Descrizione
productId ID prodotto.
flightId ID del volo.

Options

Opzione Descrizione
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --aiuto Mostra le informazioni su aiuto e utilizzo.

Voli - Eliminazione - Utilizzo

msstore flights delete <productId> <flightId>

Argomenti

Argomento Descrizione
productId ID prodotto.
flightId Identificativo del volo.

Options

Opzione Descrizione
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Voli - Crea - Utilizzo

msstore flights create <productId> <friendlyName> --group-ids <group-ids>

Argomenti

Argomento Descrizione
productId ID prodotto.
friendlyName Nome amichevole del volo.

Options

Opzione Descrizione
-g, --group-ids ID gruppi da associare al flight.
-r, --classificare-superiore-a ID del volo da classificare più in alto rispetto a.
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Voli - Invio

Sotto-comando Descrizione
Ottieni Recupera l'invio esistente del pacchetto, cioè la bozza corrente o l'ultima versione pubblicata.
eliminare Elimina l'invio in anteprima del pacchetto in sospeso dallo Store.
aggiornare Aggiorna la bozza di anteprima esistente con il codice JSON fornito.
pubblica Avvia il processo di invio in anteprima per la bozza esistente.
sondaggio Esegue il polling fino a quando l'invio di volo esistente non è pubblicato o non è riuscito.
stato Recupera lo stato corrente dell'invio del flight del negozio.
Implementazione Eseguire operazioni relative al rollout di flight.

Voli - Invio - Ottenere - Utilizzo

msstore flights submission get <productId> <flightId>

Argomenti

Argomento Descrizione
productId ID prodotto.
flightId Identificativo del volo.

Options

Opzione Descrizione
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Voli - Invio - Eliminazione - Utilizzo

msstore flights submission delete <productId> <flightId>

Argomenti

Argomento Descrizione
productId ID prodotto.
flightId Identificativo del volo.

Options

Opzione Descrizione
--no-confirm Indica che non è richiesta la conferma.
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Voli - Invio - Aggiornamento - Utilizzo

msstore flights submission update <productId> <flightId> <product>

Argomenti

Argomento Descrizione
productId ID prodotto.
flightId Identificativo del volo.
product Rappresentazione del prodotto JSON aggiornata.

Options

Opzione Descrizione
-s, --skipInitialPolling (salta il sondaggio iniziale) Ignorare il polling iniziale prima di eseguire l'azione. [valore predefinito: Falso]
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Voli - Invio - Pubblicazione - Utilizzo

msstore flights publish <productId> <flightId>

Argomenti

Argomento Descrizione
productId ID prodotto.
flightId Identificativo del volo.

Options

Opzione Descrizione
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Voli - Invio - Sondaggio - Utilizzo

msstore flights poll <productId> <flightId>

Argomenti

Argomento Descrizione
productId ID prodotto.
flightId Identificativo del volo.

Options

Opzione Descrizione
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Voli - Invio - Stato - Utilizzo

msstore flights status <productId> <flightId>

Argomenti

Argomento Descrizione
productId ID prodotto.
flightId Identificativo del volo.

Options

Opzione Descrizione
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Voli - Invio - Distribuzione

Sotto-comando Descrizione
Ottieni Recupera lo stato del progressivo roll-out di una presentazione.
aggiornare Aggiornare la percentuale di distribuzione di un invio.
Arresto Interrompe il rollout graduale di una sottomissione.
finalizzare Finalizza il rilascio graduale di una consegna.

Voli - Invio - Rilascio - Ottieni - Utilizzo

msstore flights submission rollout get <productId> <flightId>

Argomenti

Argomento Descrizione
productId ID prodotto.
flightId Identificativo del volo.

Options

Opzione Descrizione
-s, --submissionId ID di invio.
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Voli - Invio - Distribuzione - Aggiornamento - Utilizzo

msstore flights submission rollout update <productId> <flightId> <percentage>

Argomenti

Argomento Descrizione
productId ID prodotto.
flightId Identificativo del volo.
percentage Percentuale di utenti che riceveranno la distribuzione dell'invio.

Options

Opzione Descrizione
-s, --submissionId ID di invio.
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Voli - Invio - Implementazione - Interruzione - Utilizzo

msstore flights submission rollout halt <productId> <flightId>

Argomenti

Argomento Descrizione
productId ID prodotto.
flightId Identificativo del volo.

Options

Opzione Descrizione
-s, --submissionId ID di invio.
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Voli - Invio - Distribuzione - Finalizzazione - Utilizzo

msstore flights submission rollout finalize <productId> <flightId>

Argomenti

Argomento Descrizione
productId ID prodotto.
flightId ID di volo.

Options

Opzione Descrizione
-s, --submissionId ID di invio.
-v, --dettagliato Stampa un output dettagliato.
-?, -h, --help Mostra le informazioni su aiuto e utilizzo.

Ambienti CI/CD

La CLI per sviluppatori di Microsoft Store (anteprima) supporta l'esecuzione in ambienti CI/CD. Ciò significa che puoi utilizzare la CLI per sviluppatori di Microsoft Store (anteprima) nelle pipeline CI/CD, ad esempio, per pubblicare automaticamente le tue applicazioni in Microsoft Store.

Il primo passo per raggiungere questo obiettivo è installare la CLI per sviluppatori di Microsoft Store (anteprima) nel tuo ambiente CI/CD. A tale scopo, vedere qui.

Dopo aver installato la CLI per sviluppatori di Microsoft Store (anteprima), devi configurare il tuo ambiente per poter eseguire i comandi. A tale scopo, eseguire il comando con i parametri specifici che identificano l'account msstore reconfigure del Centro per i partner (TenantId, SellerId, ClientId). È anche necessario specificare un ClientSecret o un certificato.

È molto importante nascondere queste credenziali, poiché saranno visibili nei log della pipeline CI/CD. Puoi farlo utilizzando le chiavi private. Ogni sistema di pipeline CI/CD ha nomi diversi per queste chiavi private. Ad esempio, in Azure DevOps sono denominate Variabili segrete, ma invece in GitHub Action sono denominate Segreti crittografati. Creare un segreto per ognuno dei parametri (TenantId, SellerId, ClientId e ClientSecret o certificato) e quindi usare il comando per configurare l'ambientereconfigure.

Ad esempio:

Azure DevOps

- task: UseMSStoreCLI@0
  displayName: Setup Microsoft Store Developer CLI
- script: msstore reconfigure --tenantId $(PARTNER_CENTER_TENANT_ID) --sellerId $(PARTNER_CENTER_SELLER_ID) --clientId $(PARTNER_CENTER_CLIENT_ID) --clientSecret $(PARTNER_CENTER_CLIENT_SECRET)
  displayName: Configure Microsoft Store Developer CLI

Azioni di GitHub

- name: Setup Microsoft Store Developer CLI
  uses: microsoft/microsoft-store-apppublisher@v1.1
- name: Configure Microsoft Store Developer CLI
  run: msstore reconfigure --tenantId ${{ secrets.PARTNER_CENTER_TENANT_ID }} --sellerId ${{ secrets.PARTNER_CENTER_SELLER_ID }} --clientId ${{ secrets.PARTNER_CENTER_CLIENT_ID }} --clientSecret ${{ secrets.PARTNER_CENTER_CLIENT_SECRET }}

Una volta eseguito questo comando, la CLI per sviluppatori di Microsoft Store (anteprima) verrà configurata per utilizzare le credenziali fornite. Ora puoi usare la CLI per sviluppatori di Microsoft Store (anteprima) nella pipeline CI/CD.

  • Last updated on