Polecenia (MSIX)

Instalacja

winget install Microsoft.DotNet.DesktopRuntime.8

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

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

Ustawienia polecenie

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

Usage

msstore settings

Opcje

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)

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

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"

PWA

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

Argumenty (w programowaniu)

Opcje

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)

Opcje

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)

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

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.