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:
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:
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).
Riconfigurazione - Utilizzo
msstore reconfigure
Riconfigurare - Opzioni
Opzione
Descrizione
-t, --tenantId
Specifica l'ID tenant da utilizzare.
-s, --sellerId
Specifica l'ID venditore da utilizzare.
-c, --clientId
Specifica l'ID client da utilizzare.
-cs, --clientSecret
Specifica il segreto client da utilizzare.
-ct, --certificateThumbprint
Specificare l'identificazione personale del certificato da usare.
-cfp, --certificateFilePath
Specificare il percorso del file del certificato da usare.
-cp, --certificatePassword
Specificare la password del certificato da usare.
--reset
Reimposta solo le credenziali, senza ricominciare da capo.
Comando impostazioni
Modifica le impostazioni della CLI per sviluppatori di Microsoft Store.
Impostazioni - Utilizzo
msstore settings
Sotto-comando
Descrizione
setpdn
Imposta la proprietà Nome visualizzato dell'editore utilizzata dal comando init.
Impostazioni - Opzioni
Opzione
Descrizione
-t, --enableTelemetry
Abilita (vuoto/vero) o Disabilita (falso) la telemetria.
-v, --verbose
Stampa un output dettagliato.
Impostazioni - Utilizzo dei comandi SetPDN
msstore settings setpdn <publisherDisplayName>
Argomenti
Argomento
Descrizione
publisherDisplayName
La proprietà Nome visualizzato editore che verrà impostata a livello globale.
Ignorare il polling iniziale prima di eseguire l'azione. [valore predefinito: Falso]
Invio - Guida al comando UpdateMetadata
msstore submission updateMetadata --help
Invio - Aggiornamento dell'utilizzo dei comandi
msstore submission update <productId> <product>
Invio - Aggiornare gli argomenti del comando
Argomento
Descrizione
productId
ID del prodotto.
product
Rappresentazione del prodotto JSON aggiornata.
Invio - Opzioni dei comandi di aggiornamento
Opzione
Descrizione
-s, --skipInitialPolling
Ignorare il polling iniziale prima di eseguire l'azione. [valore predefinito: Falso]
Invio - Guida ai comandi di aggiornamento
msstore submission update --help
Invio - Utilizzo dei comandi di polling
msstore submission poll <productId>
Invio - Argomenti del comando di polling
Argomento
Descrizione
productId
ID del prodotto.
Invio - Guida ai comandi di polling
msstore submission poll --help
Invio - Utilizzo dei comandi di pubblicazione
msstore submission publish <productId>
Invio - Argomenti del comando di pubblicazione
Argomento
Descrizione
productId
ID del prodotto.
Invio - Guida ai comandi di pubblicazione
msstore submission publish --help
Invio - Eliminazione utilizzo comandi
Elimina l'invio in sospeso dallo Store.
Invio - Elimina argomenti di comando
Argomento
Descrizione
productId
ID del prodotto.
Invio - Opzioni di comando elimina
Opzione
Descrizione
--no-confirm
Indica che non è richiesta la conferma. [valore predefinito: Falso]
Invio - Guida ai comandi di eliminazione
msstore submission delete --help
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
.NET MAUI
Flutter
Electron
React Native for Desktop
PWA
Comando Init - Esempi di utilizzo
Comando Init - SDK per app di Windows/WinUI 3
msstore init "C:\path\to\winui3_app"
Comando Init - UWP
msstore init "C:\path\to\uwp_app"
Comando Init - .NET MAUI
msstore init "C:\path\to\maui_app"
Comando Init - Flutter
msstore init "C:\path\to\flutter_app"
Comando Init - Elettrone
msstore init "C:\path\to\electron_app"
Comando Init - React Native for 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.
Comando Init - PWA
msstore init https://contoso.com --output .
Comando Init - 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.
Comando Init - Opzioni
Opzione
Descrizione
-n, --publisherDisplayName
Il nome visualizzato dell'editore utilizzato per configurare l'applicazione. Se fornito, evita una chiamata API aggiuntiva.
--package
Se supportato dal tipo di app, comprime automaticamente il progetto.
--publish
Se supportato dal tipo di app, pubblica automaticamente il progetto. Implica '--package true'
-f, --flightId
Specifica l'ID anteprima in cui verrà pubblicato il pacchetto.
-prp, --packageRolloutPercentage
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, --output
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.
Comando pacchetto - Esempi di utilizzo
Comando pacchetto - SDK per app di Windows/WinUI 3
msstore package "C:\path\to\winui3_app"
Comando pacchetto - UWP
msstore package "C:\path\to\uwp_app"
Comando pacchetto - .NET MAUI
msstore package "C:\path\to\maui_app"
Comando pacchetto - Flutter
msstore package "C:\path\to\flutter_app"
Comando pacchetto - Electron
msstore package "C:\path\to\electron_app"
Comando pacchetto - React Native for Desktop
msstore package "C:\path\to\react_native_app"
Comando pacchetto - PWA
msstore package "C:\path\to\pwa_app"
Comando pacchetto - 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.
Comando pacchetto - Opzioni
Opzione
Descrizione
-o, --output
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.
Comando Publish - Esempi di utilizzo
Comando Publish - SDK per app di Windows/WinUI 3
msstore publish "C:\path\to\winui3_app"
Comando Pubblica - UWP
msstore publish "C:\path\to\uwp_app"
Comando Publish - .NET MAUI
msstore publish "C:\path\to\maui_app"
Comando Pubblica - Flutter
msstore publish "C:\path\to\flutter_app"
Comando Publish - Electron
msstore publish "C:\path\to\electron_app"
Comando Publish - React Native for Desktop
msstore publish "C:\path\to\react_native_app"
Comando Publish - PWA
msstore publish "C:\path\to\pwa_app"
Comando Pubblica - 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.
Comando Pubblica - Opzioni
Opzione
Descrizione
-i, --inputDirectory
La directory in cui si trova il file ".msix" o ".msixupload" da utilizzare per il comando di pubblicazione. Se non fornito, la CLI proverà a trovare il miglior candidato in base all'argomento 'pathOrUrl'.
-id, --appId
Specifica l'ID dell'applicazione. Necessario solo se il progetto non è stato inizializzato in precedenza con il comando 'init'.
-nc, --noCommit
Disabilita il commit dell'invio, mantenendolo nello stato bozza.
-f, --flightId
Specifica l'ID anteprima in cui verrà pubblicato il pacchetto.
-prp, --packageRolloutPercentage
Specifica la percentuale di implementazione del pacchetto. Il valore deve essere compreso tra 0 e 100.
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
GitHub Actions
- name: Setup Microsoft Store Developer CLI
uses: microsoft/setup-msstore-cli@v1
- 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.
Collabora con noi su GitHub
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.
