При самостоятельной сборке мобильных приложений на платформе 1С разработчики часто сталкиваются с устареванием инструкций по установке Android SDK. В прошлых версиях Android SDK поставлялся в виде отдельного самостоятельного установщика или архива, однако в современных версиях основным способом его получения является установка среды Android Studio либо использование консольных утилит Command-line tools. Разберем по шагам, как подготовить окружение и настроить Сборщик мобильных приложений 1С.
Шаг 1. Подготовка Java Development Kit (JDK) и путей установки
Прежде чем приступать к настройке инструментов Android, проанализируем требования к Java Development Kit. Мобильная платформа 1С чувствительна к версии JDK и структуре путей в операционной системе.
Выбор версии JDK: убедимся, что установлена поддерживаемая версия пакета разработки (например, OpenJDK 8, OpenJDK 11 или OpenJDK 17 в зависимости от релиза мобильной платформы 1С). Обязательно должен быть установлен именно JDK, а не только среда исполнения JRE.
Требования к путям: каталоги установки JDK, Android SDK и рабочей директории Сборщика мобильных приложений не должны содержать пробелов, кириллических символов и знаков препинания. Рекомендуем задавать простые пути, такие как C:\Java\jdk и C:\Android\sdk.
Настройка системных переменных окружения: создадим системную переменную JAVA_HOME, указывающую на каталог с JDK (например, C:\Java\jdk11), и системную переменную ANDROID_HOME (или ANDROID_SDK_ROOT) с путем к каталогу Android SDK. Также добавим пути к подкаталогам bin в переменную PATH.
Шаг 2. Установка Android SDK через Android Studio
Рассмотрим стандартный и наиболее простой способ развертывания компонентов SDK с использованием официальной среды разработки:
Скачаем и установим Android Studio. При установке укажем путь к SDK без кириллицы и пробелов.
Откроем Android Studio и перейдем в меню SDK Manager (на стартовом экране через меню More Actions или через настройки Settings > Appearance & Behavior > System Settings > Android SDK).
На вкладке SDK Platforms выберем требуемую целевую версию Android (API Level), поддерживаемую используемой версией мобильной платформы 1С.
На вкладке SDK Tools обязательно отметим следующие компоненты:
Android SDK Build-Tools (необходимой версии);
Android SDK Platform-Tools;
Android SDK Command-line Tools (latest) — обязательный компонент для сборки через внешние утилиты и Сборщик 1С.
Применим изменения и дождемся завершения загрузки компонентов.
Шаг 3. Альтернативный вариант: установка без полной среды Android Studio
Если нет необходимости устанавливать тяжелую среду разработки, разберем альтернативный вариант через консольные утилиты:
Загрузим отдельный архив Command line tools.
Распакуем его в созданный каталог SDK, сформировав правильную структуру папок: C:\Android\sdk\cmdline-tools\latest\bin.
Запустим командную строку и перейдем в указанную папку утилит.
Установим необходимые пакеты с помощью консольного менеджера пакетов sdkmanager, выполнив команды для загрузки platform-tools, build-tools и целевой platforms.
Шаг 4. Принятие лицензионных соглашений
Выясним частую причину сбоя при первой сборке: Сборщик мобильных приложений не может выполнить компиляцию, если не подтверждены лицензии Android SDK. Для их активации выполним команду в консоли:
cd C:\Android\sdk\cmdline-tools\latest\bin
sdkmanager --licenses
В процессе работы утилиты последовательно подтвердим согласие со всеми пунктами, нажимая клавишу y и Enter для каждого блока лицензий.
Шаг 5. Настройка конфигурации в Сборщике мобильных приложений 1С
После подготовки окружения запустим актуальную версию конфигурации «Сборщик мобильных приложений» и заполним параметры окружения:
В настройках параметров сборки укажем путь к каталогу Android SDK (например, C:\Android\sdk).
Укажем путь к установленному JDK (например, C:\Java\jdk11).
Зададим параметры цифровой подписи приложений (файл хранилища ключей keystore, псевдоним ключа alias и пароли), созданные с помощью утилиты keytool из комплекта JDK.
Сохраним настройки и выполним тестовую сборку мобильного приложения.