Сборка мобильного приложения 1С в APK-файл

APK из конфигурации 1С собирают не в Конфигураторе, а отдельным инструментом — «Сборщиком мобильных приложений» из состава мобильной платформы 1С:Предприятия. Конфигуратор только готовит саму конфигурацию: задаёт назначение использования «Мобильное устройство» и выгружает её в файл. Сборку APK, подписание и упаковку под Android делает сборщик, которому нужны сторонние компоненты — JDK и Android SDK.

Поэтому «сделать APK» — это по сути три разные задачи: собрать рабочее место со всеми SDK, зарегистрировать приложение в сборщике и один раз создать ключ подписи. Дальше каждая новая версия собирается в пару кликов. Ниже — что именно установить, куда прописать пути и какие ошибки сборки встречаются чаще всего.

Что установить на рабочее место сборки

Сборщик сам ничего не компилирует — он запускает чужие инструменты и передаёт им файлы. Поэтому до первой сборки на компьютере должны быть установлены внешние компоненты. Точный состав и совместимые версии зависят от выпуска мобильной платформы — сверяйтесь с требованиями именно вашей версии, они приложены к дистрибутиву.

Базовый набор для Android:

• 📦 Мобильная платформа 1С:Предприятия — скачивается отдельно от обычной платформы. В дистрибутиве лежат файлы платформы под Android и конфигурация сборщика.
• ☕ JDK (Java Development Kit) — нужен и для сборки, и для создания ключа подписи. Ставьте версию, указанную в требованиях вашей мобильной платформы, а не «самую свежую».
• 🤖 Android SDK — набор инструментов сборки и платформенные API. Через SDK Manager докачиваются Build-Tools и нужный уровень API (Android API Level). В составе SDK идут Platform-Tools с утилитой adb — ей потом удобно ставить готовый APK на устройство.
• ⚙️ Android NDK — нужен, потому что мобильная платформа содержит нативный код. Версия NDK тоже привязана к версии платформы.

JDK участвует дважды: сначала через keytool вы создаёте ключ подписи, потом его компилятор вызывается при сборке. Android SDK отвечает за упаковку и API, NDK — за компиляцию нативной части под каждый процессор. Сборщик 1С дирижирует всеми тремя, поэтому путь к каждому из них нужно указать точно.

Версии JDK, SDK и NDK подбираются под конкретный выпуск мобильной платформы. Несовпадение версий — причина большинства непонятных ошибок сборки, которые выглядят как «сборка оборвалась без внятного сообщения».

Регистрация приложения в сборщике

Сборщик мобильных приложений — это обычная конфигурация 1С. Её загружают в пустую информационную базу: создайте новую файловую базу и загрузите в неё поставляемый файл конфигурации сборщика из дистрибутива мобильной платформы (Конфигурация → Загрузить конфигурацию из файла, затем обновление конфигурации базы данных).

После запуска сборщика в режиме 1С:Предприятие:

1. Создайте новую запись мобильного приложения. Задайте имя приложения и идентификатор пакета в обратном доменном формате — например ru.company.sklad. Этот идентификатор должен быть уникальным и неизменным: по нему Android и Google Play отличают приложение, сменить его позже без переустановки у пользователей нельзя.
2. Укажите файл конфигурации вашего мобильного приложения (.cf), который вы выгрузили из Конфигуратора. Именно эта конфигурация попадёт внутрь APK.
3. Пропишите пути к внешним компонентам: каталог JDK, каталог Android SDK, каталог NDK и каталог с файлами мобильной платформы. Пути указываются один раз и сохраняются в записи.

В той же карточке задают название, которое увидит пользователь на экране устройства, версию приложения (видимую строку версии и числовой код версии — versionCode) и иконку. Числовой код версии увеличивайте при каждом обновлении, иначе Google Play не примет новую сборку.

Отдельно решите, как приложение будет работать с данными. Самостоятельное мобильное приложение хранит базу прямо на устройстве и обменивается с центральной базой по расписанию или вручную — через веб-сервис или HTTP-сервис, который вы публикуете на сервере. Файл конфигурации, который вы передаёте сборщику, уже должен содержать эту логику обмена: сборка APK ничего к ней не добавляет, она лишь упаковывает готовую конфигурацию.

Создание и настройка ключа подписи

Android не устанавливает неподписанный APK. Подпись — это сертификат, которым вы заверяете, что все версии приложения выпущены вами. Один раз потеряв ключ, вы не сможете выпускать обновления под тем же приложением в Google Play — храните файл ключа и пароли в надёжном месте и в резервной копии.

Ключ создаётся утилитой keytool из состава JDK. Пример команды, которая создаёт хранилище ключей (keystore) с одним ключом сроком на много лет:

keytool -genkeypair -v -keystore my-release-key.jks \
  -alias my-app -keyalg RSA -keysize 2048 -validity 10000

Утилита спросит пароль хранилища, пароль ключа и данные владельца (имя, организация). Запомните три вещи: путь к файлу .jks (или .keystore), имя ключа (alias) и оба пароля — их нужно будет ввести в сборщике.

В карточке приложения в сборщике укажите:

• путь к файлу хранилища ключей;
• имя ключа (alias);
• пароль хранилища и пароль ключа.

Выбор версии платформы и архитектуры процессора

Перед сборкой в карточке приложения выбирают, под какую мобильную платформу и под какие процессоры собирать APK.

Версия мобильной платформы. Укажите версию платформы из тех, что вы распаковали на рабочем месте. Версия платформы, под которую собран APK, должна быть не ниже той, что требует ваша конфигурация. Сравнивайте строго по номеру: берите версию не ниже минимально поддерживаемой, а не «поновее на глаз».

Архитектура процессора. Для Android это, как правило:

Google Play с 2019 года требует 64-битную версию, поэтому arm64-v8a включайте обязательно. Если нужна поддержка старых телефонов — добавьте armeabi-v7a.

Здесь же задают минимальную и целевую версии Android (minSdkVersion / targetSdkVersion). Целевую версию держите в рамках требований Google Play — магазин периодически поднимает минимально допустимый targetSdkVersion для новых загрузок.

Как запустить сборку и получить APK-файл

Когда пути прописаны, ключ указан, версия платформы и архитектуры выбраны — запускается сборка. В карточке приложения выберите тип результата (APK для ручной установки или AAB для магазина) и нажмите сборку.

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

1. Сборщик берёт файл вашей конфигурации (.cf) и файлы мобильной платформы.
2. Формирует проект Android и передаёт его инструментам сборки Android SDK и NDK.
3. Компилируется нативная часть под каждую выбранную архитектуру.
4. Готовый пакет подписывается указанным ключом.
5. На выходе — файл .apk (или .aab) в каталоге, который вы задали.

Первая сборка идёт заметно дольше последующих: докачиваются и кешируются компоненты, прогреваются инструменты. На слабой машине это несколько минут и больше. Если сборка прервалась — не чистите кеш и не удаляйте каталоги инструментов «на всякий случай»: чаще достаточно исправить один путь или версию и запустить заново.

Полезно вести сборку по стабильной схеме: собрали APK → проверили на реальном устройстве → только потом поднимаете versionCode и выпускаете. Один и тот же ключ и один и тот же идентификатор пакета на всех версиях — это то, что превращает отдельные APK в линейку обновлений, а не в набор независимых приложений.

Проверить APK можно двумя путями:

• На устройстве. Скопируйте .apk на телефон и установите вручную. Для этого в настройках Android разрешают установку из неизвестных источников для того приложения, которым открываете файл (файловый менеджер или браузер).
• Через adb. Команда adb install путь-к-файлу.apk ставит пакет на подключённое по USB устройство с включённой отладкой. Утилита adb входит в Platform-Tools из Android SDK.

Частые ошибки сборки и как их устранить

Почти все сбои сборки — это либо неверный путь к внешнему инструменту, либо несовместимая версия, либо проблема с ключом. Сообщение в логе сборки часто приходит «изнутри» Android SDK или JDK, а не от 1С, — читайте именно последние строки лога.

Если ошибку не удаётся разобрать по сообщению, сравните своё окружение с требованиями вашей версии мобильной платформы построчно: именно рассинхрон версий JDK/SDK/NDK даёт больше всего «молчаливых» падений.

Частые вопросы