CLI Reference

Справочник команд OctoPublisher CLI

Полный справочник команд, флагов и параметров утилиты octopublish.

---

Глобальные флаги

Флаг	Описание
-h, --help	Вывести подробную справочную информацию
-v, --version	Вывести текущую версию утилиты

---

1. Команда init (Сборка структуры "Store as Code")

Инициализирует дерево каталогов со стартовыми шаблонами текстов и сгенерированными PNG-файлами строгого разрешения.

octopublish init [all|android|windows] [--dir <каталог>] [--lang <локаль>]

• all (по умолчанию): Создает структуру каталогов для Android и Windows.
• android: Создает структуру только для Google Play Store.
• windows: Создает структуру только для Microsoft Store.
• --dir <каталог>: Путь к целевой папке (по умолчанию: packaging).
• --lang <локаль>: Основной язык приложения (по умолчанию: ru-RU).

---

2. Команда pull (Экспорт ассетов из сторов)

Выгружает опубликованные описания, иконки, баннеры и скриншоты напрямую из Google Play и Microsoft Store.

octopublish pull [all|android|windows] [ID] [параметры]

• windows <Product ID>: Выгрузка из Microsoft Store (по Product ID без авторизации через Display Catalog API или через Partner Center API).
• android <Package Name>: Выгрузка из Google Play Developer API (требует сервисный аккаунт).
• --dir <каталог>: Папка сохранения (по умолчанию: packaging).
• --app-id <id>: Product ID приложения Microsoft Store.
• --package-name <id>: Идентификатор пакета Google Play.
• --service-account <путь>: Ключ сервисного аккаунта Google Play (JSON).
• --lang <локаль>: Язык для выгрузки (по умолчанию: все доступные).
• --market <рынок>: Региональный рынок каталога Microsoft Store (по умолчанию: RU, US).

---

3. Команда add (Добавление языкового пакета)

Добавляет новую языковую папку для указанной платформы со стартовым набором текстовых файлов и шаблонов графики.

octopublish add [all|android|windows] <локаль> [--dir <каталог>]

Поддерживает автоматическое сопоставление коротких кодов:

• ru -> ru-RU
• en, us -> en-US
• fr -> fr-FR
• de -> de-DE
• es -> es-ES
• zh, cn -> zh-CN
• ja, jp -> ja-JP
• it -> it-IT
• pt, br -> pt-BR
• uk, ua -> uk-UA
• kk, kz -> kk-KZ
• tr -> tr-TR
• ar, sa -> ar-SA

---

4. Команда test (Предполётный линтер)

Запускает 5-уровневую валидацию метаданных и графических материалов. Блокирует деплой (код выхода 1) при обнаружении критических несоответствий.

octopublish test [--dir <каталог>] [--strict]

• --dir <каталог>: Папка с метаданными (по умолчанию: packaging).
• --strict: Строгий режим: прерывает выполнение с кодом 1 при наличии любых предупреждений.

---

5. Команда list (Сводная инспекция ассетов)

Сканирует каталоги и выводит наглядную ANSI-таблицу статуса готовности текстовых описаний, иконок, баннеров и скриншотов.

octopublish list [--dir <каталог>]

---

6. Команда sync (Синхронизация метаданных)

Синхронизирует текстовые описания и графику напрямую с магазинами без необходимости пересборки бинарных пакетов.

octopublish sync [all|android|windows] [--dir <каталог>] [--dry-run]

• --dry-run: Выполнить полную валидацию и составить отчет об изменениях без отправки запросов в магазины.

---

7. Модуль playstore (Google Play Store)

playstore publish

octopublish playstore publish \
  --bundle <путь к .aab/.apk> \
  --package-name <id приложения> \
  --service-account <путь к JSON или содержимое> \
  [--track <internal|alpha|beta|production>] \
  [--notes-dir <папка whatsnew>] \
  [--desc-dir <папка store/android>] \
  [--icon <путь к иконке>] \
  [--release-name <название версии>]

---

8. Модуль mstore (Microsoft Store)

mstore publish

octopublish mstore publish \
  --package <путь к .msix/.zip> \
  [--app-id <Product ID>] \
  [--tenant-id <Azure Tenant ID>] \
  [--client-id <Azure Client ID>] \
  [--client-secret <Azure Secret>] \
  [--seller-id <Partner Center Seller ID>] \
  [--notes-dir <папка whatsnew>] \
  [--desc-dir <папка store/windows>]

mstore status

octopublish mstore status [--app-id <Product ID>]

mstore delete-draft

octopublish mstore delete-draft [--app-id <Product ID>]

mstore configure

octopublish mstore configure [--local]