fastlane-plugin-upload_to_ru_store

Fastlane-плагин для публикации Android-приложений в RuStore: загрузка AAB/APK, поэтапная раскатка, отложенный релиз, ручная публикация и архивирование версий.

• Установка
• Быстрый старт
• Получение ключей
• Действия
  • upload_to_ru_store
  • rustore_version_status
  • rustore_publish_version
  • rustore_publish_settings
  • rustore_archive_version
• Рецепты
• Переменные окружения
• Отладка
• Ограничения RuStore
• Обновление с 1.0.x
• Разработка

fastlane add_plugin upload_to_ru_store

Требуется Ruby >= 3.2 и fastlane >= 2.240.

lane :publish_to_rustore do
  upload_to_ru_store(
    package_name: "com.example.app",
    key_id: ENV["RUSTORE_KEY_ID"],
    private_key: ENV["RUSTORE_PRIVATE_KEY"],
    aab: "app/build/outputs/bundle/release/app-release.aab",
    changelog_path: "metadata/android/ru-RU/changelog.txt"
  )
end

Что происходит под капотом:

1. подпись key_id + timestamp по RSA-SHA512, обмен на JWE-токен;
2. удаление незавершённых черновиков приложения;
3. создание черновика с метаданными и настройками публикации;
4. загрузка сборки (AAB, либо GMS APK и опционально HMS APK);
5. отправка черновика на модерацию.

Шаги 2 и 5 отключаются флагами remove_existing_drafts и submit_for_moderation.

В консоли RuStore: Настройки → Ключи доступа → Создать ключ. Вы получите идентификатор ключа (key_id) и приватный RSA-ключ.

private_key принимается в любом из форматов:

• PEM с заголовком -----BEGIN PRIVATE KEY----- (PKCS#8);
• PEM с заголовком -----BEGIN RSA PRIVATE KEY----- (PKCS#1);
• голый Base64 без заголовков — формат определяется автоматически по структуре DER.

Последний вариант удобен для CI: ключ кладётся в секрет одной строкой.

RUSTORE_PRIVATE_KEY=$(tr -d '\n' < key.pem)

Полный цикл выпуска: черновик → сборка → модерация. Возвращает versionId созданного черновика и кладёт его в lane_context[SharedValues::RUSTORE_VERSION_ID].

Нужно указать хотя бы aab или gms_apk.

Возвращает Hash с данными последней версии: versionId, versionCode, versionName, versionStatus, publishType, partialValue и остальные поля RuStore. Если версий нет — возвращает nil.

version = rustore_version_status(
  package_name: "com.example.app",
  key_id: ENV["RUSTORE_KEY_ID"],
  private_key: ENV["RUSTORE_PRIVATE_KEY"]
)

UI.message("Статус: #{version['versionStatus']}")

Параметры: package_name, key_id, private_key, testing_type (ALL/RELEASE/ALPHA), timeout.

Возможные значения versionStatus:

Публикует версию, которая прошла модерацию и была создана с publish_type: "MANUAL". Без version_id берёт последнюю версию приложения.

rustore_publish_version(
  package_name: "com.example.app",
  key_id: ENV["RUSTORE_KEY_ID"],
  private_key: ENV["RUSTORE_PRIVATE_KEY"]
)

Меняет настройки публикации уже существующей версии: тип, дату отложенного релиза, процент раскатки.

rustore_publish_settings(
  package_name: "com.example.app",
  key_id: ENV["RUSTORE_KEY_ID"],
  private_key: ENV["RUSTORE_PRIVATE_KEY"],
  version_id: 12345,
  partial_value: 50
)

RuStore разрешает только увеличивать процент раскатки; 100 означает полный релиз.

Архивирует версию. RuStore принимает архивирование только для статусов READY_FOR_PUBLICATION и REJECTED_BY_MODERATOR.

rustore_archive_version(
  package_name: "com.example.app",
  key_id: ENV["RUSTORE_KEY_ID"],
  private_key: ENV["RUSTORE_PRIVATE_KEY"],
  version_id: 12345
)

Выпуск на 10% аудитории, затем расширение:

lane :rollout_start do
  upload_to_ru_store(
    package_name: "com.example.app",
    key_id: ENV["RUSTORE_KEY_ID"],
    private_key: ENV["RUSTORE_PRIVATE_KEY"],
    aab: "app-release.aab",
    publish_type: "INSTANTLY",
    partial_value: 10
  )
end

lane :rollout_expand do |options|
  version = rustore_version_status(
    package_name: "com.example.app",
    key_id: ENV["RUSTORE_KEY_ID"],
    private_key: ENV["RUSTORE_PRIVATE_KEY"]
  )

  rustore_publish_settings(
    package_name: "com.example.app",
    key_id: ENV["RUSTORE_KEY_ID"],
    private_key: ENV["RUSTORE_PRIVATE_KEY"],
    version_id: version["versionId"],
    partial_value: options[:percent].to_i
  )
end

upload_to_ru_store(
  package_name: "com.example.app",
  key_id: ENV["RUSTORE_KEY_ID"],
  private_key: ENV["RUSTORE_PRIVATE_KEY"],
  aab: "app-release.aab",
  publish_type: "DELAYED",
  publish_datetime: (Time.now + 3 * 24 * 3600).iso8601
)

lane :stage do
  upload_to_ru_store(
    package_name: "com.example.app",
    key_id: ENV["RUSTORE_KEY_ID"],
    private_key: ENV["RUSTORE_PRIVATE_KEY"],
    aab: "app-release.aab",
    publish_type: "MANUAL"
  )
end

lane :go_live do
  version = rustore_version_status(
    package_name: "com.example.app",
    key_id: ENV["RUSTORE_KEY_ID"],
    private_key: ENV["RUSTORE_PRIVATE_KEY"]
  )

  UI.user_error!("Версия ещё не прошла модерацию: #{version['versionStatus']}") unless
    version["versionStatus"] == "READY_FOR_PUBLICATION"

  rustore_publish_version(
    package_name: "com.example.app",
    key_id: ENV["RUSTORE_KEY_ID"],
    private_key: ENV["RUSTORE_PRIVATE_KEY"],
    version_id: version["versionId"]
  )
end

Полезно, когда сборку нужно залить заранее, а метаданные дозаполнить в консоли.

upload_to_ru_store(
  package_name: "com.example.app",
  key_id: ENV["RUSTORE_KEY_ID"],
  private_key: ENV["RUSTORE_PRIVATE_KEY"],
  aab: "app-release.aab",
  submit_for_moderation: false
)

Каждый параметр читается из переменной окружения, что удобно в CI:

key_id и private_key помечены как sensitive, поэтому fastlane не печатает их в сводке параметров.

RUSTORE_DEBUG=1 bundle exec fastlane publish_to_rustore

Включает подробный HTTP-лог. Заголовок Public-Token, поле signature и jwe в выводе маскируются.

При сетевых сбоях и ответах 429/5xx запрос повторяется до трёх раз с экспоненциальной паузой.

• Загрузить сборку можно только с versionCode больше предыдущего.
• Отложенная публикация — не раньше чем через 24 часа и не позже чем через 60 дней.
• Процент раскатки можно только увеличивать.
• Архивировать можно только версии в статусах READY_FOR_PUBLICATION и REJECTED_BY_MODERATOR.
• Публиковать вручную можно только версию, прошедшую модерацию с типом MANUAL.

Существующие вызовы upload_to_ru_store продолжают работать без изменений. На что стоит обратить внимание:

• publish_type: "DELAYED" наконец работает — в 1.0.x publish_datetime не доходил до API, и вызов всегда падал;
• лимит changelog поднят с 500 до документированных API 5000 символов;
• минимальная версия Ruby — 3.2: дерево зависимостей fastlane требует её;
• HTTP-лог больше не печатается без запроса, включается через RUSTORE_DEBUG.

bundle install
bundle exec rspec
bundle exec rubocop

Структура:

lib/fastlane/plugin/upload_to_ru_store/
├── actions/                 действия fastlane
└── helper/
    ├── upload_to_ru_store_helper.rb   фасад, сохраняющий обратную совместимость
    └── rustore/
        ├── signer.rb        загрузка ключа и подпись RSA-SHA512
        ├── client.rb        HTTP-транспорт, повторы, маскирование секретов
        ├── api.rb           методы RuStore API и валидация полей
        ├── options.rb       переиспользуемые ConfigItem
        └── errors.rb        типизированные ошибки

Сетевые вызовы в тестах замоканы через webmock, реальные соединения запрещены.

MIT, см. LICENSE.

• RuStore API: публикация приложений
• Fastlane Plugins Guide