Polecenia (MSIX)

Instalacja

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

Polecenie Info

Drukuj istniejącą konfigurację.

Usage

msstore info

Opcje

Ponowne konfigurowanie polecenia

Skonfiguruj ponownie 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

Ustawienia polecenie

Zmiana ustawień CLI dewelopera Microsoft Store.

Usage

msstore settings

Opcje

Polecenie podrzędne SetPDN

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

Usage

msstore settings setpdn <publisherDisplayName>

Argumenty (w programowaniu)

Opcje

Polecenie aplikacji

Aplikacje — lista — użycie

msstore apps list

Opcje

Aplikacje — pobieranie — użycie

msstore apps get <productId>

Argumenty (w programowaniu)

Opcje

Polecenie przesyłania

Przesyłanie — stan — użycie

msstore submission status <productId>

Argumenty (w programowaniu)

Opcje

Przesyłanie — pobieranie — użycie

msstore submission get <productId>

Argumenty (w programowaniu)

Opcje

Przesyłanie — GetListingAssets — Użycie

msstore submission getListingAssets <productId>

Argumenty (w programowaniu)

Opcje

Przesyłanie — UpdateMetadata — użycie

msstore submission updateMetadata <productId> <metadata>

Argumenty (w programowaniu)

Opcje

Przesyłanie — aktualizacja — użycie

msstore submission update <productId> <package>

Argumenty (w programowaniu)

Opcje

# 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

Przesyłanie — ankieta — użycie

msstore submission poll <productId>

Argumenty (w programowaniu)

Opcje

Przesyłanie — publikowanie — użycie

msstore submission publish <productId>

Argumenty (w programowaniu)

Opcje

Przesyłanie — usuwanie — użycie

msstore submission delete <productId>

Argumenty (w programowaniu)

Opcje

Przesłanie — polecenie wdrożenia

Użyj tych podrzędnych poleceń, aby zarządzać stopniowym wdrażaniem pakietów w przypadku przesyłania nieolatowanego. Aby zarządzać wdrożeniem przeznaczonym dla pakietu testowego, należy zamiast tego użyć polecenia msstore flights submission rollout .

Te polecenia są obsługiwane tylko dla aplikacji MSIX/aplikacji pakietowych. Jeśli identyfikator przesyłania zostanie pominięty, interfejs wiersza polecenia używa oczekującego przesłania aplikacji, wracając do ostatniego opublikowanego. | Podpolecenie | Opis | | -------------------------------------------------------- | -------------------------------------------------- | | get | Pobiera stan publikacji zgłoszenia. | | update | Aktualizuje procent wdrażania zgłoszenia. | | halt | Zatrzymuje wprowadzanie zgłoszenia. | | sfinalizować | Finalizuje wdrożenie zgłoszenia. |

Przesyłanie — użycie polecenia rollout get

msstore submission rollout get <productId>

Przesyłanie — wprowadzanie argumentów polecenia Get

Przesyłanie — wprowadzanie opcji pobierania poleceń

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

msstore submission rollout get --help

Przesyłanie — użycie polecenia aktualizacji wdrożenia

msstore submission rollout update <productId> <percentage>

Przesłanie — argumenty polecenia aktualizacji wdrożenia

Przesyłanie zgłoszenia — opcje polecenia aktualizacji wdrożenia

Zgłoszenie — pomoc dotycząca polecenia aktualizacji wdrożenia

msstore submission rollout update --help

Przesłanie — użycie polecenia zatrzymania wdrażania

msstore submission rollout halt <productId>

Przesłanie — argumenty polecenia zatrzymania wdrażania

Przesyłanie — opcje polecenia zatrzymania wprowadzania

Przesłanie — pomoc dotycząca polecenia wstrzymania wdrożenia

msstore submission rollout halt --help

Przesyłanie — finalizowanie użycia poleceń przez wdrożenie

msstore submission rollout finalize <productId>

Przesłanie — wdrożenie — sfinalizowanie argumentów polecenia

Przesyłanie — finalizowanie opcji poleceń

Przesyłanie — finalizowanie pomocy dotyczącej poleceń

msstore submission rollout finalize --help

Przykład: publikowanie aktualizacji i stopniowe wdrażanie jej

Poniższy przykład programu PowerShell przesyła pakiet, aktualizuje informacje o wydaniu, rozpoczyna wdrażanie od 5%, a następnie je zwiększa i finalizuje.

$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

Polecenia lotów

Loty — wyświetlanie listy użycia poleceń

msstore flights list <productId>

Loty — wyświetlanie listy argumentów poleceń

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ń

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ń

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ń

Loty — konfiguracja opcji poleceń

Loty — Pomoc do tworzenia polecenia

msstore flights create --help

Loty — polecenie przesyłania

Loty — przesyłanie pobierz użycie polecenia

msstore flights submission get <productId> <flightId>

Komendy - Przesyłanie argumentów polecenia Get

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

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

Loty — opcje poleceń aktualizacji zgłoszenia

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

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

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

Loty — Pomoc dotycząca polecenia statusu zgłoszenia

msstore flights submission status --help

Loty — przesyłanie — polecenie wprowadzania

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

msstore flights submission rollout get <productId> <flightId>

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

Loty — zatwierdzenie — wdrażanie opcji polecenia Get

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

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

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

Loty — przesyłanie — opcje polecenia zatrzymania wprowadzania

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

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

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

msstore flights submission rollout finalize --help

Komenda Init

Polecenie init pomaga skonfigurować aplikację do publikowania w Microsoft Store. Obecnie obsługuje on następujące typy aplikacji:

• WinUI
• .NET MAUI
• Trzepotać
• Elektron
• React Native dla komputerów stacjonarnych
• PWA
• platforma UWP

Przykłady użycia

Zestaw SDK do aplikacji systemu Windows/WinUI

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"

PWA

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

Argumenty (w programowaniu)

Opcje

Komenda pakietu

Ułatwia spakowanie aplikacji Microsoft Store jako pliku MSIX.

Przykłady użycia

Zestaw SDK do aplikacji systemu Windows/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"

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)

Opcje

Polecenie opublikowania

Publikuje aplikację w Microsoft Store.

Przykłady użycia

Zestaw SDK do aplikacji systemu Windows/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"

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)

Opcje

Komenda lotów

Loty — lista — użycie

msstore flights list <productId>

Argumenty (w programowaniu)

Opcje

Loty — pobierz — użycie

msstore flights get <productId> <flightId>

Argumenty (w programowaniu)

Opcje

Loty — usuwanie — użycie

msstore flights delete <productId> <flightId>

Argumenty (w programowaniu)

Opcje

Loty — tworzenie — użycie

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

Argumenty (w programowaniu)

Opcje

Loty — zgłoszenie

Loty — przesyłanie — pobieranie — użycie

msstore flights submission get <productId> <flightId>

Argumenty (w programowaniu)

Opcje

Loty — zgłaszanie — usuwanie — wykorzystanie

msstore flights submission delete <productId> <flightId>

Argumenty (w programowaniu)

Opcje

Loty — zgłoszenie — aktualizacja — wykorzystanie

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

Argumenty (w programowaniu)

Opcje

Loty — zgłaszanie — publikacja — wykorzystanie

msstore flights publish <productId> <flightId>

Argumenty (w programowaniu)

Opcje

Loty — zgłoszenie — ankieta — zastosowanie

msstore flights poll <productId> <flightId>

Argumenty (w programowaniu)

Opcje

Loty — zgłoszenie — status — użycie

msstore flights status <productId> <flightId>

Argumenty (w programowaniu)

Opcje

Loty — zgłaszanie — wdrażanie

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

msstore flights submission rollout get <productId> <flightId>

Argumenty (w programowaniu)

Opcje

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

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

Argumenty (w programowaniu)

Opcje

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

msstore flights submission rollout halt <productId> <flightId>

Argumenty (w programowaniu)

Opcje

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

msstore flights submission rollout finalize <productId> <flightId>

Argumenty (w programowaniu)

Opcje

Środowiska CI/CD

Interfejs CLI dewelopera Microsoft Store (wersja zapoznawcza) obsługuje działanie w środowiskach CI/CD. Oznacza to, że możesz użyć Microsoft Store Developer CLI (wersja próbna) w potokach CI/CD, na przykład do automatycznego publikowania w Microsoft Store.

Pierwszym krokiem do osiągnięcia tego jest zainstalowanie Interfejsu wiersza polecenia dewelopera Microsoft Store (wersja zapoznawcza) w środowisku ciągłej integracji/ciągłego wdrażania. Instrukcje, jak to wykonać , można znaleźć tutaj.

Po zainstalowaniu wersji zapoznawczej Microsoft Store Developer CLI należy skonfigurować środowisko, aby 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 Azure DevOps nazywa je Secret Variables, ale GitHub Actions nazywa je Encrypted Secrets. 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 interfejs linii poleceń Microsoft Store Developer CLI (wersja zapoznawcza) zostanie skonfigurowany do używania podanych poświadczeń. Teraz możesz użyć wersji zapoznawczej CLI (interfejsu wiersza poleceń) dla Microsoft Store Developer w potoku CI/CD.