Поделиться через

Команды (MSI/EXE)

Installation

Шаг 1. Установка среды выполнения Windows .NET

Если это еще не сделано, установите последнюю версию среды выполнения рабочего стола .NET 8. Это требование для запуска интерфейса командной строки разработчика Microsoft Store.

Самый простой способ установить его — использовать winget:

winget install Microsoft.DotNet.DesktopRuntime.8

Шаг 2. Установка интерфейса командной строки разработчика Microsoft Store в Windows

Вы можете скачать интерфейс командной строки разработчика Microsoft Store из Microsoft Store. Кроме того, можно использовать winget:

winget install "Microsoft Store Developer CLI"

Шаг 1. Установка среды выполнения .NET macOS

Если это еще не сделано, установите последнюю версию среды выполнения .NET 8. Это требование для запуска интерфейса командной строки разработчика Microsoft Store.

Шаг 2. Установка интерфейса командной строки разработчика Microsoft Store в macOS

Вы можете скачать macOS .tar.gz для конкретной архитектуры (x64 или Arm64) со страницы релизов Microsoft Store Developer CLI. После скачивания извлеките архив и добавьте его в переменную PATH, как вам удобнее, например:

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:

brew install microsoft/msstore-cli/msstore-cli

Шаг 1. Установка среды выполнения .NET Linux

Если это еще не сделано, установите последнюю версию среды выполнения .NET 8. Это требование для запуска интерфейса командной строки разработчика Microsoft Store.

Шаг 2. Установка интерфейса командной строки разработчика Microsoft Store в Linux

Вы можете скачать .tar.gz для Linux под конкретную архитектуру (x64 или Arm64) со страницы релизов Microsoft Store Developer CLI. После скачивания извлеките архив и добавьте его в ваш PATH в любом удобном для вас способе, например:

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:

brew install microsoft/msstore-cli/msstore-cli

Команда информации

Печать существующей конфигурации.

Usage

msstore info

Options

Вариант Description
-v, --подробный вывод Печать подробных выходных данных.
-?, -h, --help Показать справку и информацию об использовании.

Команда перенастройки

Повторно настройте интерфейс командной строки разработчика Microsoft Store. Вы можете указать секрет клиента или сертификат. Сертификаты можно предоставить либо с помощью отпечатка, либо путем предоставления пути к файлу (с паролем или без нее).

Usage

msstore reconfigure

Options

Вариант Description
-t, --tenantId Укажите идентификатор клиента, который следует использовать.
-s, --sellerId (идентификатор продавца) Укажите идентификатор продавца, который следует использовать.
-c, --clientId Укажите идентификатор клиента, который следует использовать.
-cs, --clientSecret Укажите секрет клиента, который следует использовать.
-ct, --certificateThumbprint Укажите отпечаток сертификата, который следует использовать.
-cfp, --certificateFilePath Укажите путь к файлу сертификата, который следует использовать.
-cp, --certificatePassword Укажите пароль сертификата, который следует использовать.
--сброс Только сбросьте учетные данные, не начиная заново.
-v, --подробный вывод Печать подробных выходных данных.
-?, -h, --help Показать справку и информацию об использовании.

Команда "Параметры"

Изменение параметров интерфейса командной строки разработчика Microsoft Store.

Usage

msstore settings

Options

Вариант Description
-t, --enableTelemetry (включить телеметрию) Включите (пустое значение или «true») или отключите («false») телеметрию.
-v, --подробный вывод Печать подробных выходных данных.
-?, -h, --help Показать справку и информацию об использовании.

SetPDN подкоманда

Задайте свойство отображаемого имени издателя.

Usage

msstore settings setpdn <publisherDisplayName>

Arguments

Аргумент Description
publisherDisplayName Свойство отображаемого имени издателя, которое будет задано глобально.

Options

Вариант Description
-?, -h, --help Показать справку и информацию об использовании.

Команда отправки

Подкоманда Description
статус Возвращает статус заявки.
получить Возвращает метаданные и сведения о пакете определенной отправки.
getListingAssets Возвращает активы списка конкретной заявки.
updateMetadata Обновляет метаданные определенной отправки.
обновлять Обновляет сведения о пакете определенной отправки.
опрос Опрашивает состояние представленной заявки.
издавать Публикует определенную заявку.

Отправка — состояние — использование

msstore submission status <productId>

Arguments

Аргумент Description
productId Идентификатор центра партнеров.

Options

Вариант Description
-v, --подробный вывод Печать подробных выходных данных.
-?, -h, --help Показать справку и информацию об использовании.

Отправка — получение — использование

msstore submission get <productId>

Arguments

Аргумент Description
productId Идентификатор центра партнеров.

Options

Вариант Description
-l, --language Выберите нужный язык. [по умолчанию: ru]
-v, --подробный вывод Печать подробных выходных данных.
-?, -h, --help Показать справку и информацию об использовании.

Отправка — GetListingAssets — использование

msstore submission getListingAssets <productId>

Arguments

Аргумент Description
productId Идентификатор центра партнеров.

Options

Вариант Description
-l, --language (язык) Выберите нужный язык. [по умолчанию: ru]
-v, --подробный вывод Печать подробных выходных данных.
-?, -h, --help Показать справку и информацию об использовании.

Передача данных — ОбновлениеМетаданных — использование

msstore submission updateMetadata <productId> <metadata>

Arguments

Аргумент Description
productId Идентификатор центра партнеров.
metadata Обновленное представление метаданных JSON.

Options

Вариант Description
-s, --skipInitialPolling Пропустите начальный опрос перед выполнением действия. [по умолчанию: false]
-v, --verbose (подробный вывод) Печать подробных выходных данных.
-?, -h, --help Показать справочную и информацию об использовании.

Отправка — обновление — использование

msstore submission update <productId> <package>

Arguments

Аргумент Description
productId Идентификатор центра партнеров.
package Обновленное представление JSON пакета приложения.

Options

Вариант Description
-s, --skipInitialPolling Пропустите начальный опрос перед выполнением действия. [по умолчанию: false]
-v, --verbose (подробный вывод) Печать подробных выходных данных.
-?, -h, --help Показать сведения о справке и использовании.

Отправка — опрос — использование

msstore submission poll <productId>

Arguments

Аргумент Description
productId Идентификатор центра партнеров.

Options

Вариант Description
-v, --verbose (подробный вывод) Печать подробных выходных данных.
-?, -h, --help Показать сведения о справке и использовании.

Отправка — публикация — использование

msstore submission publish <productId>

Arguments

Аргумент Description
productId Идентификатор центра партнеров.

Options

Вариант Description
-v, --подробный вывод Печать подробных выходных данных.
-?, -h, --help Показать справку и информацию об использовании.

Среды CI/CD

Интерфейс командной строки разработчика Microsoft Store (предварительная версия) поддерживает выполнение в средах CI/CD. Это означает, что вы можете использовать интерфейс командной строки разработчика Microsoft Store (предварительная версия) в конвейерах CI/CD, например, автоматически публиковать приложения в Microsoft Store.

Первый шаг для достижения этой цели — установить Microsoft Store Developer CLI (предварительная версия) в среде CI/CD. Здесь можно найти инструкции по этому способу.

После установки интерфейса командной строки разработчика Microsoft Store (предварительная версия) необходимо настроить среду для выполнения команд. Для этого msstore reconfigure выполните команду с определенными параметрами, определяющими учетную запись центра партнеров (TenantId, SellerId, ClientId). Кроме того, необходимо указать clientSecret или сертификат.

Очень важно скрыть эти учетные данные, так как они будут отображаться в журналах конвейера CI/CD. Это можно сделать с помощью секретов. Каждая система конвейера CI/CD имеет разные имена для этих секретов. Например, Azure DevOps называет их секретными переменными, но GitHub Action вызывает их зашифрованные секреты. Создайте один секрет для каждого из параметров (TenantId, SellerId, ClientId и ClientSecret или Certificate), а затем используйте команду для настройки среды. reconfigure

Рассмотрим пример.

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

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

После выполнения этой команды интерфейс командной строки разработчика Microsoft Store (предварительная версия) будет настроен для использования предоставленных учетных данных. Теперь вы можете использовать интерфейс командной строки разработчика Microsoft Store (предварительная версия) в конвейере CI/CD.

  • Last updated on