Instalace
Krok 1: Instalace .NET prostředí Windows Runtime
Pokud jste to ještě neudělali, nainstalujte si nejnovější verzi .NET 9 Desktop Runtime. Toto je požadavek na spuštění rozhraní příkazového řádku pro vývojáře Microsoft Store.
Nejjednodušší způsob, jak ho nainstalovat, je použít winget:
winget install Microsoft.DotNet.DesktopRuntime.9
Krok 2: Instalace rozhraní příkazového řádku pro vývojáře Microsoft Store na Windows
Vývojářské rozhraní příkazového řádku Microsoft Store si můžete stáhnout z Microsoft Store. Alternativně můžete použít winget:
winget install "Microsoft Store Developer CLI"
Krok 1: Instalace .NET prostředí macOS Runtime
Pokud jste to ještě neudělali, nainstalujte si nejnovější verzi modulu .NET 9 Runtime. Toto je požadavek na spuštění rozhraní příkazového řádku pro vývojáře Microsoft Store.
Krok 2: Instalace rozhraní příkazového řádku pro vývojáře Microsoft Store v systému macOS
Stáhněte si balíček .tar.gz pro macOS pro vaši konkrétní architekturu (x64 nebo Arm64) ze stránky s verzemi Microsoft Store Developer CLI. Po stažení extrahujte archiv a vložte ho do systémové cesty, jakýmkoliv vám vyhovujícím způsobem; například:
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
Alternativně můžete použít brew:
brew install microsoft/msstore-cli/msstore-cli
Krok 1: Instalace .NET Linux Runtime
Pokud jste to ještě neudělali, nainstalujte si nejnovější verzi modulu .NET 9 Runtime. Toto je požadavek na spuštění rozhraní příkazového řádku pro vývojáře Microsoft Store.
Krok 2: Instalace rozhraní příkazového řádku pro vývojáře Microsoft Store v Linuxu
Linux .tar.gz pro vaši konkrétní architekturu (x64 nebo Arm64) si můžete stáhnout z stránky s verzemi Microsoft Store Developer CLI. Po stažení extrahujte archiv a vložte ho do systémové cesty, jakýmkoliv vám vyhovujícím způsobem; například:
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
Alternativně můžete použít brew:
brew install microsoft/msstore-cli/msstore-cli
Informační příkaz
Vytiskněte existující konfiguraci.
Usage
msstore info
Možnosti
| Možnost |
Popis |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Znovu nakonfigurujte rozhraní příkazového řádku pro vývojáře Microsoft Store. Můžete zadat tajný klíč klienta nebo certifikát. Certifikáty je možné poskytnout buď prostřednictvím kryptografického otisku, nebo zadáním cesty k souboru (s heslem nebo bez hesla).
Usage
msstore reconfigure
Možnosti
| Možnost |
Popis |
| -t, --id_tenanta |
Zadejte ID tenanta, které se má použít. |
| -s, --identifikatorProdávajícího |
Zadejte ID prodejce, které se má použít. |
| -c, --ID klienta |
Zadejte ID klienta, které se má použít. |
| -cs, --tajné_klíč klienta |
Zadejte tajný klíč klienta, který se má použít. |
| -ct, --certificateThumbprint (otisk certifikátu) |
Zadejte kryptografický otisk certifikátu, který se má použít. |
| -cfp, --certificateFilePath |
Zadejte cestu k souboru certifikátu, která se má použít. |
| -cp, --certificatePassword (heslo certifikátu) |
Zadejte heslo certifikátu, které se má použít. |
| --resetovat |
Resetujte jenom přihlašovací údaje, aniž byste museli začít znovu. |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Příkaz Nastavení
Změňte nastavení rozhraní příkazového řádku pro vývojáře Microsoft Store.
Usage
msstore settings
Možnosti
| Možnost |
Popis |
| -t, --povolitTelemetrii |
Povolte (prázdné/true) nebo zakažte (false) telemetrii. |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
SetPDN Sub-příkaz
Nastavte vlastnost Zobrazovaný název vydavatele, kterou používá příkaz init.
Usage
msstore settings setpdn <publisherDisplayName>
Argumenty
| Důvod |
Popis |
publisherDisplayName |
Vlastnost Zobrazený název vydavatele, která se nastaví globálně. |
Možnosti
| Možnost |
Popis |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Příkazy aplikací
| Sub-Command |
Popis |
|
seznam |
Zobrazí seznam všech aplikací ve vašem účtu. |
|
dostat |
Získá podrobnosti konkrétní aplikace. |
Aplikace – Seznam – Využití
msstore apps list
Možnosti
| Možnost |
Popis |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Aplikace – Získání – Využití
msstore apps get <productId>
Argumenty
| Důvod |
Popis |
productId |
ID produktu Store. |
Možnosti
| Možnost |
Popis |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Příkaz odeslání
| Sub-Command |
Popis |
|
stav |
Získá stav odeslání. |
|
dostat |
Získá metadata a informace o balíčku konkrétního podání. |
|
getListingAssets |
Získá seznam aktiv určitého podání. |
|
updateMetadata |
Aktualizuje metadata konkrétního odeslání. |
| aktualizace |
Aktualizuje balíček konkrétního odeslání. |
|
hlasování |
Zjišťuje stav odeslání. |
|
publikovat |
Publikuje konkrétní příspěvek. |
|
vymazat |
Odstraní konkrétní příspěvek. |
|
Zavádění |
Provádění operací souvisejících s postupným zaváděním balíčků |
Odeslání – stav – Využití
msstore submission status <productId>
Argumenty
| Důvod |
Popis |
productId |
ID produktu Store. |
Možnosti
| Možnost |
Popis |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Odeslání – získání – využití
msstore submission get <productId>
Argumenty
| Důvod |
Popis |
productId |
ID produktu Store. |
Možnosti
| Možnost |
Popis |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Odeslání – GetListingAssets – Využití
msstore submission getListingAssets <productId>
Argumenty
| Důvod |
Popis |
productId |
ID produktu Store. |
Možnosti
| Možnost |
Popis |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
msstore submission updateMetadata <productId> <metadata>
Poznámka:
Pro aplikace MSIX nebo balené aplikace jsou submission updateMetadata a submission update ekvivalentní – oba odesílají kompletní JSON odeslání vrácený příkazem submission get, takže kterýmkoli z nich lze společně aktualizovat záznamy i balíčky.
Tyto dvě možnosti se liší pouze u nebalených aplikací (MSI/EXE), kde ID produktu představuje identifikátor GUID: updateMetadata aktualizuje metadata položky v Obchodě, zatímco update aktualizuje balíčky.
Argumenty
| Důvod |
Popis |
productId |
ID produktu Store. |
metadata |
Aktualizovaná reprezentace metadat JSON. |
Možnosti
| Možnost |
Popis |
| -s, --skipInitialPolling (přeskočit počáteční dotazování) |
Před provedením akce přeskočte počáteční dotazování. [výchozí: Nepravda] |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Odeslání – aktualizace – využití
msstore submission update <productId> <package>
Argumenty
| Důvod |
Popis |
productId |
ID produktu Store. |
package |
Aktualizovaná reprezentace balíčku aplikace ve formátu JSON. |
Možnosti
| Možnost |
Popis |
| -s, --skipInitialPolling (přeskočit počáteční dotazování) |
Před provedením akce přeskočte počáteční dotazování. [výchozí: Nepravda] |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Návod
Slouží submission get k načtení kódu JSON aktuálního balíčku před voláním submission update. Tím zajistíte, že pracujete se správnou strukturou a aktuálními hodnotami. Například v PowerShellu:
# 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
Pro více informací, viz Publikování aktualizací aplikací pro Microsoft Store s GitHub Actions.
Odeslání – hlasování – využití
msstore submission poll <productId>
Argumenty
| Důvod |
Popis |
productId |
ID produktu Store. |
Možnosti
| Možnost |
Popis |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Odeslání – publikování – využití
msstore submission publish <productId>
Argumenty
| Důvod |
Popis |
productId |
ID produktu Store. |
Možnosti
| Možnost |
Popis |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Odeslání – Odstranění – Využití
msstore submission delete <productId>
Argumenty
| Důvod |
Popis |
productId |
ID produktu Store. |
Možnosti
| Možnost |
Popis |
| --no-potvrzení |
Nevyzývejte k potvrzení. [výchozí: Nepravda] |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Odeslání – příkaz zavedení
Pomocí těchto dílčích příkazů můžete spravovat postupné zavádění balíčků pro odeslání bez testovací verze. Pokud chcete spravovat zavedení, které cílí na testovací verzi balíčku, použijte msstore flights submission rollout místo toho.
Tyto příkazy jsou podporovány pouze pro aplikace MSIX nebo zabalené aplikace. Pokud id odeslání vynecháte, rozhraní příkazového řádku použije čekající odeslání aplikace a vrátí se k poslednímu publikovanému.
| Podpříkaz | Popis | | -------------------------------------------------------- | -------------------------------------------------- | | get | Načte stav nasazení podání. | | update | Aktualizuje procento zavedení odeslání. | | halt | Zastaví zavedení odeslání. | | finalize | Dokončí nasazení podání. |
Odeslání – použití příkazu Rollout Get
msstore submission rollout get <productId>
Odeslání – nasazení – získání argumentů příkazu
| Důvod |
Popis |
productId |
ID produktu Store. |
Odeslání – Možnosti příkazu Get pro nasazení
| Možnost |
Popis |
| -s, --ID předložení |
ID odeslání. |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Odeslání – Získání nápovědy k příkazu pro nasazení
msstore submission rollout get --help
Odeslání – Zavedení využití příkazů aktualizace
msstore submission rollout update <productId> <percentage>
Odeslání – argumenty příkazu pro aktualizaci nasazení
| Důvod |
Popis |
productId |
ID produktu Store. |
percentage |
Procento uživatelů, kterým bude postupně zpřístupněno odesílání (0–100). |
Odeslání – Možnosti příkazu pro aktualizaci nasazení
| Možnost |
Popis |
| -s, --ID předložení |
ID odeslání. |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Odeslání – Nápověda k příkazu pro aktualizaci zavádění
msstore submission rollout update --help
Odeslání – zavedení použití příkazu Zastavit
msstore submission rollout halt <productId>
Odeslání – argumenty příkazu k zastavení nasazení
| Důvod |
Popis |
productId |
ID produktu Store. |
Odeslání – možnosti příkazu k zastavení nasazení
| Možnost |
Popis |
| -s, --ID předložení |
ID odeslání. |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Odeslání – Nápověda k příkazu pro zastavení nasazení
msstore submission rollout halt --help
Odeslání – dokončení zavedení využití příkazů
msstore submission rollout finalize <productId>
Odeslání – argumenty příkazu pro dokončení rolloutu
| Důvod |
Popis |
productId |
ID produktu Store. |
Odeslání – Možnosti příkazu pro dokončení nasazení
| Možnost |
Popis |
| -s, --ID předložení |
ID odeslání. |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Odeslání – Nápověda k příkazu pro dokončení nasazení
msstore submission rollout finalize --help
Příklad: Publikování aktualizace a jeho postupné zavedení
Následující příklad v PowerShellu nahraje balíček, aktualizuje poznámky k verzi, zahájí nasazení na 5 %, poté zvýší podíl nasazení a nakonec ho dokončí.
$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
Pokud už aplikace má publikované odeslání, msstore publish odstraní čekající koncept a z posledního publikovaného odeslání vytvoří nový, přičemž zahodí všechny změny metadat, které už byly v tomto konceptu připravené. Spusťte publishpřed aktualizací metadat, ne po.
Příkazy pro lety
| Sub-Command |
Popis |
|
seznam |
Načte všechny lety pro zadanou aplikaci. |
|
dostat |
Načte "flight" pro zadanou aplikaci a testovací relaci. |
|
vymazat |
Odstraní "flight" pro zadanou aplikaci a "flight". |
|
create |
Vytvoří let pro zadanou aplikaci a verzi. |
|
podání |
Provádění úkolů souvisejících s odesláním testovací verze |
Lety – výpis využití příkazů
msstore flights list <productId>
Lety – výpis argumentů příkazů
| Důvod |
Popis |
productId |
ID produktu. |
Lety – nápověda k příkazům seznamu
msstore flights list --help
Lety - Použití příkazu 'Get'
msstore flights get <productId> <flightId>
Lety – získat parametry příkazů
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Lety – získání nápovědy k příkazům
msstore flights get --help
Lety – odstranění využití příkazů
msstore flights delete <productId> <flightId>
Lety – odstranění argumentů příkazu
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Lety – nápověda k příkazu „Odstranit“
msstore flights delete --help
Lety – Použití příkazu Create
msstore flights create <productId> <friendlyName> --group-ids <group-ids>
Lety – Vytvořit argumenty příkazů
| Důvod |
Popis |
productId |
ID produktu. |
friendlyName |
Přátelský název letu. |
Lety – možnosti vytvoření příkazu
| Možnost |
Popis |
| -g, --skupinová ID |
ID skupin, které se mají přiřadit k letu. |
| -r, --hodnotit-výš-než |
ID letu, které má být zařazeno na vyšší místo. |
Lety – Nápověda k příkazu vytvoření
msstore flights create --help
Lety – Podání příkazu
| Sub-Command |
Popis |
|
dostat |
Načte existující odeslání paketového letu, a to buď existující koncept, nebo poslední publikovanou verzi. |
|
vymazat |
Odstraní čekající odeslání aktualizačního balíčku z úložiště. |
| aktualizace |
Aktualizuje stávající koncept letu s poskytnutým JSON. |
|
publikovat |
Spustí proces odeslání testovací verze pro stávající koncept. |
|
hlasování |
Dotazuje se, dokud nebude existující odeslání testovací verze publikováno nebo neúspěšné. |
|
stav |
Načte aktuální stav odeslání testovací verze storu. |
|
Zavádění |
Spusťte operace související se zaváděním testovacích verzí. |
Lety – odeslání získání využití příkazů
msstore flights submission get <productId> <flightId>
Lety – načtení argumentů příkazu pro odeslání
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Lety – Získání nápovědy k příkazu pro odeslání
msstore flights submission get --help
Lety – odstranění použití příkazu k odeslání
msstore flights submission delete <productId> <flightId>
Lety – odstranění argumentů příkazu pro odeslání
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Lety – Nápověda k příkazu pro odstranění podání
msstore flights submission delete --help
Lety – využití příkazu pro aktualizaci odeslání
msstore flights submission update <productId> <flightId> <product>
Lety – argumenty příkazu aktualizace předložení
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
product |
Aktualizovaná reprezentace produktu JSON. |
Lety – příkazové možnosti aktualizace odeslání
| Možnost |
Popis |
| -s, --skipInitialPolling (přeskočit počáteční dotazování) |
Před provedením akce přeskočte počáteční dotazování. [výchozí: Nepravda] |
Lety – Příkazová nápověda pro aktualizaci podání
msstore flights submission update --help
Lety – Použití příkazu pro zveřejnění odeslání
msstore flights submission publish <productId> <flightId>
Lety – argumenty příkazu pro publikování příspěvku
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Lety – Nápověda k publikačnímu příkazu odeslání
msstore flights submission publish --help
Lety – využití příkazů k odeslání hlasování
msstore flights submission poll <productId> <flightId>
Lety – argumenty příkazu hlasování pro odeslání
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Lety – Nápověda k příkazu hlasování pro odeslání
msstore flights submission poll --help
Lety – Využití příkazů stavu odeslání
msstore flights submission status <productId> <flightId>
Lety – parametry příkazu stavu odeslání
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Stav letu - Nápověda k příkazu pro odeslání
msstore flights submission status --help
Lety: podání: příkaz spuštění
| Sub-Command |
Popis |
|
dostat |
Načte stav postupného uvedení odeslaného příspěvku. |
| aktualizace |
Aktualizujte procento uvedení letové verze předložení. |
|
Zastavit |
Zastaví postupné zavádění nasazení. |
|
Dokončit |
Dokončí zavedení testovací verze odeslání. |
Lety – Odeslání – Použití příkazu Get při nasazení
msstore flights submission rollout get <productId> <flightId>
Lety – Odeslání – Získání argumentů příkazu nasazení
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Lety – Odeslání – Možnosti příkazů nasazení
| Možnost |
Popis |
| -s, --ID předložení |
ID odeslání. |
Lety – Odeslání – Získat nápovědu k příkazu nasazení
msstore flights submission rollout get --help
Lety – Odeslání – Využití příkazů pro nasazení aktualizace
msstore flights submission rollout update <productId> <flightId> <percentage>
Lety – odeslání – argumenty příkazu aktualizace zavádění
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
percentage |
Procento uživatelů, kteří obdrží zavedení odeslání |
Lety – Odeslání – Možnosti příkazů aktualizace uvedení
| Možnost |
Popis |
| -s, --ID předložení |
ID odeslání. |
Lety – Odeslání – Nápověda k příkazu aktualizace nasazení
msstore flights submission rollout update --help
Lety – Odeslání – Použití příkazu k pozastavení nasazení
msstore flights submission rollout halt <productId> <flightId>
Lety – odeslání příkazu – argumenty zastavení zavedení
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Lety – Odeslání – Možnosti příkazu pro zastavení zavádění
| Možnost |
Popis |
| -s, --ID předložení |
ID odeslání. |
Lety – Odeslání – Nápověda k pokynu Zastavení nasazení
msstore flights submission rollout halt --help
Lety – odeslání – Dokončení zavedení využití příkazů
msstore flights submission rollout finalize <productId> <flightId>
Lety – Odeslání – Dokončení dokončení příkazu zavedení
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Lety – Odeslání – Možnosti finalizace příkazu pro uvedení do provozu
| Možnost |
Popis |
| -s, --ID předložení |
ID odeslání. |
Lety – Odeslání – Nápověda k příkazu pro dokončení nasazení
msstore flights submission rollout finalize --help
Inicializační příkaz
Příkaz init vám pomůže nastavit aplikaci tak, aby se publikovala do Microsoft Store. V současné době podporuje následující typy aplikací:
- WinUI
- .NET MAUI
- Třepetat
- Elektron
- React Native pro stolní počítače
- PWA
- UPW
Příklady použití
Windows App SDK/WinUI
msstore init "C:\path\to\winui3_app"
UPW
msstore init "C:\path\to\uwp_app"
.NET MAUI
msstore init "C:\path\to\maui_app"
Třepetat
msstore init "C:\path\to\flutter_app"
Elektron
msstore init "C:\path\to\electron_app"
React Native pro stolní počítače
msstore init "C:\path\to\react_native_app"
Poznámka:
Pro projekty Electron a také React Native pro desktop jsou podporovány obě Npm a Yarn. Přítomnost souboru zámku Yarn (yarn.lock) bude použita k určení, který správce balíčků použít, proto se ujistěte, že soubor zámku vložíte do vašeho systému správy verzí.
PWA
msstore init https://contoso.com --output .
Argumenty
| Důvod |
Popis |
pathOrUrl |
Cesta ke kořenovému adresáři, kde je soubor projektu, nebo veřejná adresa URL, která odkazuje na PWA. |
Možnosti
| Možnost |
Popis |
| -n, --publisherDisplayName (zobrazované jméno vydavatele) |
Zobrazovaný název vydavatele použitý pro konfiguraci aplikace. Pokud je k dispozici, vyhne se dalšímu volání rozhraní API. |
| --balíček |
Pokud je to typem aplikace podporováno, automaticky zabalí projekt. |
| --zveřejnit |
Pokud typ aplikace podporuje, automaticky publikuje projekt. Implikuje --package true. |
| -f, --flightId (ID letu) |
Určuje ID testovací verze, ve které se balíček publikuje. |
| -prp, --procentoNasazeníBalíčku |
Určuje procento uvedení balíčku. Hodnota musí být v rozmezí od 0 do 100. |
| -a, --arch (určení architektury) |
Architektury, pro které se má stavět. Pokud není k dispozici, použije se výchozí architektura pro aktuální operační systém a typ projektu. Povolené hodnoty: "x86", "x64", "arm64". Používá se pouze ve spojení s "--package true". |
| -o, --výstup |
Výstupní adresář, do kterého se uloží zabalená aplikace. Pokud není zadaný, použije se výchozí adresář pro každý jiný typ aplikace. |
| -ver, --version |
Verze použitá při vytváření aplikace. Pokud není k dispozici, použije se verze ze souboru projektu. |
Příkaz balíčku
Pomáhá balit vaši aplikaci Microsoft Store jako MSIX.
Příklady použití
Windows App SDK/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"
Třepetat
msstore package "C:\path\to\flutter_app"
Elektron
msstore package "C:\path\to\electron_app"
React Native pro stolní počítače
msstore package "C:\path\to\react_native_app"
PWA
msstore package "C:\path\to\pwa_app"
Argumenty
| Možnost |
Popis |
pathOrUrl |
Cesta ke kořenovému adresáři, kde je soubor projektu, nebo veřejná adresa URL, která odkazuje na PWA. |
Možnosti
| Možnost |
Popis |
| -o, --výstup |
Výstupní adresář, do kterého se uloží zabalená aplikace. Pokud není zadaný, použije se výchozí adresář pro každý jiný typ aplikace. |
| -a, --arch (určení architektury) |
Architektury, pro které se má stavět. Pokud není k dispozici, použije se výchozí architektura pro aktuální operační systém a typ projektu. Povolené hodnoty: "x86", "x64", "arm64". |
| -ver, --version |
Verze použitá při vytváření aplikace. Pokud není k dispozici, použije se verze ze souboru projektu. |
Příkaz Publikovat
Publikuje aplikaci do Microsoft Store.
Příklady použití
Windows App SDK/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"
Třepetat
msstore publish "C:\path\to\flutter_app"
Elektron
msstore publish "C:\path\to\electron_app"
React Native pro stolní počítače
msstore publish "C:\path\to\react_native_app"
PWA
msstore publish "C:\path\to\pwa_app"
Argumenty
| Možnost |
Popis |
pathOrUrl |
Cesta ke kořenovému adresáři, kde je soubor projektu, nebo veřejná adresa URL, která odkazuje na PWA. |
Možnosti
| Možnost |
Popis |
| -i, --vstupníSoubor |
Cesta k souboru .msix nebo .msixupload, který se má použít pro příkaz publikování. Pokud není zadáno, CLI se pokusí najít nejlepšího kandidáta na základě argumentu 'pathOrUrl'. |
| -id, --appId (identifikátor aplikace) |
Určuje ID aplikace. Je potřeba pouze v případě, že projekt nebyl inicializován před příkazem inicializace. |
| -nc, --noCommit |
Zakáže potvrzení odeslání a zachová ho ve stavu konceptu. |
| -f, --flightId (ID letu) |
Určuje ID testovací verze, ve které se balíček publikuje. |
| -prp, --procentoNasazeníBalíčku |
Určuje procento uvedení balíčku. Hodnota musí být v rozmezí od 0 do 100. |
Řízení Letů
| Sub-Command |
Popis |
|
seznam |
Načte všechny lety pro zadanou aplikaci. |
|
dostat |
Načte "flight" pro zadanou aplikaci a testovací relaci. |
|
vymazat |
Odstraní "flight" pro zadanou aplikaci a "flight". |
|
create |
Vytvoří let pro zadanou aplikaci a verzi. |
|
podání |
Provádění úkolů souvisejících s odesláním testovací verze |
Lety – Seznam – Využití
msstore flights list <productId>
Argumenty
| Důvod |
Popis |
productId |
ID produktu. |
Možnosti
| Možnost |
Popis |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Lety – získání – využití
msstore flights get <productId> <flightId>
Argumenty
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Možnosti
| Možnost |
Popis |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Lety – Smazání – Využití
msstore flights delete <productId> <flightId>
Argumenty
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Možnosti
| Možnost |
Popis |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Lety – vytváření – použití
msstore flights create <productId> <friendlyName> --group-ids <group-ids>
Argumenty
| Důvod |
Popis |
productId |
ID produktu. |
friendlyName |
Přátelský název letu. |
Možnosti
| Možnost |
Popis |
| -g, --skupinová ID |
ID skupin, které se mají přiřadit k letu. |
| -r, --hodnotit-výš-než |
ID letu, které má být zařazeno na vyšší místo. |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Lety – podání
| Sub-Command |
Popis |
|
dostat |
Načte existující odeslání paketového letu, a to buď existující koncept, nebo poslední publikovanou verzi. |
|
vymazat |
Odstraní čekající odeslání aktualizačního balíčku z úložiště. |
| aktualizace |
Aktualizuje stávající koncept letu s poskytnutým JSON. |
|
publikovat |
Spustí proces odeslání testovací verze pro stávající koncept. |
|
hlasování |
Dotazuje se, dokud nebude existující odeslání testovací verze publikováno nebo neúspěšné. |
|
stav |
Načte aktuální stav odeslání testovací verze storu. |
|
Zavádění |
Spusťte operace související se zaváděním testovacích verzí. |
Lety – Odeslání – Získání – Využití
msstore flights submission get <productId> <flightId>
Argumenty
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Možnosti
| Možnost |
Popis |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Lety – Odeslání – Smazání – Použití
msstore flights submission delete <productId> <flightId>
Argumenty
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Možnosti
| Možnost |
Popis |
| --no-potvrzení |
Nevyzývejte k potvrzení. |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Lety – Odeslání – Aktualizace – Využití
msstore flights submission update <productId> <flightId> <product>
Argumenty
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
product |
Aktualizovaná reprezentace produktu JSON. |
Možnosti
| Možnost |
Popis |
| -s, --skipInitialPolling (přeskočit počáteční dotazování) |
Před provedením akce přeskočte počáteční dotazování. [výchozí: Nepravda] |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Lety – Odeslání – Publikování – Využití
msstore flights publish <productId> <flightId>
Argumenty
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Možnosti
| Možnost |
Popis |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Lety – Odeslání – Hlasování – Využití
msstore flights poll <productId> <flightId>
Argumenty
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Možnosti
| Možnost |
Popis |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Lety – Odeslání – Stav – Využití
msstore flights status <productId> <flightId>
Argumenty
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Možnosti
| Možnost |
Popis |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Lety – Podání – Nasazení
| Sub-Command |
Popis |
|
dostat |
Načte stav postupného uvedení odeslaného příspěvku. |
| aktualizace |
Aktualizujte procento uvedení letové verze předložení. |
|
Zastavit |
Zastaví postupné zavádění nasazení. |
|
Dokončit |
Dokončí zavedení testovací verze odeslání. |
Lety – Odeslání – Zavedení – Získání – Využití
msstore flights submission rollout get <productId> <flightId>
Argumenty
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Možnosti
| Možnost |
Popis |
| -s, --ID předložení |
ID odeslání. |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Lety – Odeslání – Zavedení – Aktualizace – Využití
msstore flights submission rollout update <productId> <flightId> <percentage>
Argumenty
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
percentage |
Procento uživatelů, kteří obdrží zavedení odeslání |
Možnosti
| Možnost |
Popis |
| -s, --ID předložení |
ID odeslání. |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Lety – Odeslání – Zavedení – Zastavení – Využití
msstore flights submission rollout halt <productId> <flightId>
Argumenty
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Možnosti
| Možnost |
Popis |
| -s, --ID předložení |
ID odeslání. |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Lety – Odeslání – Uvedení – Dokončení – Využití
msstore flights submission rollout finalize <productId> <flightId>
Argumenty
| Důvod |
Popis |
productId |
ID produktu. |
flightId |
ID letu. |
Možnosti
| Možnost |
Popis |
| -s, --ID předložení |
ID odeslání. |
| -v, --verbose (podrobnosti) |
Vytisknout podrobný výstup |
| -?, -h, --help |
Zobrazení informací o nápovědě a využití |
Prostředí CI/CD
Příkazový řádek pro vývojáře Microsoft Store verze preview podporuje spouštění v prostředích CI/CD. To znamená, že můžete v kanálech CI/CD použít rozhraní příkazového řádku pro vývojáře Microsoft Store (Preview) například k automatickému publikování aplikací do Microsoft Store.
Prvním krokem k jeho dosažení je instalace rozhraní příkazového řádku pro vývojáře Microsoft Store (Preview) do prostředí CI/CD. Pokyny, jak to udělat, najdete tady.
Po instalaci rozhraní příkazového řádku pro vývojáře Microsoft Store (Preview) musíte nakonfigurovat prostředí tak, aby bylo možné spouštět příkazy. Můžete to provést spuštěním msstore reconfigure příkazu s konkrétními parametry, které identifikují váš účet v Partnerském centru (TenantId, SellerId, ClientId). Potřebujete také zadat klientskousecretu nebo certifikát.
Je velmi důležité tyto přihlašovací údaje skrýt, protože budou viditelné v protokolech vašeho kanálu CI/CD. Můžete to udělat pomocí tajných kódů. Každý systém kanálů CI/CD má pro tyto tajné kódy různé názvy. Například Azure DevOps je nazývá Tajné proměnné, ale GitHub Actions je nazývá Šifrovaná tajemství. Vytvořte jeden tajný kód pro každý z parametrů (TenantId, SellerId, ClientId a ClientSecret nebo Certifikát) a pak pomocí reconfigure příkazu nastavte prostředí.
Například:
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 }}
Po spuštění tohoto příkazu se rozhraní příkazového řádku pro vývojáře Microsoft Store (Preview) nakonfiguruje tak, aby používalo zadané přihlašovací údaje. Teď můžete použít rozhraní příkazového řádku pro vývojáře Microsoft Store (Předběžná verze) ve vašem kanálu CI/CD.
