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

Мобильная платформа 1С:Предприятия позволяет запускать прикладные решения на смартфонах и планшетах под Android и iOS. Однако в отличие от обычной публикации на веб-сервере, мобильное приложение нужно именно скомпилировать — собрать установочный пакет (APK для Android или IPA для iOS), который содержит платформу, конфигурацию и настройки подключения.

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

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

Какие сценарии мобильного приложения существуют в 1С

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

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

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

Что подготовить перед компиляцией

Для сборки понадобится несколько компонентов. Отсутствие любого из них — самая частая причина неудачи на старте.

Во-первых, нужен комплект мобильной платформы — дистрибутив, который скачивается с портала 1С по действующей подписке ИТС. Он содержит сборщик мобильных приложений и саму платформу для нужных ОС.

Во-вторых, для Android потребуется установленная Java (JDK) и Android SDK — сборщик использует их для формирования APK. Для iOS обязателен компьютер Mac с установленным Xcode: собрать IPA на Windows невозможно, это ограничение экосистемы Apple, а не 1С.

В-третьих, подготовьте сертификаты подписи. Для Android это keystore-файл, который можно сгенерировать самостоятельно. Для iOS — сертификат разработчика и профиль обеспечения (provisioning profile) из учётной записи Apple Developer, которая является платной.

Как создать мобильную конфигурацию

Автономное приложение строится на отдельной конфигурации, разработанной специально под мобильную платформу. Она создаётся в обычном конфигураторе 1С, но с учётом ограничений мобильной платформы: недоступны некоторые объекты и механизмы, например часть функциональности обмена данными, отдельные виды клиентов и ряд серверных возможностей.

Практичный подход — начать с шаблона. В составе дистрибутива мобильной платформы поставляются демонстрационные конфигурации, которые показывают типовые механизмы: обмен с основной базой, работу с камерой, геопозиционирование, push-уведомления. На их основе проще собрать собственное решение, чем писать с нуля.

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

Как настроить сборщик мобильных приложений

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

В настройках указываются: путь к файлу конфигурации (.cf), имя и идентификатор приложения (например, com.example.myapp — он должен быть уникальным), версия, иконки разных разрешений, используемая версия мобильной платформы и целевая операционная система.

Для Android дополнительно прописываются пути к JDK и Android SDK, а также параметры keystore: файл, пароль, алиас ключа. Для iOS на Mac указывается сертификат подписи и provisioning profile, привязанный к идентификатору приложения.

1. 1
   Установите дистрибутив мобильной платформы и откройте сборщик
2. 2
   Создайте новую настройку и укажите файл конфигурации .cf
3. 3
   Задайте имя, уникальный идентификатор и версию приложения
4. 4
   Добавьте иконки и выберите версию мобильной платформы
5. 5
   Для Android укажите пути к JDK, SDK и параметры keystore
6. 6
   Для iOS на Mac укажите сертификат и provisioning profile
7. 7
   Запустите сборку и дождитесь формирования пакета

Как запустить компиляцию и получить установочный пакет

После заполнения настроек запускается процесс сборки. Сборщик распакует компоненты платформы, подставит вашу конфигурацию, скомпилирует проект средствами Android SDK или Xcode и подпишет итоговый пакет указанным сертификатом. Время сборки зависит от мощности машины и обычно занимает от нескольких минут до получаса.

Ход сборки отображается в журнале. Если процесс завершился ошибкой, первым делом смотрите текст ошибки в логе: чаще всего это неверные пути к SDK, устаревшая версия Java, несовместимость версии платформы и сборщика или проблемы с сертификатом.

Результат — файл APK (Android) или IPA (iOS). APK можно сразу перенести на устройство и установить, предварительно разрешив установку из неизвестных источников в настройках Android. IPA устанавливается через Xcode, TestFlight или корпоративные механизмы распространения.

keytool -genkey -v -keystore myapp.keystore -alias myapp -keyalg RSA -keysize 2048 -validity 10000

Приведённая команда генерирует keystore для подписи Android-приложения. Храните этот файл и пароли в надёжном месте: если потерять keystore, вы не сможете выпускать обновления под тем же идентификатором приложения — пользователям придётся удалять старую версию и ставить новую заново с потерей локальных данных.

Как проверить приложение на устройстве

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

Обязательно протестируйте приложение на реальном устройстве, а не только на эмуляторе: эмуляторы не всегда корректно воспроизводят работу с камерой, Bluetooth-оборудованием (сканеры, принтеры этикеток) и push-уведомлениями.

Типичные ошибки и ограничения

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

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

Третья группа — инфраструктурная: неверные пути к SDK, конфликт версий Java, недостаток прав на каталоги. На Windows рекомендуется избегать кириллицы и пробелов в путях к SDK и рабочим каталогам сборщика.

FAQ: частые вопросы о компиляции мобильных приложений 1С