Udostępnij przez

Polecenia (MSIX)

Instalacja

Krok 1: Zainstaluj środowisko wykonawcze .NET dla Windows

Jeśli jeszcze tego nie zrobiłeś, zainstaluj najnowszą wersję .NET 9 Desktop Runtime. Jest to wymagane do uruchomienia interfejsu wiersza polecenia dla deweloperów sklepu Microsoft Store.

Najprostszym sposobem instalacji jest użycie zestawu winget:

winget install Microsoft.DotNet.DesktopRuntime.9

Krok 2. Instalowanie interfejsu wiersza polecenia dewelopera sklepu Microsoft Store w systemie Windows

Interfejs wiersza polecenia dla deweloperów sklepu Microsoft Store można pobrać ze sklepu Microsoft Store. Alternatywnie można użyć winget:

winget install "Microsoft Store Developer CLI"

Krok 1. Instalowanie środowiska uruchomieniowego .NET macOS

Jeśli jeszcze tego nie zrobiono, zainstaluj najnowszą wersję środowiska uruchomieniowego platformy .NET 9. Jest to wymagane do uruchomienia interfejsu wiersza polecenia dla deweloperów sklepu Microsoft Store.

Krok 2. Instalowanie CLI dewelopera Microsoft Store na systemie macOS

Możesz pobrać .tar.gz systemu macOS dla określonej architektury (x64 lub Arm64) ze strony z wydaniami Microsoft Store Developer CLI . Po pobraniu wyodrębnij archiwum i umieść je w ścieżce systemowej, w sposób, który preferujesz, na przykład:

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

Alternatywnie możesz użyć komendy brew:

brew install microsoft/msstore-cli/msstore-cli

Krok 1. Instalowanie środowiska uruchomieniowego .NET Linux

Jeśli jeszcze tego nie zrobiono, zainstaluj najnowszą wersję środowiska uruchomieniowego platformy .NET 9. Jest to wymagane do uruchomienia interfejsu wiersza polecenia dla deweloperów sklepu Microsoft Store.

Krok 2. Instalowanie interfejsu wiersza polecenia dewelopera sklepu Microsoft Store w systemie Linux

Możesz pobrać .tar.gz systemu Linux dla określonej architektury (x64 lub Arm64) ze strony wydań interfejsu wiersza polecenia dla deweloperów Microsoft Store. Po pobraniu wyodrębnij archiwum i umieść je w ścieżce systemowej, w sposób, który preferujesz, na przykład:

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

Alternatywnie możesz użyć komendy brew:

brew install microsoft/msstore-cli/msstore-cli

Polecenie Info

Drukuj istniejącą konfigurację.

Usage

msstore info

Opcje

Opcja Opis
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Ponowne konfigurowanie polecenia

Ponownie skonfiguruj Microsoft Store Developer CLI. Możesz podać klucz tajny klienta lub certyfikat. Certyfikaty mogą być udostępniane za pomocą odcisku palca lub przez podanie ścieżki pliku (z hasłem lub bez tego hasła).

Usage

msstore reconfigure

Opcje

Opcja Opis
-t, --idNajemcy Określ identyfikator dzierżawy, który ma być używany.
-s, --sellerId (identyfikator sprzedawcy) Określ identyfikator sprzedawcy, który ma być używany.
-c, --Identyfikator klienta Określ identyfikator klienta, który ma być używany.
-cs, --clientSecret (tajny klucz klienta) Określ klucz tajny klienta, który ma być używany.
-ct, --certificateThumbprint (odcisk palca certyfikatu) Określ odcisk palca certyfikatu, który ma być używany.
-cfp, --certificateFilePath Określ ścieżkę pliku certyfikatu, która ma być używana.
-cp, --hasłoCertyfikatu Określ hasło certyfikatu, które ma być używane.
--resetować Zresetuj tylko poświadczenia bez rozpoczynania pracy.
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Ustawienia polecenie

Zmień ustawienia w narzędziu dla deweloperów Microsoft Store CLI.

Usage

msstore settings

Opcje

Opcja Opis
-t, --włączTelemetrykę Włącz (puste/prawda) lub wyłącz (fałsz) dane telemetryczne.
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Polecenie podrzędne SetPDN

Ustaw właściwość Nazwa wyświetlana wydawcy, która jest używana przez komendę init.

Usage

msstore settings setpdn <publisherDisplayName>

Argumenty (w programowaniu)

Argumentacja Opis
publisherDisplayName Właściwość Nazwa wyświetlana wydawcy, która zostanie ustawiona globalnie.

Opcje

Opcja Opis
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Polecenie aplikacji

Sub-Command Opis
lista Wyświetla listę wszystkich aplikacji na twoim koncie.
Pobierz Pobiera szczegóły określonej aplikacji.

Aplikacje — lista — użycie

msstore apps list

Opcje

Opcja Opis
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Aplikacje — pobieranie — użycie

msstore apps get <productId>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu sklepu.

Opcje

Opcja Opis
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Polecenie przesyłania

Sub-Command Opis
stan Pobiera status zgłoszenia.
Pobierz Pobiera metadane oraz informacje o pakiecie określonego zgłoszenia.
getListingAssets Pobiera zasoby zgłoszenia określonego zgłoszenia.
aktualizujMetadane Aktualizuje metadane określonego przesłania.
sondaż Sprawdza status zgłoszenia.
publikować Publikuje określone zgłoszenie.
usuwanie Usuwa określone zgłoszenie.

Przesyłanie — stan — użycie

msstore submission status <productId>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu sklepu.

Opcje

Opcja Opis
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Przesyłanie — pobieranie — użycie

msstore submission get <productId>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu sklepu.

Opcje

Opcja Opis
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Przesyłanie — GetListingAssets — Użycie

msstore submission getListingAssets <productId>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu sklepu.

Opcje

Opcja Opis
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Przesyłanie — UpdateMetadata — użycie

msstore submission updateMetadata <productId> <metadata>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu sklepu.
metadata Zaktualizowana reprezentacja metadanych JSON.

Opcje

Opcja Opis
-s, --skipInitialPolling (pomiń początkowe odpytywanie) Pomiń wstępne sondowanie przed wykonaniem akcji. [wartość domyślna: Fałsz]
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Przesyłanie — ankieta — użycie

msstore submission poll <productId>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu sklepu.

Opcje

Opcja Opis
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Przesyłanie — publikowanie — użycie

msstore submission publish <productId>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu sklepu.

Opcje

Opcja Opis
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Przesyłanie — usuwanie — użycie

msstore submission delete <productId>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu sklepu.

Opcje

Opcja Opis
--no-confirm Nie monituj o potwierdzenie. [wartość domyślna: Fałsz]
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Komenda lotów

Sub-Command Opis
lista Pobiera wszystkie loty dla określonej aplikacji.
Pobierz Pobiera lot dla określonej aplikacji i zadanego lotu.
usuwanie Usuwa lot dla określonej aplikacji i dla danego lotu.
create Tworzy lot dla określonej aplikacji i lotu testowego.
Złożenia Wykonaj zadania związane z przesyłaniem danych dotyczących lotów.

Loty — wyświetlanie listy użycia poleceń

msstore flights list <productId>

Loty — wyświetlanie listy argumentów poleceń

Argumentacja Opis
productId Identyfikator produktu.

Loty — Lista poleceń Pomoc dotycząca poleceń

msstore flights list --help

Funkcje lotów — wykorzystanie polecenia 'get'

msstore flights get <productId> <flightId>

Loty — uzyskiwanie argumentów poleceń

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Loty — Uzyskiwanie pomocy dotyczącej poleceń

msstore flights get --help

Loty — usuwanie użycia poleceń

msstore flights delete <productId> <flightId>

Loty — usuwanie argumentów poleceń

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Loty — Pomoc dotycząca polecenia usuwania

msstore flights delete --help

Loty — tworzenie poleceń użycia

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

Loty — tworzenie argumentów poleceń

Argumentacja Opis
productId Identyfikator produktu.
friendlyName Przyjazna nazwa lotu.

Loty — konfiguracja opcji poleceń

Opcja Opis
-g, --group-ids Identyfikatory grup do powiązania z lotem.
-r, --ocen-wyżej-niż Identyfikator lotu powinien być sklasyfikowany wyżej niż.

Loty — Pomoc do tworzenia polecenia

msstore flights create --help

Loty — polecenie przesyłania

Sub-Command Opis
Pobierz Pobiera istniejące zgłoszenie przesyłki lotu pakietu, niezależnie czy jest to wersja robocza, czy ostatnia opublikowana.
usuwanie Usuwa oczekujące zgłoszenie lotu pakietu ze sklepu.
aktualizacja Aktualizuje istniejącą wersję roboczą lotu za pomocą podanego JSON-a.
publikować Rozpoczyna proces przesyłania danych lotu dla istniejącego szkicu.
sondaż Monitoruje do momentu opublikowania lub niepowodzenia przesłania aktualnego zgłoszenia lotu.
stan Pobiera bieżący stan przesłania pakietu testowego sklepu.
Wdrożenie Wykonaj operacje związane z wdrażaniem fazy testowej.

Loty — przesyłanie pobierz użycie polecenia

msstore flights submission get <productId> <flightId>

Komendy - Przesyłanie argumentów polecenia Get

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Loty — przesyłanie — uzyskiwanie pomocy dotyczącej poleceń

msstore flights submission get --help

Loty — użycie polecenia "Usuń Przesyłkę"

msstore flights submission delete <productId> <flightId>

Loty — Argumenty polecenia usunięcia zgłoszenia

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Loty — Pomoc dotycząca polecenia usuwania

msstore flights submission delete --help

Loty — użycie polecenia aktualizacji zgłoszenia

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

Loty — argumenty poleceń aktualizacji przesyłania

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.
product Zaktualizowana reprezentacja produktu JSON.

Loty — opcje poleceń aktualizacji zgłoszenia

Opcja Opis
-s, --skipInitialPolling (pomiń początkowe odpytywanie) Pomiń wstępne sondowanie przed wykonaniem akcji. [wartość domyślna: Fałsz]

Loty — polecenie aktualizacji składania - pomoc

msstore flights submission update --help

Loty — użycie komendy publikacji zgłoszeń

msstore flights submission publish <productId> <flightId>

Loty — argumenty polecenia publikowania zgłoszenia

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Flights - pomoc dotycząca publikowania komendy

msstore flights submission publish --help

Loty — użycie polecenia ankiety przesyłania

msstore flights submission poll <productId> <flightId>

Argumenty polecenia głosowania w przesyłaniu - Loty

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Loty — pomoc dotycząca polecenia przesyłania sondy

msstore flights submission poll --help

Loty — użycie polecenia stanu przesyłania

msstore flights submission status <productId> <flightId>

Loty — argumenty poleceń stanu przesyłania

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Loty — Pomoc dotycząca polecenia statusu zgłoszenia

msstore flights submission status --help

Loty — przesyłanie — polecenie wprowadzania

Sub-Command Opis
Pobierz Pobiera stan wdrożenia wersji próbnej zgłoszenia.
aktualizacja Zaktualizuj procent docelowego wdrożenia zgłoszenia.
Zatrzymaj Wstrzymuje etapowe wdrożenie zgłoszenia.
Finalize Finalizuje wdrażanie etapowe wdrożenia wersji próbnej.

Loty — wdrażanie — pobieranie informacji o użyciu poleceń

msstore flights submission rollout get <productId> <flightId>

Loty — przesyłanie — wprowadzanie argumentów polecenia Get

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Loty — zatwierdzenie — wdrażanie opcji polecenia Get

Opcja Opis
-s, --submissionId Identyfikator przesyłania.

Loty — przesyłanie — wdrażanie — uzyskiwanie pomocy dotyczącej poleceń

msstore flights submission rollout get --help

Loty — przesyłanie — użycie polecenia aktualizacji wdrożenia

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

Loty — przesyłanie — argumenty poleceń aktualizacji wdrożenia

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.
percentage Procent użytkowników, którzy otrzymają wdrożenie funkcji przesyłania.

Loty — zgłaszanie — opcje poleceń aktualizacji wdrożenia

Opcja Opis
-s, --submissionId (identyfikator przesłania) Identyfikator przesyłania.

Loty — Przekazywanie — Pomoc dotycząca polecenia aktualizacji wdrożeniowej

msstore flights submission rollout update --help

Loty — Złożenie — Wstrzymanie Wykonywania Polecenia

msstore flights submission rollout halt <productId> <flightId>

Loty — przesyłanie — wprowadzania argumentów poleceń zatrzymania

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Loty — przesyłanie — opcje polecenia zatrzymania wprowadzania

Opcja Opis
-s, --submissionId Identyfikator przesyłania.

Loty — przesyłanie — pomoc dotycząca wstrzymania wdrożenia poleceń

msstore flights submission rollout halt --help

Loty — przesyłanie — finalizacja użycia poleceń

msstore flights submission rollout finalize <productId> <flightId>

Loty — przesyłanie — finalizowanie argumentów poleceń wdrożenia

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Loty — zgłoszenie — finalizowanie opcji poleceń wdrożeniowych

Opcja Opis
-s, --submissionId Identyfikator przesyłania.

Loty — przesyłanie — finalizowanie pomocy dotyczącej poleceń wdrażania

msstore flights submission rollout finalize --help

Komenda Init

Polecenie init ułatwia skonfigurowanie aplikacji w celu opublikowania w sklepie Microsoft Store. Obecnie obsługuje on następujące typy aplikacji:

  • Zestaw SDK aplikacji systemu Windows/WinUI 3
  • platforma UWP
  • .NET MAUI
  • Trzepotać
  • Elektron
  • React Native dla komputerów stacjonarnych
  • PWA

Przykłady użycia

Zestaw SDK aplikacji systemu Windows/WinUI 3

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

platforma UWP

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

.NET MAUI

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

Trzepotać

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

Elektron

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

React Native dla komputerów stacjonarnych

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

Uwaga / Notatka

W przypadku Electron, a także React Native dla projektów desktopowych, zarówno Npm, jak i Yarn są obsługiwane. Obecność pliku blokady Yarn (yarn.lock) zostanie użyta do określenia menedżera pakietów do użycia, dlatego upewnij się, że plik blokady jest zaewidencjonowyny w systemie kontroli źródła.

PWA

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

Argumenty (w programowaniu)

Argumentacja Opis
pathOrUrl Ścieżka katalogu głównego, w którym znajduje się plik projektu, lub publiczny adres URL prowadzący do PWA.

Opcje

Opcja Opis
-n, --nazwaWyświetlanaWydawcy Nazwa wydawcy wyświetlana podczas konfigurowania aplikacji. Jeśli jest to podane, unika dodatkowego wywołania interfejsów API.
--pakiet Jeśli typ aplikacji jest obsługiwany, automatycznie pakuje projekt.
--publikować Jeśli typ aplikacji jest obsługiwany, automatycznie publikuje projekt. Implikuje wartość "--package true"
-f, --identyfikatorLotu Określa identyfikator lotu, gdzie zostanie opublikowany pakiet.
-prp, --procentWdrażaniaPakietu Określa procent wdrożenia pakietu. Wartość musi należeć do zakresu od 0 do 100.
Opcje linii poleceń: -a, --arch Architektury, dla których należy budować. Jeśli nie zostanie podana, zostanie użyta domyślna architektura bieżącego systemu operacyjnego i typu projektu. Dozwolone wartości: "x86", "x64", "arm64". Użyto go tylko w połączeniu z '--package true'.
-o, --wyjście Katalog wyjściowy, w którym będzie przechowywana spakowana aplikacja. Jeśli nie zostanie podany, zostanie użyty domyślny katalog dla każdego innego typu aplikacji.
-ver (wersja), --version (wersja) Wersja używana podczas kompilowania aplikacji. Jeśli nie zostanie podana, zostanie użyta wersja z pliku projektu.

Komenda pakietu

Ułatwia spakowanie aplikacji ze sklepu Microsoft Store jako pliku MSIX.

Przykłady użycia

Zestaw SDK aplikacji systemu Windows/WinUI 3

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

platforma UWP

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

.NET MAUI

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

Trzepotać

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

Elektron

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

React Native dla komputerów stacjonarnych

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

PWA

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

Argumenty (w programowaniu)

Opcja Opis
pathOrUrl Ścieżka katalogu głównego, w którym znajduje się plik projektu, lub publiczny adres URL prowadzący do PWA.

Opcje

Opcja Opis
-o, --wyjście Katalog wyjściowy, w którym będzie przechowywana spakowana aplikacja. Jeśli nie zostanie podany, zostanie użyty domyślny katalog dla każdego innego typu aplikacji.
Opcje linii poleceń: -a, --arch Architektury, dla których należy budować. Jeśli nie zostanie podana, zostanie użyta domyślna architektura bieżącego systemu operacyjnego i typu projektu. Dozwolone wartości: "x86", "x64", "arm64".
-ver (wersja), --version (wersja) Wersja używana podczas kompilowania aplikacji. Jeśli nie zostanie podana, zostanie użyta wersja z pliku projektu.

Polecenie opublikowania

Publikuje aplikację w sklepie Microsoft Store.

Przykłady użycia

Zestaw SDK aplikacji systemu Windows/WinUI 3

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

platforma UWP

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

.NET MAUI

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

Trzepotać

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

Elektron

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

React Native dla komputerów stacjonarnych

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

PWA

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

Argumenty (w programowaniu)

Opcja Opis
pathOrUrl Ścieżka katalogu głównego, w którym znajduje się plik projektu, lub publiczny adres URL prowadzący do PWA.

Opcje

Opcja Opis
-i, --inputFile (plik wejściowy) Ścieżka do pliku ".msix" lub ".msixupload", który ma być użyty w poleceniu publikowania. Jeśli nie zostanie podany, CLI spróbuje znaleźć najlepszego kandydata na podstawie argumentu "pathOrUrl".
-id, --appId Określa identyfikator aplikacji. Wymagane tylko wtedy, gdy projekt nie został zainicjowany wcześniej za pomocą polecenia "init".
-nc, --noCommit Wyłącza zatwierdzanie przesyłania, zachowując stan wersji roboczej.
-f, --identyfikatorLotu Określa identyfikator lotu, gdzie zostanie opublikowany pakiet.
-prp, --procentWdrażaniaPakietu Określa procent wdrożenia pakietu. Wartość musi należeć do zakresu od 0 do 100.

Komenda lotów

Sub-Command Opis
lista Pobiera wszystkie loty dla określonej aplikacji.
Pobierz Pobiera lot dla określonej aplikacji i zadanego lotu.
usuwanie Usuwa lot dla określonej aplikacji i dla danego lotu.
create Tworzy lot dla określonej aplikacji i lotu testowego.
Złożenia Wykonaj zadania związane z przesyłaniem danych dotyczących lotów.

Loty — lista — użycie

msstore flights list <productId>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu.

Opcje

Opcja Opis
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Loty — pobierz — użycie

msstore flights get <productId> <flightId>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Opcje

Opcja Opis
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Loty — usuwanie — użycie

msstore flights delete <productId> <flightId>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Opcje

Opcja Opis
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Loty — tworzenie — użycie

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

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu.
friendlyName Przyjazna nazwa lotu.

Opcje

Opcja Opis
-g, --group-ids Identyfikatory grup do powiązania z lotem.
-r, --ocen-wyżej-niż Identyfikator lotu powinien być sklasyfikowany wyżej niż.
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Loty — zgłoszenie

Sub-Command Opis
Pobierz Pobiera istniejące zgłoszenie przesyłki lotu pakietu, niezależnie czy jest to wersja robocza, czy ostatnia opublikowana.
usuwanie Usuwa oczekujące zgłoszenie lotu pakietu ze sklepu.
aktualizacja Aktualizuje istniejącą wersję roboczą lotu za pomocą podanego JSON-a.
publikować Rozpoczyna proces przesyłania danych lotu dla istniejącego szkicu.
sondaż Monitoruje do momentu opublikowania lub niepowodzenia przesłania aktualnego zgłoszenia lotu.
stan Pobiera bieżący stan przesłania pakietu testowego sklepu.
Wdrożenie Wykonaj operacje związane z wdrażaniem fazy testowej.

Loty — przesyłanie — pobieranie — użycie

msstore flights submission get <productId> <flightId>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Opcje

Opcja Opis
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Loty — zgłaszanie — usuwanie — wykorzystanie

msstore flights submission delete <productId> <flightId>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Opcje

Opcja Opis
--no-confirm Nie monituj o potwierdzenie.
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Loty — zgłoszenie — aktualizacja — wykorzystanie

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

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.
product Zaktualizowana reprezentacja produktu JSON.

Opcje

Opcja Opis
-s, --skipInitialPolling (pomiń początkowe odpytywanie) Pomiń wstępne sondowanie przed wykonaniem akcji. [wartość domyślna: Fałsz]
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Loty — zgłaszanie — publikacja — wykorzystanie

msstore flights publish <productId> <flightId>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Opcje

Opcja Opis
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Loty — zgłoszenie — ankieta — zastosowanie

msstore flights poll <productId> <flightId>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Opcje

Opcja Opis
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Loty — zgłoszenie — status — użycie

msstore flights status <productId> <flightId>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Opcje

Opcja Opis
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Loty — zgłaszanie — wdrażanie

Sub-Command Opis
Pobierz Pobiera stan wdrożenia wersji próbnej zgłoszenia.
aktualizacja Zaktualizuj procent docelowego wdrożenia zgłoszenia.
Zatrzymaj Wstrzymuje etapowe wdrożenie zgłoszenia.
Finalize Finalizuje wdrażanie etapowe wdrożenia wersji próbnej.

Loty — zgłaszanie — wdrażanie — pobierz — wykorzystanie

msstore flights submission rollout get <productId> <flightId>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Opcje

Opcja Opis
-s, --submissionId Identyfikator przesyłania.
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Loty — zgłaszanie — wdrażanie — aktualizacja — zastosowanie

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

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.
percentage Procent użytkowników, którzy otrzymają wdrożenie funkcji przesyłania.

Opcje

Opcja Opis
-s, --submissionId Identyfikator przesyłania.
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Loty — przesyłanie — wdrożenie — zatrzymanie — zastosowanie

msstore flights submission rollout halt <productId> <flightId>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Opcje

Opcja Opis
-s, --submissionId Identyfikator przesyłania.
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Loty — przesyłanie — wdrażanie — finalizacja — użycie

msstore flights submission rollout finalize <productId> <flightId>

Argumenty (w programowaniu)

Argumentacja Opis
productId Identyfikator produktu.
flightId Identyfikator lotu.

Opcje

Opcja Opis
-s, --submissionId Identyfikator przesyłania.
-v, --szczegółowy Drukuj rozszerzone dane wyjściowe.
-?, -h, --help Pokaż pomoc i informacje dotyczące użycia.

Środowiska CI/CD

Deweloperski interfejs wiersza polecenia Microsoft Store (wersja zapoznawcza) obsługuje uruchamianie w środowiskach CI/CD. Oznacza to, że w swoich potokach CI/CD możesz użyć Microsoft Store Developer CLI (wersja zapoznawcza) do automatycznego publikowania aplikacji w sklepie Microsoft Store.

Pierwszym krokiem do osiągnięcia tego jest zainstalowanie developerskiego CLI Microsoft Store (wersja zapoznawcza) w Twoim środowisku CI/CD. Instrukcje, jak to wykonać , można znaleźć tutaj.

Po zainstalowaniu interfejsu wiersza polecenia dla deweloperów sklepu Microsoft Store (wersja zapoznawcza) musisz skonfigurować środowisko, aby móc uruchamiać polecenia. Możesz to zrobić, uruchamiając msstore reconfigure polecenie z określonymi parametrami identyfikującymi konto Centrum partnerskiego (TenantId, SellerId, ClientId). Należy również podać wartość ClientSecret lub Certificate.

Ukrycie tych poświadczeń jest bardzo ważne, ponieważ będą one widoczne w dziennikach potoku CI/CD. Możesz to zrobić, używając tajemnic. Każdy system potoku CI/CD ma różne nazwy dla tych sekretów. Na przykład usługa Azure DevOps wywołuje je zmienne tajne, ale GitHub Action nazywa je zaszyfrowane tajemnice. Utwórz jeden wpis tajny dla każdego z parametrów (TenantId, SellerId, ClientId i ClientSecret lub Certificate), a następnie użyj reconfigure polecenia , aby skonfigurować środowisko.

Przykład:

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 wykonaniu tego polecenia, CLI deweloperów Microsoft Store (wersja zapoznawcza) zostanie skonfigurowane do użycia podanych poświadczeń. Możesz użyć CLI dewelopera Microsoft Store (wersja zapoznawcza) w potoku CI/CD teraz.

  • Last updated on