Документация Мобильное приложение
Мобильное приложение: что нужно и бренд
Установка и настройка · обновлено 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.