Příkazy (MSI/EXE)

Installation

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

Můžete stáhnout Rozhraní příkazového řádku pro vývojáře Microsoft Store 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 s verzemi Developer CLI v Microsoft Store. Po stažení extrahujte archiv a vložte ho do PATH, jak chcete, 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 podle svého uvážení, 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

Příkaz info

Vytiskněte existující konfiguraci.

Usage

msstore info

Možnosti

Možnost	Description
-v, --verbose (podrobný výstup)	Tisk podrobného výstupu
-?, -h, --help	Zobrazení informací o nápovědě a využití

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

Usage

msstore reconfigure

Možnosti

Možnost	Description
-t, --tenantId (ID nájemce)	Zadejte ID tenanta, které se má použít.
-s, --sellerId	Zadejte ID prodejce, které se má použít.
-c, --clientId (identifikátor klienta)	Zadejte ID klienta, které se má použít.
-cs, --clientSecret	Zadejte tajný klíč klienta, který se má použít.
-ct, --certificateThumbprint	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.
-v, --verbose (podrobný výstup)	Tisk podrobného výstupu
-?, -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 v Microsoft Storu.

Usage

msstore settings

Možnosti

Možnost	Description
-t, --povolitTelemetrii	Povolte (prázdné/true) nebo zakažte (false) telemetrii.
-v, --podrobný	Tisk podrobného výstupu
-?, -h, --help	Zobrazení informací o nápovědě a využití

SetPDN Sub-příkaz

Nastavte vlastnost názvu vydavatele pro zobrazení.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Argument	Description
publisherDisplayName	Vlastnost Zobrazovaný název vydavatele, která bude nastavena globálně.

Možnosti

Možnost	Description
-?, -h, --help	Zobrazení informací o nápovědě a využití

Příkaz odeslání

Podpříkaz	Description
stav	Získá stav odeslané položky.
získej	Získá metadata a informace o balíčku konkrétního podání.
getListingAssets	Získá seznam aktiv konkrétního příspěvku.
updateMetadata	Aktualizuje metadata konkrétního odeslání.
aktualizace	Aktualizuje informace o balíčku konkrétního odeslání.
anketa	Kontroluje podání.
publikovat	Publikovat konkrétní příspěvek.

Odeslání – stav – Využití

msstore submission status <productId>

Arguments

Argument	Description
productId	ID Partnerského centra.

Možnosti

Možnost	Description
-v, --podrobný	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>

Arguments

Argument	Description
productId	ID Partnerského centra.

Možnosti

Možnost	Description
-l, --jazyk	Vyberte jazyk, který chcete načíst. Základní překlad: en Výchozí překlad: en
-v, --podrobný	Tisk podrobného výstupu
-?, -h, --help	Zobrazení informací o nápovědě a využití

Odeslání – GetListingAssets – Využití

msstore submission getListingAssets <productId>

Arguments

Argument	Description
productId	ID Partnerského centra.

Možnosti

Možnost	Description
-l, --language	Vyberte jazyk, který chcete načíst. [default: en]
-v, --verbose (podrobný výstup)	Tiskněte podrobný výstup
-?, -h, --help	Zobrazení informací o nápovědě a využití

Odeslání – AktualizaceMetadat – Využití

msstore submission updateMetadata <productId> <metadata>

Arguments

Argument	Description
productId	ID Partnerského centra.
metadata	Aktualizovaná reprezentace metadat JSON.

Možnosti

Možnost	Description
-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 (podrobný výstup)	Tisk podrobného výstupu
-?, -h, --help	Zobrazení informací o nápovědě a využití

Odeslání – aktualizace – využití

msstore submission update <productId> <package>

Arguments

Argument	Description
productId	ID Partnerského centra.
package	Aktualizovaná reprezentace balíčku aplikace ve formátu JSON.

Možnosti

Možnost	Description
-s, --skipInitialPolling	Před provedením akce přeskočte počáteční dotazování. [výchozí: Nepravda]
-v, --verbose (podrobný výstup)	Tisk podrobného výstupu
-?, -h, --help	Zobrazení informací o nápovědě a využití

Odeslání – hlasování – využití

msstore submission poll <productId>

Arguments

Argument	Description
productId	ID Partnerského centra.

Možnosti

Možnost	Description
-v, --verbose (podrobný výstup)	Tisk podrobného výstupu
-?, -h, --help	Zobrazení informací o nápovědě a využití

Odeslání – publikování – využití

msstore submission publish <productId>

Arguments

Argument	Description
productId	ID Partnerského centra.

Možnosti

Možnost	Description
-v, --verbose (podrobný výstup)	Tisk podrobného výstupu
-?, -h, --help	Zobrazení informací o nápovědě a využití

Prostředí CI/CD

Příkazové rozhraní vývojáře Microsoft Store (ve verzi Preview) podporuje spuš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 obchodu Microsoft (verze preview) k automatickému publikování aplikací do obchodu Microsoft.

Prvním krokem k dosažení tohoto cíle je instalace Microsoft Store Developer CLI (předběžná verze) do 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

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 microsoft Storu (Preview) nakonfiguruje tak, aby používalo zadané přihlašovací údaje. V kanálu CI/CD teď můžete použít Microsoft Store Developer CLI (Preview).