Příkazy (MSIX)

Instalace

winget install Microsoft.DotNet.DesktopRuntime.9

winget install "Microsoft Store Developer CLI"

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

brew install microsoft/msstore-cli/msstore-cli

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

brew install microsoft/msstore-cli/msstore-cli

Informační příkaz

Vytiskněte existující konfiguraci.

Usage

msstore info

Možnosti

Překonfigurovat příkaz

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

Příkaz Nastavení

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

Usage

msstore settings

Možnosti

SetPDN Sub-příkaz

Nastavte vlastnost Zobrazovaný název vydavatele, kterou používá příkaz init.

Usage

msstore settings setpdn <publisherDisplayName>

Argumenty

Možnosti

Příkazy aplikací

Aplikace – Seznam – Využití

msstore apps list

Možnosti

Aplikace – Získání – Využití

msstore apps get <productId>

Argumenty

Možnosti

Příkaz odeslání

Odeslání – stav – Využití

msstore submission status <productId>

Argumenty

Možnosti

Odeslání – získání – využití

msstore submission get <productId>

Argumenty

Možnosti

Odeslání – GetListingAssets – Využití

msstore submission getListingAssets <productId>

Argumenty

Možnosti

Odeslání – AktualizaceMetadat – Využití

msstore submission updateMetadata <productId> <metadata>

Argumenty

Možnosti

Odeslání – aktualizace – využití

msstore submission update <productId> <package>

Argumenty

Možnosti

# 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

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

msstore submission poll <productId>

Argumenty

Možnosti

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

msstore submission publish <productId>

Argumenty

Možnosti

Odeslání – Odstranění – Využití

msstore submission delete <productId>

Argumenty

Možnosti

Příkazy pro lety

Lety – výpis využití příkazů

msstore flights list <productId>

Lety – výpis argumentů příkazů

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ů

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

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ů

Lety – možnosti vytvoření příkazu

Lety – Nápověda k příkazu vytvoření

msstore flights create --help

Lety – Podání příkazu

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í

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í

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í

Lety – příkazové možnosti aktualizace odeslání

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

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í

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í

Stav letu - Nápověda k příkazu pro odeslání

msstore flights submission status --help

Lety: podání: příkaz spuště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í

Lety – Odeslání – Možnosti příkazů nasazení

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í

Lety – Odeslání – Možnosti příkazů aktualizace uvedení

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í

Lety – Odeslání – Možnosti příkazu pro zastavení zavádě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í

Lety – Odeslání – Možnosti finalizace příkazu pro uvedení do provozu

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"

PWA

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

Argumenty

Možnosti

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žnosti

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žnosti

Řízení Letů

Lety – Seznam – Využití

msstore flights list <productId>

Argumenty

Možnosti

Lety – získání – využití

msstore flights get <productId> <flightId>

Argumenty

Možnosti

Lety – Smazání – Využití

msstore flights delete <productId> <flightId>

Argumenty

Možnosti

Lety – vytváření – použití

msstore flights create <productId> <friendlyName> --group-ids <group-ids>

Argumenty

Možnosti

Lety – podání

Lety – Odeslání – Získání – Využití

msstore flights submission get <productId> <flightId>

Argumenty

Možnosti

Lety – Odeslání – Smazání – Použití

msstore flights submission delete <productId> <flightId>

Argumenty

Možnosti

Lety – Odeslání – Aktualizace – Využití

msstore flights submission update <productId> <flightId> <product>

Argumenty

Možnosti

Lety – Odeslání – Publikování – Využití

msstore flights publish <productId> <flightId>

Argumenty

Možnosti

Lety – Odeslání – Hlasování – Využití

msstore flights poll <productId> <flightId>

Argumenty

Možnosti

Lety – Odeslání – Stav – Využití

msstore flights status <productId> <flightId>

Argumenty

Možnosti

Lety – Podání – Nasazení

Lety – Odeslání – Zavedení – Získání – Využití

msstore flights submission rollout get <productId> <flightId>

Argumenty

Možnosti

Lety – Odeslání – Zavedení – Aktualizace – Využití

msstore flights submission rollout update <productId> <flightId> <percentage>

Argumenty

Možnosti

Lety – Odeslání – Zavedení – Zastavení – Využití

msstore flights submission rollout halt <productId> <flightId>

Argumenty

Možnosti

Lety – Odeslání – Uvedení – Dokončení – Využití

msstore flights submission rollout finalize <productId> <flightId>

Argumenty

Možnosti

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.