← На главную

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

Причины сбоев при сборке мобильного приложения

Проанализируем ключевые факторы, из-за которых процесс формирования APK завершается аварийно:

1. Отказ от Apache Ant в свежих версиях Android SDK. Исторически сборщик мобильных приложений 1С использовал утилиту Apache Ant для сборки проекта. Начиная с версии Android SDK Tools 25.3.0, компания Google полностью удалила поддержку Ant и сопутствующие скрипты генерации сборки. При попытке использовать современные версии SDK со старыми релизами сборщика процесс компиляции прерывается.
2. Несовместимость версий JDK. Если сборка завязана на Ant, требуется строго JDK 8 (1.8). При установке более новых версий Java (JDK 9, 11, 17) скрипты сборки не могут инициализироваться. Для современных сборок на базе Gradle стандартом является JDK 11.
3. Несовпадение разрядности Java и платформы 1С. Разрядность установленного пакета JDK (x86 или x64) должна строго совпадать с разрядностью используемого клиента платформы «1С:Предприятие», из-под которого запущен сборщик.
4. Ограничения длины путей и спецсимволы. Наличие пробелов, символов кириллицы или путей, превышающих стандартный лимит Windows (260 символов), приводит к сбою доступа к ресурсам во время распаковки и сборки.
5. Некорректные переменные среды. Отсутствие или неверные пути в системных переменных JAVA_HOME и ANDROID_HOME мешают сборщику корректно вызывать внешние компиляторы.

Способ 1. Настройка окружения с Android SDK Tools 25.2.5 (для классического сборщика на Ant)

Если используется версия мобильной платформы и сборщика, требующая Apache Ant, необходимо зафиксировать версию инструментов Android SDK на уровне 25.2.5. Разберем по шагам, как это сделать:

1. Подготовка каталогов: создадим рабочие папки в корне диска без пробелов и кириллицы, например: C:\Android\SDK, C:\Android\JDK8, C:\Android\ant, C:\temp_build.
2. Замена папки Tools: в установленном каталоге Android SDK найдем папку tools и заменим ее содержимое на архивную версию Android SDK Tools 25.2.5. Не обновляем утилиты через SDK Manager выше указанной версии, чтобы не перезаписать исполняемые файлы Ant-генератора.
3. Установка компонентов SDK: убедимся, что установлены Android SDK Platform-tools, Android SDK Build-tools и платформы API (например, API 24 или API 25), которые запрашивает мобильная платформа 1С.
4. Настройка JDK: установим JDK 8 (1.8) соответствующей разрядности (для 64-битной 1С ставим x64).
5. Проверка переменных окружения: пропишем в системе переменные JAVA_HOME=C:\Android\JDK8, ANDROID_HOME=C:\Android\SDK, а в переменную PATH добавим пути к %JAVA_HOME%\bin и %ANDROID_HOME%\platform-tools.
6. Указание путей в сборщике 1С: в конфигурации сборщика мобильных приложений заполним пути к Android SDK, JDK и Ant, а также зададим рабочий каталог C:\temp_build.

Способ 2. Ручная сборка через Gradle и Android Studio

Более современный и гибкий подход — собрать мобильное приложение напрямую с использованием системы сборки Gradle без использования устаревших версий Android SDK Tools. Рассмотрим последовательность действий:

1. Выгрузка конфигурации: в конфигураторе мобильного приложения выгрузим мобильную конфигурацию в файл с расширением .1cema через меню Конфигурация — Мобильное приложение — Записать конфигурацию.
2. Подготовка исходного проекта: распакуем архив мобильной платформы (поставляется на диске ИТС / портале 1С), в котором содержится готовый каркас проекта под Android для сборки через Gradle.
3. Размещение ресурсов: перенесем полученный файл .1cema, файлы лицензий, графические иконки и заставки в соответствующие каталоги ассетов и ресурсов проекта.
4. Импорт в Android Studio: откроем подготовленную папку проекта в Android Studio. Студия автоматически выполнит синхронизацию зависимостей Gradle.
5. Сборка APK: выполним компиляцию проекта через меню среды разработки или с помощью командной строки в корне проекта: gradlew assembleDebug Для релизной сборки запустим: gradlew assembleRelease

Способ 3. Подпись пакета (Keystore, Zipalign, Apksigner)

Для установки и работы приложения на реальных мобильных устройствах под управлением современных версий Android итоговый APK-пакет должен быть правильно выровнен и подписан. Проанализируем порядок действий:

1. Создание ключа: сгенерируем хранилище ключей при помощи утилиты keytool из комплекта JDK:
   Скопировать код

   
   keytool -genkey -v -keystore my-release-key.keystore -alias my_alias -keyalg RSA -keysize 2048 -validity 10000
   

2. Выравнивание архива (zipalign): перед подписанием выровняем байты APK с помощью утилиты zipalign из состава build-tools: zipalign -v -p 4 app-unsigned.apk app-aligned.apk
3. Подпись через apksigner: подпишем пакет современной схемой подписи (v2/v3):
   Скопировать код

   
   apksigner sign --ks my-release-key.keystore --ks-key-alias my_alias --out app-release.apk app-aligned.apk
   

4. Проверка подписи: убедимся, что пакет корректно подписан: apksigner verify -v app-release.apk

Соблюдение соответствия версий утилит сборки, использование путей без кириллицы и переход на Gradle-сборку гарантируют стабильное получение рабочего установочного файла APK.