Если это еще не сделано, установите последнюю версию среды выполнения рабочего стола .NET 8. Это требование для запуска интерфейса командной строки разработчика Microsoft Store.
Самый простой способ установить его — использовать winget:
winget install Microsoft.DotNet.DesktopRuntime.8
Шаг 2. Установка интерфейса командной строки разработчика Microsoft Store в Windows
Если это еще не сделано, установите последнюю версию среды выполнения .NET 8. Это требование для запуска интерфейса командной строки разработчика Microsoft Store.
Шаг 2. Установка интерфейса командной строки разработчика Microsoft Store в macOS
Вы можете скачать .tar.gz macOS для конкретной архитектуры (x64 или Arm64) на странице выпусков Microsoft Store Developer CLI. После скачивания извлеките архив и поместите его в PATH, однако вы хотите сделать это, например:
Если это еще не сделано, установите последнюю версию среды выполнения .NET 8. Это требование для запуска интерфейса командной строки разработчика Microsoft Store.
Шаг 2. Установка интерфейса командной строки разработчика Microsoft Store в Linux
Вы можете скачать .tar.gz Linux для конкретной архитектуры (x64 или Arm64) на странице выпусков Cli разработчика Microsoft Store. После скачивания извлеките архив и поместите его в PATH, однако вы хотите сделать это, например:
Повторно настройте интерфейс командной строки разработчика Microsoft Store. Вы можете указать секрет клиента или сертификат. Сертификаты можно предоставить либо с помощью отпечатка, либо путем предоставления пути к файлу (с паролем или без нее).
Перенастройка — использование
msstore reconfigure
Перенастройка — параметры
Вариант
Описание
-t, --tenantId
Укажите идентификатор клиента, который следует использовать.
-s, --sellerId
Укажите идентификатор продавца, который следует использовать.
-c, --clientId
Укажите идентификатор клиента, который следует использовать.
-cs, --clientSecret
Укажите секрет клиента, который следует использовать.
-ct, --certificateThumbprint
Укажите отпечаток сертификата, который следует использовать.
-cfp, --certificateFilePath
Укажите путь к файлу сертификата, который следует использовать.
-cp, --certificatePassword
Укажите пароль сертификата, который следует использовать.
--сброс
Сбрасывать учетные данные можно только без запуска.
Команда "Параметры"
Изменение параметров интерфейса командной строки разработчика Microsoft Store.
Параметры — использование
msstore settings
Вложенная команда
Description
setpdn
Задайте свойство отображаемого имени издателя, используемое командой init.
Параметры — параметры
Вариант
Описание
-t, --enableTelemetry
Включите (пустое или true) или отключите (false) телеметрию.
-v, --verbose
Печать подробных выходных данных.
Параметры— использование команды SetPDN
msstore settings setpdn <publisherDisplayName>
Аргументы
Аргумент
Description
publisherDisplayName
Свойство отображаемого имени издателя, которое будет задано глобально.
Пропустите начальный опрос перед выполнением действия. [по умолчанию: false]
Отправка — справка по команде UpdateMetadata
msstore submission updateMetadata --help
Отправка — обновление использования команды
msstore submission update <productId> <product>
Отправка — обновление аргументов команд
Аргумент
Description
productId
Идентификатор продукта.
product
Обновленное представление продукта JSON.
Отправка — параметры команды обновления
Вариант
Описание
-s, --skipInitialPolling
Пропустите начальный опрос перед выполнением действия. [по умолчанию: false]
Отправка — справка по команде update
msstore submission update --help
Отправка — использование команды опроса
msstore submission poll <productId>
Отправка — аргументы команд опроса
Аргумент
Description
productId
Идентификатор продукта.
Отправка — справка по команде опроса
msstore submission poll --help
Отправка — публикация использования команд
msstore submission publish <productId>
Отправка — публикация аргументов команд
Аргумент
Description
productId
Идентификатор продукта.
Отправка — справка по публикации команд
msstore submission publish --help
Отправка— удаление использования команд
Удаляет ожидающий отправку из хранилища.
Отправка — удаление аргументов команд
Аргумент
Description
productId
Идентификатор продукта.
Отправка — удаление параметров команды
Вариант
Описание
--no-confirm
Не запрашивать подтверждение. [по умолчанию: false]
Отправка — справка по удалению команды
msstore submission delete --help
Команда Init
Эта init команда помогает настроить приложение для публикации в Microsoft Store. В настоящее время он поддерживает следующие типы приложений:
Пакет SDK для приложений Windows или WinUI 3
UWP
.NET MAUI
Flutter
Electron
React Native для desktop
PWA
Команда Init — примеры использования
Команда Init — пакет SDK для приложений Windows или WinUI 3
msstore init "C:\path\to\winui3_app"
Команда Init — UWP
msstore init "C:\path\to\uwp_app"
Команда Init — .NET MAUI
msstore init "C:\path\to\maui_app"
Команда Init — Flutter
msstore init "C:\path\to\flutter_app"
Команда Init — Electron
msstore init "C:\path\to\electron_app"
Команда Init — React Native для рабочего стола
msstore init "C:\path\to\react_native_app"
Примечание.
Для Проектов Electron, а также React Native для настольных компьютеров поддерживаются NpmYarn . Наличие файла блокировки (yarn.lock) будет использоваться для определения используемого Yarn диспетчера пакетов, поэтому убедитесь, что вы проверяете файл блокировки в системе управления версиями.
Команда Init — PWA
msstore init https://contoso.com --output .
Команда Init — аргументы
Аргумент
Description
pathOrUrl
Путь к корневому каталогу, в котором находится файл проекта, или общедоступный URL-адрес, указывающий на PWA.
Команда Init — параметры
Вариант
Описание
-n, --publisherDisplayName
Отображаемое имя издателя, используемое для настройки приложения. При условии избегает дополнительных вызовов API.
--пакет
Если он поддерживается типом приложения, автоматически упаковывает проект.
--издавать
Если он поддерживается типом приложения, автоматически публикует проект. Подразумевает "--package true"
-f, --flightId
Указывает идентификатор полета, в котором будет опубликован пакет.
-prp, --packageRolloutPercentage
Указывает процент развертывания пакета. Значение должно быть от 0 до 100.
-a, --arch
Для сборки архитектуры. Если это не указано, будет использоваться архитектура по умолчанию для текущей ОС и типа проекта. Допустимые значения: "x86", "x64", "arm64". Используется только в сочетании с "-package true".
-o, --output
Выходной каталог, в котором будет храниться упакованое приложение. Если это не указано, будет использоваться каталог по умолчанию для каждого другого типа приложения.
-ver, --version
Версия, используемая при создании приложения. В противном случае будет использоваться версия из файла проекта.
Команда пакета
Помогает упаковыть приложение Microsoft Store в виде MSIX.
Команда пакета — примеры использования
Команда пакета — пакет SDK для приложений Windows или WinUI 3
msstore package "C:\path\to\winui3_app"
Команда пакета — UWP
msstore package "C:\path\to\uwp_app"
Команда пакета — .NET MAUI
msstore package "C:\path\to\maui_app"
Команда пакета — Flutter
msstore package "C:\path\to\flutter_app"
Команда пакета — Electron
msstore package "C:\path\to\electron_app"
Команда пакета — React Native для рабочего стола
msstore package "C:\path\to\react_native_app"
Команда пакета — PWA
msstore package "C:\path\to\pwa_app"
Команда пакета — аргументы
Вариант
Описание
pathOrUrl
Путь к корневому каталогу, в котором находится файл проекта, или общедоступный URL-адрес, указывающий на PWA.
Команда пакета — параметры
Вариант
Описание
-o, --output
Выходной каталог, в котором будет храниться упакованое приложение. Если это не указано, будет использоваться каталог по умолчанию для каждого другого типа приложения.
-a, --arch
Для сборки архитектуры. Если это не указано, будет использоваться архитектура по умолчанию для текущей ОС и типа проекта. Допустимые значения: "x86", "x64", "arm64".
-ver, --version
Версия, используемая при создании приложения. В противном случае будет использоваться версия из файла проекта.
Команда публикации
Публикует приложение в Microsoft Store.
Команда публикации — примеры использования
Команда публикации — пакет SDK для приложений Windows или WinUI 3
msstore publish "C:\path\to\winui3_app"
Команда публикации — UWP
msstore publish "C:\path\to\uwp_app"
Команда публикации — .NET MAUI
msstore publish "C:\path\to\maui_app"
Команда публикации — Флатер
msstore publish "C:\path\to\flutter_app"
Команда публикации — Electron
msstore publish "C:\path\to\electron_app"
Команда публикации — React Native для рабочего стола
msstore publish "C:\path\to\react_native_app"
Команда публикации — PWA
msstore publish "C:\path\to\pwa_app"
Команда публикации — аргументы
Вариант
Описание
pathOrUrl
Путь к корневому каталогу, в котором находится файл проекта, или общедоступный URL-адрес, указывающий на PWA.
Команда публикации — параметры
Вариант
Описание
-i, --inputDirectory
Каталог, в котором файл "MSIX" или ".msixupload", который будет использоваться для команды публикации. Если это не указано, cli попытается найти лучшего кандидата на основе аргумента pathOrUrl.
-id, --appId
Указывает идентификатор приложения. Требуется только в том случае, если проект не был инициализирован перед командой init.
-nc, --noCommit
Отключает фиксацию отправки, сохраняя ее в состоянии черновика.
-f, --flightId
Указывает идентификатор полета, в котором будет опубликован пакет.
-prp, --packageRolloutPercentage
Указывает процент развертывания пакета. Значение должно быть от 0 до 100.
Среды CI/CD
Интерфейс командной строки разработчика Microsoft Store (предварительная версия) поддерживает выполнение в средах CI/CD. Это означает, что вы можете использовать интерфейс командной строки разработчика Microsoft Store (предварительная версия) в конвейерах CI/CD, например, автоматически публиковать приложения в Microsoft Store.
Первый шаг, чтобы добиться этого, чтобы установить интерфейс командной строки разработчика Microsoft Store (предварительная версия) в среде 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 Actions
- name: Setup Microsoft Store Developer CLI
uses: microsoft/setup-msstore-cli@v1
- 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.
Совместная работа с нами на GitHub
Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.
