Как собрать мобильное приложение 1С: полное руководство

Мобильная платформа 1С позволяет запускать прикладные решения на смартфонах и планшетах под Android и iOS, но сборка готового приложения требует подготовленного окружения и понимания архитектуры. В отличие от обычной конфигурации, мобильное приложение упаковывается в установочный пакет, который устанавливается на устройство как самостоятельная программа.

Процесс включает несколько этапов: разработку мобильной конфигурации в Конфигураторе, настройку инструментов сборки (JDK, Android SDK, конфигурационный файл сборщика), формирование пакета и проверку его на реальном устройстве. Для iOS дополнительно потребуется компьютер с macOS и действующий аккаунт разработчика Apple.

Ниже разобран полный цикл — от подготовки рабочего места до получения подписанного APK-файла или сборки для App Store, с указанием типичных ошибок и способов их диагностики.

Что понадобится перед началом сборки

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

Для сборки под Android на рабочей машине должны быть установлены Java Development Kit (JDK) и Android SDK с инструментами командной строки. Версии этих компонентов должны соответствовать требованиям используемой версии мобильной платформы — они указаны в документации к дистрибутиву. Несовпадение версий — одна из самых частых причин сбоев сборки.

Для сборки под iOS список другой: компьютер с macOS, установленная Xcode, сертификаты и профили обеспечения из учётной записи Apple Developer. Без платной учётной записи разработчика распространять приложение на устройства через App Store не получится.

Разработка мобильной конфигурации

Мобильное приложение 1С строится на отдельной конфигурации, которая проектируется с учётом ограничений мобильной платформы. Не все объекты и механизмы «большой» платформы доступны: например, отсутствуют некоторые виды отчётов, ограничен набор элементов управления, по-другому устроена работа с файлами.

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

В свойствах конфигурации обязательно проверьте поле «Назначение использования» — оно должно быть установлено в «Мобильное устройство» или «Персональный компьютер и мобильное устройство». От этого зависит, какие объекты будут включены в сборку и как платформа проверит конфигурацию.

Настройка окружения сборки под Android

Установите JDK версии, рекомендованной для вашей версии мобильной платформы, и пропишите путь к ней. Затем установите Android SDK: достаточно пакета командной строки, из которого через sdkmanager ставятся нужные платформы (platforms) и build-tools. После установки обязательно примите лицензии SDK — без этого сборка останавливается с невнятной ошибкой.

sdkmanager --licenses
sdkmanager "platform-tools" "platforms;android-33" "build-tools;33.0.2"

В параметрах сборщика указываются пути к каталогам JDK и SDK, а также расположение файла конфигурации сборки. Сам конфигурационный файл сборки — это XML, в котором задаются имя пакета приложения, версия, иконки, разрешения и адрес веб-сервиса обмена, если он используется.

Проверка корректности окружения

Простейший способ убедиться, что окружение готово, — собрать демонстрационное приложение из поставки мобильной платформы без каких-либо изменений. Если демо-сборка проходит успешно, проблемы при сборке собственной конфигурации следует искать в самой конфигурации или в её настройках, а не в инструментах.

Запуск сборки и получение APK

Откройте обработку «Сборщик мобильных приложений» в режиме 1С:Предприятие на файловой базе. Укажите файл конфигурации сборки, пути к инструментам и запустите процесс. Сборщик последовательно выгружает конфигурацию, формирует проект Android и вызывает систему сборки Gradle.

1. 1
   Установите JDK и Android SDK, примите лицензии SDK
2. 2
   Подготовьте мобильную конфигурацию и проверьте её в режиме мобильного устройства
3. 3
   Заполните XML-файл конфигурации сборки: имя пакета, версия, иконки
4. 4
   Откройте Сборщик мобильных приложений и укажите пути к инструментам и файлу сборки
5. 5
   Запустите сборку и дождитесь формирования APK
6. 6
   Установите APK на устройство и проверьте запуск и основные сценарии

Первая сборка занимает заметное время: Gradle скачивает зависимости и кэширует их. Последующие сборки проходят быстрее. По завершении в указанном каталоге появляется APK-файл, который можно установить на устройство вручную или через adb.

Для распространения приложения вне отладки APK необходимо подписать. Ключ подписи создаётся один раз и хранится в keystore-файле. Потеря keystore означает невозможность обновлять уже опубликованное приложение — пользователям придётся удалять старую версию и ставить новую как отдельное приложение.

Сборка под iOS: особенности

Сборка для iOS принципиально отличается: она выполняется только на macOS через Xcode. Потребуется действующая учётная запись Apple Developer, сертификат разработчика или дистрибьютора и профиль обеспечения (provisioning profile), привязанный к идентификатору приложения.

Дистрибутив мобильной платформы содержит проект Xcode, в который подставляется выгруженная мобильная конфигурация. Далее проект собирается стандартными средствами Xcode, а готовый пакет загружается в App Store Connect для публикации или тестирования через TestFlight.

Учитывайте, что публикация в App Store проходит модерацию, которая занимает от нескольких часов до нескольких дней. Приложение должно соответствовать правилам Apple: корректно запрашивать разрешения, не содержать скрытых функций, иметь политику конфиденциальности, если собирает данные пользователей.

Отладка и обмен данными с основной базой

До сборки релизной версии приложение удобно отлаживать в режиме разработчика: мобильная платформа на устройстве подключается к конфигурации по сети, и изменения в Конфигураторе подхватываются без пересборки пакета. Это заметно ускоряет итерации разработки.

Автономное мобильное приложение обычно обменивается данными с центральной базой через веб-сервисы или HTTP-сервисы. Адрес сервиса задаётся в конфигурации сборки, поэтому для тестовой и рабочей среды готовятся разные файлы сборки. Проверьте, что сервисы опубликованы, доступны с мобильной сети и защищены аутентификацией.

Типичные ошибки при сборке

Большинство проблем на этапе сборки связано не с конфигурацией, а с окружением: неверные версии JDK и SDK, непринятые лицензии, кириллица или пробелы в путях к инструментам и проекту. Сообщения об ошибках Gradle часто многословны — ищите первую строку с ошибкой, а не последнюю.

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

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