Лаборатория оптимизации бизнеса
Меню

Документация Мобильное приложение

Мобильное приложение: что нужно и бренд

Установка и настройка · обновлено 26 октября 2026 г.

Приложение для партнёров выходит под именем вашей компании: ваше название, иконка, цвета и адрес вашего портала. Вы (или мы по вашей просьбе) собираете его из комплекта portal-mobile-kit-<версия>.tar.gz и публикуете в магазинах приложений от своего имени. Код при этом не меняется — всё, что относится к компании, лежит в папке бренда. Комплект скачивается в личном кабинете: Продукты → Мобильное приложение (комплект сборки).

Приложение входит в модуль лицензии «Портал партнёра», отдельная лицензия не нужна. Дилер входит в него по коду из письма или SMS, как на портал, и видит то же: заказы с оплатами, построениями и печатными формами, каталог с ценами, оформление заказа с вложениями и снимками с камеры. Название компании и логотип на экране входа приложение берёт с портала (админка → «Оформление»), иконка в телефоне — из папки бренда.

Что нужно заранее

  • Портал 1.3.0 и новее, доступный из интернета по https с сертификатом, которому доверяют телефоны (Let's Encrypt или коммерческий центр; сертификат НУЦ Минцифры не подходит): приложение работает с вашим порталом из любой сети.
  • Если на портале включена капча Яндекса: в списке сайтов капчи (Yandex Cloud → SmartCaptcha → ваша капча) добавлен `localhost` — внутри приложения страница входа открывается с этого адреса.
  • Аккаунт RuStore для юрлица — публикация для Android; бесплатно, регистрация — несколько дней.
  • Аккаунт Google Play Console (по желанию) — публикация для Android; 25 $ один раз.
  • Аккаунт Apple Developer для организации (по желанию) — публикация для iPhone; 99 $ в год, нужен номер D-U-N-S организации.
  • Docker на любом компьютере или сервере — сборка для Android.
  • Mac с Xcode и Node.js LTS — только если публикуете в App Store.
  • Ссылка на политику конфиденциальности на вашем сайте — требуют все магазины; шаблон — Политика конфиденциальности приложения.

Без магазинов тоже можно: APK для Android раздаётся прямо с вашего портала — см. Публикация приложения.

Бренд

Распакуйте комплект, скопируйте папку brands/demo в brands/<имя> (латиница, строчные, например brands/acme) и замените в ней файлы.

В файле `brand.json`:

  • appId — идентификатор приложения в магазинах: латиница через точку, обычно ваш домен наоборот, например ru.acme.dealer. После публикации не меняется — с другим appId это другое приложение.
  • appName — название под иконкой, до 30 символов.
  • portalUrl — адрес вашего портала, https:// без пути.
  • colors.primary — основной цвет: кнопки, выделения, фон иконки.
  • colors.splashBackground — фон заставки при запуске (по умолчанию белый).
  • appleTeamId — Team ID из Apple Developer (Membership) — только для iPhone.

Картинки (PNG):

  • icon.png — иконка 1024×1024, без прозрачности, важное — в центральных 2/3 (по краям Android обрезает иконку кругом или скруглённым квадратом);
  • splash.png — заставка 2732×2732: логотип в центре, в квадрате примерно 1200×1200, вокруг — однотонный фон (на телефоне заставка обрезается по краям);
  • icon-foreground.png — по желанию: передний план адаптивной иконки Android 1024×1024 с прозрачным фоном (фоном станет colors.primary).

Сборка проверяет brand.json и размеры картинок и пишет, что исправить. Дальше — Сборка для Android.