Installazione
Passaggio 1: Installare .NET Windows Runtime
Se non è già stato fatto, installare la versione più recente di .NET 9 Desktop Runtime. Si tratta di un requisito per eseguire la CLI per sviluppatori di Microsoft Store.
Il modo più semplice per installarlo è utilizzare winget:
winget install Microsoft.DotNet.DesktopRuntime.9
Passaggio 2: Installare l'interfaccia della riga di comando per sviluppatori di Microsoft Store in Windows
È possibile scaricare l'interfaccia della riga di comando di Microsoft Store Developer dalla Microsoft Store. In alternativa, puoi utilizzare winget:
winget install "Microsoft Store Developer CLI"
Passaggio 1: Installare .NET Runtime macOS
Se non l'hai già fatto, installa la versione più recente del .NET 9 Runtime. Si tratta di un requisito per eseguire la CLI per sviluppatori di Microsoft Store.
Passaggio 2: Installare l'interfaccia della riga di comando per sviluppatori Microsoft Store in macOS
È possibile scaricare il file .tar.gz per macOS relativo all'architettura specifica (x64 o Arm64) dalla pagina delle versioni 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: Installare .NET Runtime Linux
Se non l'hai già fatto, installa la versione più recente del .NET 9 Runtime. Si tratta di un requisito per eseguire la CLI per sviluppatori di Microsoft Store.
Passaggio 2: Installare l'interfaccia della riga di comando per sviluppatori Microsoft Store in Linux
È possibile scaricare Linux .tar.gz per l'architettura specifica (x64 o Arm64) dalla pagina dei rilasci del CLI di Microsoft Store Developer. 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, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Riconfigurare l'interfaccia della riga di comando per sviluppatori di Microsoft Store. È possibile specificare un segreto client o un certificato. I certificati possono essere forniti tramite impronta digitale 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 (identificativoCliente) |
Specifica l'ID client da utilizzare. |
| -cs, --clientSecret |
Specifica il segreto client da utilizzare. |
| -ct, --improntaCertificato |
Specificare l'impronta digitale del certificato che deve essere utilizzato. |
| -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, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Comando delle impostazioni
Modificare le impostazioni dell'interfaccia della riga di comando per sviluppatori 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, --aiuto |
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 del Publisher che verrà impostata a livello globale. |
Options
| Opzione |
Descrizione |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Comando Applicazioni
| Sottocomando |
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, --aiuto |
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, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Comando Invio
| Sottocomando |
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 elencate di una sottomissione specifica. |
|
updateMetadata |
Aggiorna i metadati di un invio specifico. |
|
aggiornare |
Aggiorna il pacchetto di un invio specifico. |
|
sondaggio |
Esamina lo stato di un invio. |
|
pubblica |
Pubblica un invio specifico. |
|
eliminare |
Elimina un invio specifico. |
|
Implementazione |
Eseguire operazioni correlate all'implementazione graduale dei pacchetti. |
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, --aiuto |
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, --aiuto |
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, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
msstore submission updateMetadata <productId> <metadata>
Nota
Per le app submission updateMetadata MSIX/in pacchetto e submission update sono equivalenti: entrambi inviano il codice JSON di invio completo restituito da submission get, in modo che entrambi i comandi possano aggiornare elenchi e pacchetti insieme.
I due differiscono solo per le app non in pacchetto (MSI/EXE), in cui l'ID prodotto è un GUID: updateMetadata aggiorna i metadati della presentazione nello Store, mentre update aggiorna i pacchetti.
Argomenti
| Argomento |
Descrizione |
productId |
L'ID prodotto del negozio. |
metadata |
Rappresentazione dei metadati JSON aggiornata. |
Options
| Opzione |
Descrizione |
| -s, --skipInitialPolling (salta il sondaggio iniziale) |
Saltare il polling iniziale prima di eseguire l'azione. [valore predefinito: Falso] |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Invio - Aggiornamento - Utilizzo
msstore submission update <productId> <package>
Argomenti
| Argomento |
Descrizione |
productId |
L'ID prodotto del negozio. |
package |
Rappresentazione JSON aggiornata del pacchetto dell'app. |
Options
| Opzione |
Descrizione |
| -s, --skipInitialPolling (salta il sondaggio iniziale) |
Saltare il polling iniziale prima di eseguire l'azione. [valore predefinito: Falso] |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Suggerimento
Usare submission get per recuperare il codice JSON del pacchetto corrente prima di chiamare submission update. In questo modo è possibile usare la struttura corretta e i valori correnti. Ad esempio, in PowerShell:
# Step 1: Retrieve the current submission package JSON
msstore submission get <productId> | Out-File -Encoding utf8 package.json
# Step 2: Edit package.json to reflect your changes
# Step 3: Pass the updated JSON to submission update
$updatedPackage = Get-Content -Raw package.json
msstore submission update <productId> $updatedPackage
Per altre informazioni di contesto, vedere Pubblicare gli aggiornamenti delle app per Microsoft Store con GitHub Actions.
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, --aiuto |
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, --aiuto |
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, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Invio - Comando di implementazione
Usa questi sottocomandi per gestire una distribuzione graduale del pacchetto per un invio senza distribuzione controllata. Per gestire una distribuzione destinata a un flight di pacchetti, usare invece msstore flights submission rollout.
Questi comandi sono supportati solo per le app MSIX/in pacchetto. Se l'ID invio viene omesso, l'interfaccia della riga di comando usa l'invio in sospeso dell'app, ritornando all'ultima pubblicazione.
| Sottocomando | Descrizione | | -------------------------------------------------------- | -------------------------------------------------- | | get | Recupera lo stato di distribuzione di un invio. | | update | Aggiorna la percentuale di distribuzione di una sottomissione. | | stop | Interrompe l'implementazione di un invio. | | completare | Completa la distribuzione di una sottomissione. |
Nota
È necessario abilitare una distribuzione sull'elemento inviato prima che questi comandi possano agire su di esso. Abilitarlo in fase di pubblicazione con msstore publish --packageRolloutPercentageo impostando packageDeliveryOptions.packageRollout nel codice JSON passato a submission update.
Invio - Distribuzione Utilizzo del comando Get
msstore submission rollout get <productId>
Invio - Argomenti del comando Rollout Get
| Argomento |
Descrizione |
productId |
L'ID prodotto del negozio. |
Invio - Distribuzione delle opzioni del comando Get
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Invio - Guida al comando Get per l'implementazione
msstore submission rollout get --help
Invio - Utilizzo del comando di aggiornamento della distribuzione
msstore submission rollout update <productId> <percentage>
Invio - Argomenti del comando di aggiornamento dell'implementazione
| Argomento |
Descrizione |
productId |
L'ID prodotto del negozio. |
percentage |
Percentuale di utenti che riceveranno la distribuzione graduale dell'invio (0-100). |
Invio - Opzioni del comando di aggiornamento della distribuzione
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Invio - Guida ai comandi di aggiornamento dell'implementazione
msstore submission rollout update --help
Invio - Uso del comando di arresto della distribuzione
msstore submission rollout halt <productId>
Invio - Argomenti del comando di interruzione dell'implementazione
| Argomento |
Descrizione |
productId |
L'ID prodotto del negozio. |
Invio - Opzioni del comando di arresto della distribuzione
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Invio - Guida al comando di arresto della distribuzione
msstore submission rollout halt --help
Invio - Distribuzione - Utilizzo del comando Finalize
msstore submission rollout finalize <productId>
Invio - Implementazione finalizza argomenti di comando
| Argomento |
Descrizione |
productId |
L'ID prodotto del negozio. |
Invio - Opzioni del comando di finalizzazione della distribuzione
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Invio - Guida al comando Finalizza distribuzione
msstore submission rollout finalize --help
Esempio: pubblicare un aggiornamento e implementarlo gradualmente
Il seguente esempio PowerShell carica un pacchetto, aggiorna le note di rilascio, avvia la distribuzione al 5%, quindi la aumenta e la finalizza.
$productId = '<productId>'
# 1. Upload the package but leave the submission in draft.
# 'publish' recreates the draft, so it has to run before any metadata edits.
msstore publish 'C:\path\to\app' --noCommit
# 2. Update the metadata and enable the rollout in a single call.
$submission = msstore submission get $productId | ConvertFrom-Json
$submission.Listings.'en-us'.BaseListing.ReleaseNotes = 'Bug fixes and improvements'
$submission.PackageDeliveryOptions.PackageRollout.IsPackageRollout = $true
$submission.PackageDeliveryOptions.PackageRollout.PackageRolloutPercentage = 5
msstore submission update $productId ($submission | ConvertTo-Json -Depth 100 -Compress)
# 3. Commit the submission and wait for it to publish.
msstore submission publish $productId
msstore submission poll $productId
# 4. Increase the rollout over time, without uploading the package again.
msstore submission rollout update $productId 20
# 5. Roll out to all customers (or use 'halt' to stop the rollout).
msstore submission rollout finalize $productId
Important
Se l'app ha già un invio pubblicato, msstore publish elimina la bozza in sospeso e ne crea una nuova dall'ultimo invio pubblicato, eliminando eventuali modifiche ai metadati già preparate in tale bozza. Eseguire publishprima di aggiornare i metadati, non dopo.
Comandi Volo
| Sottocomando |
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 - Elencare l'utilizzo dei comandi
msstore flights list <productId>
Voli - Elencare gli argomenti dei comandi
| Argomento |
Descrizione |
productId |
ID prodotto. |
Voli - Guida ai comandi elenco
msstore flights list --help
Voli - Guida all'Uso dei Comandi
msstore flights get <productId> <flightId>
Voli - Estrarre argomenti di comando
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Voli - Ottenere la Guida ai comandi
msstore flights get --help
Voli - Eliminare l'utilizzo dei comandi
msstore flights delete <productId> <flightId>
Voli - Elimina argomenti di comando
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Voli - Eliminare la Guida ai comandi
msstore flights delete --help
Voli - Creare l'utilizzo dei comandi
msstore flights create <productId> <friendlyName> --group-ids <group-ids>
Voli - Creare parametri di comando
| Argomento |
Descrizione |
productId |
ID prodotto. |
friendlyName |
Nome amichevole del volo. |
Fasi di test - Crea opzioni di comando
| 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. |
Voli - Guida per la creazione di comandi
msstore flights create --help
Voli - Comando di sottomissione
| Sottocomando |
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 - Utilizzo del Comando Get
msstore flights submission get <productId> <flightId>
Voli - Argomenti del comando Get per la presentazione
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Voli - Guida per ottenere il comando per l'invio
msstore flights submission get --help
Voli - Utilizzo dei comandi di eliminazione invio
msstore flights submission delete <productId> <flightId>
Voli - Argomenti di comando per l'eliminazione dell'invio
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Voli - Guida per l'eliminazione dell'invio
msstore flights submission delete --help
Voli - Utilizzo dei comandi per l'aggiornamento dell'invio
msstore flights submission update <productId> <flightId> <product>
Voli - Argomenti del comando per l'aggiornamento dell'invio
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
product |
Rappresentazione del prodotto JSON aggiornata. |
Distribuzioni - Opzioni di comando per l'aggiornamento della sottomissione
| Opzione |
Descrizione |
| -s, --skipInitialPolling (salta il sondaggio iniziale) |
Saltare il polling iniziale prima di eseguire l'azione. [valore predefinito: Falso] |
Voli - Guida ai comandi per l'aggiornamento dell'invio
msstore flights submission update --help
Voli - Comando di Invio per la Pubblicazione
msstore flights submission publish <productId> <flightId>
Voli - Argomenti del comando di pubblicazione per l'invio
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Voli - Guida ai comandi di pubblicazione per l'invio
msstore flights submission publish --help
Voli - Utilizzo dei comandi di sondaggio per l'invio
msstore flights submission poll <productId> <flightId>
Voli - Argomenti del comando poll per l'invio
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Voli - Guida al comando di invio per il sondaggio
msstore flights submission poll --help
Voli - Utilizzo dei comandi stato di invio
msstore flights submission status <productId> <flightId>
Voli - Argomenti del comando Stato invio
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Voli - Guida al comando Stato di invio
msstore flights submission status --help
Voli - Invio - Comando di implementazione
| Sottocomando |
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 - Distribuzione Uso del Comando Get
msstore flights submission rollout get <productId> <flightId>
Voli - Invio - Distribuzione Argomenti del Comando Get
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Voli - Invio - Implementazione Get Command Options
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
Voli - Invio - Implementazione - Ottieni Aiuto Comando
msstore flights submission rollout get --help
Voli - Invio - Distribuzione dell'utilizzo dei comandi di aggiornamento
msstore flights submission rollout update <productId> <flightId> <percentage>
Voli - Invio - Argomenti dei comandi di aggiornamento dell'implementazione
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
percentage |
Percentuale di utenti che riceveranno la distribuzione dell'invio. |
Voli - Invio - Opzioni dei comandi di aggiornamento distribuzione
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
Voli - Invio - Guida ai comandi di aggiornamento dell'implementazione
msstore flights submission rollout update --help
Voli - Invio - Implementazione interrompi utilizzo dei comandi
msstore flights submission rollout halt <productId> <flightId>
Fasi di rilascio - Invio - Argomenti del comando di arresto distribuzione
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Voli - Invio - Implementazione interrompi opzioni comando
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
Voli - Invio - Guida al comando per fermare il rollout
msstore flights submission rollout halt --help
Voli - Invio - Implementazione finalizzare l'utilizzo dei comandi
msstore flights submission rollout finalize <productId> <flightId>
Voli - Invio - Implementazione finalizza argomenti di comando
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Versioni - Sottomissione - Opzioni di Comando per la Finalizzazione del Rollout
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
Voli - Trasmissione - Implementazione Completamento Guida ai comandi
msstore flights submission rollout finalize --help
Comando Init
Il comando init consente di configurare l'applicazione per la pubblicazione nel Microsoft Store. Attualmente supporta i seguenti tipi di applicazioni:
- WinUI
- .NET MAUI
- Flutter
- Elettrone
- React Native per desktop
- PWA
- UWP (Piattaforma Universale Windows)
Esempi di utilizzo
SDK per app di Windows/WinUI
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 |
Nome visualizzato del Publisher utilizzato per configurare l'applicazione. Se fornito, evita una chiamata API aggiuntiva. |
| --pacchetto |
Se il tipo di app lo supporta, impacchetta automaticamente il progetto. |
| --pubblicare |
Se supportato dal tipo di app, pubblica automaticamente il progetto. Implica '--package true' |
| -f, --idVolo |
Specifica l'ID volo 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". Viene 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, --versione |
La versione utilizzata durante la creazione dell'app. Se non fornita, verrà utilizzata la versione del file di progetto. |
Comando Pacchetto
Consente di creare un pacchetto dell'applicazione Microsoft Store come MSIX.
Esempi di utilizzo
SDK per app di Windows/WinUI
msstore package "C:\path\to\winui3_app"
WinUI
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, --versione |
La versione utilizzata durante la creazione dell'app. Se non fornita, verrà utilizzata la versione del file di progetto. |
Comando Publish
Pubblica l'applicazione nel Microsoft Store.
Esempi di utilizzo
SDK per app di Windows/WinUI
msstore publish "C:\path\to\winui3_app"
WinUI
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, --file di input |
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 la conferma dell'invio, mantenendolo allo stato di bozza. |
| -f, --idVolo |
Specifica l'ID volo 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
| Sottocomando |
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, --aiuto |
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 |
ID del volo. |
Options
| Opzione |
Descrizione |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
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, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Voli - Invio
| Sottocomando |
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 |
ID del volo. |
Options
| Opzione |
Descrizione |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Voli - Invio - Eliminazione - Utilizzo
msstore flights submission delete <productId> <flightId>
Argomenti
| Argomento |
Descrizione |
productId |
ID prodotto. |
flightId |
ID del volo. |
Options
| Opzione |
Descrizione |
| --no-confirm |
Indica che non è richiesta la conferma. |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
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 |
ID del volo. |
product |
Rappresentazione del prodotto JSON aggiornata. |
Options
| Opzione |
Descrizione |
| -s, --skipInitialPolling (salta il sondaggio iniziale) |
Saltare il polling iniziale prima di eseguire l'azione. [valore predefinito: Falso] |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Voli - Invio - Pubblicazione - Utilizzo
msstore flights publish <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 - Invio - Sondaggio - Utilizzo
msstore flights poll <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 - Invio - Stato - Utilizzo
msstore flights status <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 - Invio - Distribuzione
| Sottocomando |
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 |
ID del volo. |
Options
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
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 |
ID del volo. |
percentage |
Percentuale di utenti che riceveranno la distribuzione dell'invio. |
Options
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
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 |
ID del volo. |
Options
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
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 del volo. |
Options
| Opzione |
Descrizione |
| -s, --idSottomissione |
ID di invio. |
| -v, --dettagliato |
Stampa un output dettagliato. |
| -?, -h, --aiuto |
Mostra le informazioni su aiuto e utilizzo. |
Ambienti CI/CD
L'interfaccia della riga di comando di Microsoft Store developer (anteprima) supporta l'esecuzione in ambienti CI/CD. Ciò significa che è possibile usare la CLI per sviluppatori del Microsoft Store (anteprima) nelle pipeline CI/CD per, ad esempio, pubblicare automaticamente le applicazioni nel Microsoft Store.
Il primo passaggio per ottenere questo risultato è installare la CLI sviluppatore di Microsoft Store (versione di anteprima) nell'ambiente CI/CD. Puoi trovare le istruzioni su come fare qui.
Dopo aver installato l'interfaccia della riga di comando per sviluppatori Microsoft Store (anteprima), è necessario configurare l'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 questi segreti. Ad esempio, Azure DevOps chiamarli Secret Variables, ma GitHub Action li chiama Encrypted Secrets. 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
GitHub Actions
- 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 }}
Dopo l'esecuzione di questo comando, l'interfaccia della riga di comando per sviluppatori Microsoft Store (anteprima) verrà configurata per l'uso delle credenziali fornite. Ora puoi utilizzare il Microsoft Store Developer CLI (anteprima) nella tua pipeline CI/CD.
