Udostępnij przez

Polecenia (MSI/EXE)

Instalacja

Krok 1: Instalowanie środowiska uruchomieniowego Windows dla platformy .NET

Jeśli jeszcze tego nie zrobiłeś, zainstaluj najnowszą wersję .NET 8 Desktop Runtime. Jest to wymóg do uruchamiania Microsoft Store Developer CLI.

Najprostszym sposobem instalacji jest użycie zestawu winget:

winget install Microsoft.DotNet.DesktopRuntime.8

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

Możesz pobrać Microsoft Store Developer CLI 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 8. Jest to wymóg do uruchomienia Microsoft Store Developer CLI.

Krok 2: Instalowanie CLI dewelopera sklepu Microsoft Store na 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 na swój komputer i skonfiguruj jego umiejscowienie w PATH, w dowolny sposób, 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ć 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 8. Wymagane do uruchamiania Microsoft Store Developer CLI.

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

Możesz pobrać plik .tar.gz dla systemu Linux i określonej architektury (x64 lub Arm64) ze strony wydań CLI dla deweloperów w sklepie Microsoft Store. Po pobraniu wyodrębnij archiwum i umieść je w swoim PATH według własnych preferencji, 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ć brew:

brew install microsoft/msstore-cli/msstore-cli

Polecenie Info

Drukuj istniejącą konfigurację.

Usage

msstore info

Opcje

Option Description
-v, --verbose Drukuj pełne dane wyjściowe.
-?, -h, --help Pokaż informacje o pomocy i użyciu.

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

Option Description
-t, --tenantId Określ identyfikator dzierżawy, który ma być używany.
-s, --sellerId Określ identyfikator sprzedawcy, który ma być używany.
-c, --clientId Określ identyfikator klienta, który ma być używany.
-cs, --clientSecret Określ klucz tajny klienta, który ma być używany.
-ct, --certificateThumbprint 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, --certificatePassword Określ hasło certyfikatu, które ma być używane.
--resetować Zresetuj tylko poświadczenia, bez rozpoczynania od nowa.
-v, --verbose Drukuj pełne dane wyjściowe.
-?, -h, --help Pokaż informacje o pomocy i użyciu.

Ustawienia polecenie

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

Usage

msstore settings

Opcje

Option Description
-t, --enableTelemetry Włącz (puste/true) lub Wyłącz (fałsz) dane telemetryczne.
-v, --verbose (szczegółowy) Drukuj pełne dane wyjściowe.
-?, -h, --help Pokaż informacje o pomocy i użyciu.

Polecenie podrzędne SetPDN

Ustaw właściwość dla nazwy wyświetlanej wydawcy.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

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

Opcje

Option Description
-?, -h, --help Pokaż informacje o pomocy i użyciu.

Polecenie przesyłania

Polecenie podrzędne Description
stan Pobiera status zgłoszenia.
Pobierz Pobiera metadane oraz informacje o pakiecie określonego zgłoszenia.
getListingAssets Pobiera zasoby wykazu określonego zgłoszenia.
updateMetadata Aktualizuje metadane określonego przesłania.
aktualizacja Aktualizuje dane pakietu dotyczące konkretnego zgłoszenia.
ankieta Sonduje stan przesłania.
publikować Publikuje określone zgłoszenie.

Przesyłanie — stan — użycie

msstore submission status <productId>

Arguments

Argument Description
productId Identyfikator Centrum partnerskiego.

Opcje

Option Description
-v, --szczegółowe-logi Drukuj pełne dane wyjściowe.
-?, -h, --help Pokaż informacje o pomocy i użyciu.

Przesyłanie — pobieranie — użycie

msstore submission get <productId>

Arguments

Argument Description
productId Identyfikator Centrum partnerskiego.

Opcje

Option Description
-l, --language Wybierz język, który chcesz pobrać. [ustawienie domyślne: en]
-v, --szczegółowy Drukuj pełne dane wyjściowe.
-?, -h, --help Pokaż informacje o pomocy i użyciu.

Przesyłanie — GetListingAssets — Użycie

msstore submission getListingAssets <productId>

Arguments

Argument Description
productId Identyfikator Centrum partnerskiego.

Opcje

Option Description
-l, --language Wybierz język, który chcesz pobrać. [ustawienie domyślne: en]
-v, --verbose Drukuj pełne dane wyjściowe.
-?, -h, --help Pokaż informacje o pomocy i użyciu.

Przesyłanie — UpdateMetadata — użycie

msstore submission updateMetadata <productId> <metadata>

Arguments

Argument Description
productId Identyfikator Centrum partnerskiego.
metadata Zaktualizowana reprezentacja metadanych JSON.

Opcje

Option Description
-s, --skipInitialPolling Pomiń wstępne sondowanie przed wykonaniem akcji. [wartość domyślna: Fałsz]
-v, --verbose Drukuj pełne dane wyjściowe.
-?, -h, --help Pokaż informacje o pomocy i użyciu.

Przesyłanie — aktualizacja — użycie

msstore submission update <productId> <package>

Arguments

Argument Description
productId Identyfikator Centrum partnerskiego.
package Zaktualizowana reprezentacja JSON pakietu aplikacji.

Opcje

Option Description
-s, --skipInitialPolling (pominięcie początkowego sondowania) Pomiń wstępne sondowanie przed wykonaniem akcji. [wartość domyślna: Fałsz]
-v, --verbose Drukuj pełne dane wyjściowe.
-?, -h, --help Pokaż informacje o pomocy i użyciu.

Przesyłanie — ankieta — użycie

msstore submission poll <productId>

Arguments

Argument Description
productId Identyfikator Centrum partnerskiego.

Opcje

Option Description
-v, --verbose Drukuj pełne dane wyjściowe.
-?, -h, --help Pokaż informacje o pomocy i użyciu.

Przesyłanie — publikowanie — użycie

msstore submission publish <productId>

Arguments

Argument Description
productId Identyfikator Centrum partnerskiego.

Opcje

Option Description
-v, --verbose Drukuj pełne dane wyjściowe.
-?, -h, --help Pokaż informacje o pomocy i użyciu.

Środowiska ciągłej integracji/ciągłego wdrażania

Interfejs wiersza polecenia (CLI) dla deweloperów Microsoft Store (wersja zapoznawcza) obsługuje uruchamianie w środowiskach CI/CD. Oznacza to, że możesz użyć Microsoft Store Developer CLI (wersja zapoznawcza) w potokach CI/CD, na przykład do automatycznego publikowania aplikacji w sklepie Microsoft Store.

Pierwszym krokiem do osiągnięcia tego celu jest zainstalowanie Microsoft Store Developer CLI (wersja zapoznawcza) w środowisku CI/CD. Instrukcje dotyczące wykonywania tych czynności 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ć sekretny klucz ClientSecret lub Certyfikat.

Bardzo ważne jest ukrycie tych poświadczeń, gdyż mogą być widoczne w dziennikach twojego potoku CI/CD. Można to zrobić za pomocą sekretów. Każdy system potoków CI/CD ma różne nazwy dla tych sekretów. Na przykład usługa Azure DevOps nazywa je zmiennymi tajnymi, ale GitHub Actions nazywa je zaszyfrowanymi tajemnicami. 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 Microsoft Store Developer CLI (wersja zapoznawcza) zostanie skonfigurowany do używania podanych poświadczeń. Teraz możesz użyć Microsoft Store Developer CLI (wersja zapoznawcza) w swoim potoku CI/CD.

  • Last updated on