Sdílet prostřednictvím

Příkazy

Instalace

Krok 1: Instalace prostředí .NET Windows Runtime

Pokud jste to ještě neudělali, nainstalujte nejnovější verzi prostředí .NET 8 Desktop Runtime. Toto je požadavek na spuštění rozhraní příkazového řádku pro vývojáře v Microsoft Storu.

Nejjednodušší způsob, jak ho nainstalovat, je použít winget:

winget install Microsoft.DotNet.DesktopRuntime.8

Krok 2: Instalace rozhraní příkazového řádku pro vývojáře v Microsoft Storu ve Windows

Rozhraní příkazového řádku pro vývojáře 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 modulu runtime .NET macOS

Pokud jste to ještě neudělali, nainstalujte nejnovější verzi modulu runtime .NET 8. Toto je požadavek na spuštění rozhraní příkazového řádku pro vývojáře v Microsoft Storu.

Krok 2: Instalace rozhraní příkazového řádku pro vývojáře v Microsoft Storu v macOS

Můžete si stáhnout soubor .tar.gz pro macOS pro vaši konkrétní architekturu (x64 nebo Arm64) ze stránky vydání 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 prostředí .NET Linux Runtime

Pokud jste to ještě neudělali, nainstalujte nejnovější verzi modulu runtime .NET 8. Toto je požadavek na spuštění rozhraní příkazového řádku pro vývojáře v Microsoft Storu.

Krok 2: Instalace rozhraní příkazového řádku pro vývojáře v Microsoft Storu v Linuxu

Linuxový .tar.gz pro vaši konkrétní architekturu (x64 nebo Arm64) si můžete stáhnout ze stránky vydaných verzí rozhraní příkazového řádku pro vývojáře v Microsoft Storu. 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.

Příkaz Info – použití

msstore info

Příkaz Informace – možnosti

Možnost Popis
-v, --verbose (podrobnosti) Vytisknout podrobný výstup

Překonfigurovat příkaz

Znovu nakonfigurujte rozhraní příkazového řádku pro vývojáře v Microsoft Storu. 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).

Změna konfigurace – využití

msstore reconfigure

Změna konfigurace – 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 Zadejte heslo certifikátu, které se má použít.
--resetovat Resetujte jenom přihlašovací údaje, aniž byste museli začít znovu.

Příkaz Nastavení

Změňte nastavení rozhraní příkazového řádku pro vývojáře v Microsoft Storu.

Nastavení – využití

msstore settings
Sub-Command Popis
setPDN Nastavte vlastnost Zobrazovaný název vydavatele, kterou používá příkaz init.

Nastavení – Možnosti

Možnost Popis
-t, --povolitTelemetrii Povolte (prázdné/true) nebo zakažte (false) telemetrii.
-v, --verbose (podrobnosti) Vytisknout podrobný výstup

Nastavení – Použití příkazů SetPDN

msstore settings setpdn <publisherDisplayName>

Argumenty

Důvod Popis
publisherDisplayName Vlastnost Zobrazovaný název vydavatele, která bude nastavena globálně.

Pomoc

msstore settings setpdn --help

Příkazy aplikací

Sub-Command Popis
seznam Zobrazí seznam všech aplikací ve vašem účtu.
dostat Získá podrobnosti konkrétní aplikace.

Aplikace – Používání příkazů seznamu

msstore apps list

Příkaz Seznam – nápověda

msstore apps list --help

Aplikace – Použití příkazů

msstore apps get <productId>

Aplikace – získání argumentů příkazů

Důvod Popis
productId ID produktu.

Aplikace – Získání nápovědy k příkazům

msstore apps get --help

Příkaz odeslání

Sub-Command Popis
stav Získá stav odeslání.
dostat Získá podrobnosti o konkrétním předložení.
getListingAssets Získá seznam aktiv určitého podání.
Aktualizační metadata Aktualizuje metadata konkrétního odeslání.
aktualizace Aktualizuje podrobnosti o konkrétním předání.
hlasování Zjišťuje stav odeslání.
publikovat Publikuje konkrétní příspěvek.
vymazat Odstraní konkrétní příspěvek.

Odeslání – použití příkazu stavu

msstore submission status <productId>

Odeslání – argumenty příkazu stavu

Důvod Popis
productId ID produktu.

Podání – nápověda k příkazu pro zobrazení stavu

msstore submission status --help

Odeslání - Získání informace o využití příkazů

msstore submission get <productId>

Odeslání – získání argumentů příkazu

Důvod Popis
productId ID produktu.

Odeslání – Získání možností příkazu

Možnost Popis
-m, --modul Vyberte modul, který chcete načíst (dostupnost, výpisy nebo vlastnosti).
-l, --jazyk Vyberte jazyk, který chcete načíst. [Výchozí: česky]

Odeslání – Získání nápovědy k příkazu

msstore submission get --help

Odeslání – Použití příkazu GetListingAssets

Načte existující prostředky konceptu výpisu z podání do obchodu.

msstore submission getListingAssets <productId>

Odeslání – argumenty příkazu GetListingAssets

Důvod Popis
productId ID produktu.

Odeslání – Možnosti příkazu GetListingAssets

Možnost Popis
-l, --jazyk Vyberte jazyk, který chcete načíst. [Výchozí: česky]

Odeslání – Nápověda k příkazu GetListingAssets

msstore submission getListingAssets --help

Odeslání – použití příkazu UpdateMetadata

msstore submission updateMetadata <productId> <metadata>

Odeslání – argumenty příkazu UpdateMetadata

Důvod Popis
productId ID produktu.
metadata Aktualizovaná reprezentace metadat JSON.

Odeslání – Možnosti příkazu UpdateMetadata

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]

Odeslání – Nápověda k příkazu UpdateMetadata

msstore submission updateMetadata --help

Odeslání – aktualizace použití příkazů

msstore submission update <productId> <product>

Odeslání – aktualizace argumentů příkazu

Důvod Popis
productId ID produktu.
product Aktualizovaná reprezentace produktu JSON.

Odeslání – Možnosti Aktualizačního Příkazu

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]

Odeslání – nápověda k příkazu aktualizace

msstore submission update --help

Odeslání – použití příkazu hlasování

msstore submission poll <productId>

Odeslání – argumenty příkazu ankety

Důvod Popis
productId ID produktu.

Odeslání – Nápověda k příkazu hlasování

msstore submission poll --help

Odeslání – použití publikačního příkazu

msstore submission publish <productId>

Odeslání – publikování argumentů příkazu

Důvod Popis
productId ID produktu.

Odeslání – Nápověda k příkazu publikování

msstore submission publish --help

Odeslání – Odstranění využití příkazů

Odstraní čekající odeslání z úložiště.

Odeslání – odstranění argumentů příkazu

Důvod Popis
productId ID produktu.

Odeslání – Možnosti příkazu Odstranit

Možnost Popis
--no-potvrzení Nevyzývejte k potvrzení. [výchozí: Nepravda]

Odeslání – Nápověda k příkazu Odstranit

msstore submission delete --help

Inicializační příkaz

Tento init příkaz vám pomůže nastavit aplikaci pro publikování do Microsoft Storu. V současné době podporuje následující typy aplikací:

  • Sada SDK aplikací pro systém Windows / WinUI 3
  • Univerzální platforma Windows (UWP)
  • .NET MAUI
  • Třepetat
  • Elektron
  • React Native pro stolní počítače
  • PWA

Inicializační příkaz – příklady použití

Inicializační příkaz – Windows App SDK/WinUI 3

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

Inicializační příkaz – UPW

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

Inicializační příkaz – .NET MAUI

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

Inicializační příkaz – Flutter

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

Init Command - Elektron

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

Inicializační příkaz – React Native for Desktop

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í.

Inicializační příkaz – PWA

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

Inicializační příkaz – 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.

Inicializační příkaz – možnosti

Možnost Popis
-n, --publisherDisplayName (zobrazované jméno vydavatele) Zobrazovaný název vydavatele použitý ke 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, --packageRolloutPercentage 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, --verze 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á zabalit aplikaci Microsoft Store jako MSIX.

Příkaz balíčku – příklady použití

Příkaz balíčku – Windows App SDK/ WinUI 3

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

Příkaz Balíček – UPW

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

Příkaz balíčku – .NET MAUI

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

Příkaz Package – Flutter

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

Příkaz balíčku – Elektron

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

Příkaz balíčku – React Native for Desktop

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

Příkaz balíčku – PWA

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

Příkaz Package – 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.

Příkaz Balíček – 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, --verze 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 Storu.

Příkaz Publikovat – příklady použití

Příkaz Publikovat – Windows App SDK/WinUI 3

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

Příkaz Publikovat – UPW

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

Příkaz Publikovat – .NET MAUI

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

Příkaz Publikovat – Flutter

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

Příkaz publikování - Electron

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

Příkaz Publikovat – React Native for Desktop

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

Příkaz Publikovat – PWA

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

Příkaz Publikovat – 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.

Příkaz Publikovat – možnosti

Možnost Popis
-i, --vstupníAdresář Adresář, kde se má použít soubor .msix nebo .msixupload 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 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, --procentoRozbaleniBalicku Určuje procento uvedení balíčku. Hodnota musí být v rozmezí od 0 do 100.

Prostředí CI/CD

Rozhraní příkazového řádku Microsoft Store (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 Microsoft Storu (preview) k automatickému publikování aplikací do Microsoft Store.

Prvním krokem k dosažení tohoto cíle je instalace Microsoft Store Developer CLI (Preview) v prostředí CI/CD. Pokyny, jak to udělat, najdete tady.

Po instalaci rozhraní příkazového řádku pro vývojáře v Microsoft Storu (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. Azure DevOps je například označuje jako 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

Akce na GitHubu

- 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 }}

Po spuštění tohoto příkazu se rozhraní příkazového řádku microsoft Storu (Preview) nakonfiguruje tak, aby používalo zadané přihlašovací údaje. V kanálu CI/CD teď můžete použít rozhraní příkazového řádku Microsoft Storu (náhled).