Мобильное приложение на 1С

Установка эмулятора Genymotion

Разработаем простое мобильное приложение на 1С для Android. Для тестирования можно использовать физическое устройство (свой смартфон или планшет), но гораздо удобнее использовать виртуальное. Для этого нужно установить эмулятор, например Genymotion.

Скачать эмулятор можно здесь. Для Windows будет доступно две версии: с VirtualBox и без него:

Genymotion

Если уже есть установленный VirtualBox, то можно скачать без него. Иначе скачиваем с VirtualBox, это нижняя ссылка. Затем нужно запустить скачанный файл и установить VirtualBox и Genymotion. Здесь не должно возникнуть сложностей.

После этого нужно запустить Genymotion. В открывшемся окне нужно добавить новое виртуальное устройство:

Genymotion

Слева можно настроить отборы, справа выбрать какое устройство будем создавать. Например, выберем версию Android 7.0, устройство Custom Phone:

Genymotion

Нажмем справа внизу кнопку Next и будет открыто окно для настройки создаваемого устройства. Уменьшим разрешение экрана до 480х800 (чем выше разрешение, тем сильнее будет тормозить эмулятор), 240 HDPI, а также уменьшим количество процессоров до 2-х и память до 1024 МБ:

Genymotion

Нажмем кнопку Install и начнется скачивание образа виртуального устройства:

Genymotion

После скачивания образа в списке появится новое устройство, которое можно запустить, выбрав в меню команду Start:

Genymotion
Genymotion

Можно сразу в настройках включить русский язык: Settings – Language & Input – Language, добавить новый язык и поставить его на первое место:

Genymotion

Иногда бывает, что виртуальная машина не запускается, при этом Genymotion не пишет каких-то внятных ошибок. Чтобы увидеть ошибку нужно запустить VirtualBox, выделить созданную нами виртуальную машину и нажать Запустить:

VirtualBox

В этом случае хотя бы можно будет увидеть ошибку и поискать решение в интернете.

Установка мобильной платформы

Теперь нужно установить мобильную платформу. Если у Вас нет доступа к мобильной платформе, то можно скачать учебную версию, но она имеет ряд ограничений. Если доступ есть, то можно скачать здесь.

Распаковываем скачанный архив с мобильной платформой и из папки Android копируем файл 1cem-x86.apk в какое-нибудь другое место. Это 32-х разрядная мобильная платформа для процессоров архитектуры x86. В этой же папке есть файл 1cem-arm.apk. Это 32-х разрядная мобильная платформа для процессоров архитектуры ARM. Про разницу между архитектурами x86 и ARM можно почитать здесь. Но так как у меня процессор intel, то я буду использовать файл 1cem-x86.apk.

Установка мобильных приложений с ПК на мобильное устройство выполняется с помощью утилиты Android Debug Bridge (adb). После установки Genymotion данная утилита находится в папке C:\Program Files\Genymobile\Genymotion\tools (при условии, что Genymotion был установлен на диск C). Для удобства можно добавить путь к adb в системную переменную среды Path (Мой компьютер — Свойства — Дополнительные параметры системы — Закладка Дополнительно — Переменные среды):

Переменные среды

Теперь нужно запустить командную строку от имени администратора и выполнить команду adb install F:/1cem-x86.apk. F:/1cem-x86.apk — это путь до файла с мобильной платформой 1С.

adb

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

Мобильная платформа

При запуске будет открыт список приложений (конфигураций), который пока пуст:

Мобильная платформа

В эмуляторе Genymotion можно установить мобильную платформу просто перетянув файл мобильной платформы из проводника Windows на экран эмулятора:

Genymotion

Чтобы можно было устанавливать приложения из apk-файлов в разделе Настройки — Безопасность нужно разрешить установку из неизвестных источников:

Настройки - Безопасность

Для установки мобильной платформы на физическое устройство через USB-кабель нужно разрешить отладку по USB. Сначала нужно включить режим разработчика. Для этого в разделе Настройки — О телефоне нужно 5-8 раз нажать на Номер сборки:

Номер сборки

После этого в настройках появится пункту меню Для разработчиков:

Для разработчиков

И уже в нем нужно разрешить отладку по USB:

отладка по USB

Сразу после тестирования нужно запретить отладку по USB! Иначе на Ваш смартфон могут быть установлены вирусы!

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

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

Приложение для мобильной платформы

Добавим произвольную общую форму:

общая форма

И в модуле формы в обработчике ПриСозданииНаСервере добавим следующий код:

Добавим общую форму на начальную страницу (правой кнопкой по корню конфигурации — Открыть рабочую область начальной страницы):

начальная страница

А также изменим имя конфигурации:

имя конфигурации

Обновим конфигурацию базы данных.

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

Параметры

В открывшемся окне нужно перейти на закладку Запуск 1С:Предприятия — Мобильные приложения. Здесь нужно установить флаг Использовать «Android Debug Bridge» для запуска мобильных приложений, а также указать путь к Android SDK и к дистрибутиву мобильной платформы:

Использовать "Android Debug Bridge"

Каталог Android SDK — это каталог, в котором находится утилита adb.

Дистрибутив мобильной платформы и мобильного клиента — это путь к скачанному архиву с мобильной платформой.

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

Публиковать

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

В открывшемся окне нужно снять флаг Создавать виртуальный каталог на веб-сервере, указать Каталог, куда будет записан файл мобильной конфигурации (лучше использовать только латиницу), а также установить флаг Обновлять мобильное приложение при обновлении конфигурации базы данных:

Каталог

После это нужно нажать на кнопку Опубликовать.

Для переноса мобильной конфигурации на виртуальную машину нужно выбрать пункт меню Отладка — Начало отладки — Мобильное приложение: начать отладку:

Мобильное приложение

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

Мобильная конфигурация

На виртуальной машине будет запущено приложение и показано сообщение «Привет, мир»:

Привет, мир

Если нажать ОК и выйти из приложения кнопкой назад, то мы попадем в список всех приложений (конфигураций) мобильной платформы, где пока что есть только одна, разработанная нами конфигурация:

Мобильная платформа

Сборка мобильного приложения

Выполним сборку мобильного приложения, чтобы запускать его не через мобильную платформу, а как отдельное приложение.

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

Сборщик мобильных приложений

Также для сборки потребуется установленная Java и Android SDK.

Java можно скачать тут. С установкой не должно возникнуть проблем. Путь к Java также желательно добавить в системную переменную среды Path, если он автоматически не был добавлен туда. Чтобы проверить установлена ли Java и какой версии можно в командной строке выполнить команду java -version:

Java

Для установки Android SDK можно скачать Android Studio и через него установить все необходимое. Android Studio можно скачать по этой ссылке, проблем с установкой также не должно быть. При установке нужно будет выбрать путь для установки Android SDK, здесь нужно выбирать путь только на латинице, желательно покороче и без пробелов, например: C:\AndroidSDK.

Для сборки на мобильной платформе 8.3.19 нужна версия SDK API 29. Чтобы скачать нужную версию SDK нужно запустить Android Studio и в стартовом окне нажать на гиперссылку More Actions и выбрать пункт SDK Manager:

SDK Manager

В открывшемся окне, на закладке SDK Platforms нужно отметить нужную версию API и нажать ОК. Будут скачаны файлы выбранной версии SDK. 31 версия (последняя на 17.08.2021) была установлена вместе с Android Studio.

SDK Platforms

Теперь нужно выполнить настройку параметров сборщика. Для этого в сборщике мобильных приложений нужно выбрать Сервис — Настройка параметров сборщика:

Настройка параметров сборщика

В открывшемся окне нужно нажать на кнопку Создать:

Настройка параметров сборщика

Будет открыто окно для заполнения путей к компонентам:

Настройка параметров сборщика

Рабочий каталог и кеш сборщика — это произвольный каталог, будет использоваться при сборке приложения.

JDK — это путь к Java.

Android SDK — это путь к Android SDK.

После этого нужно выполнить настройку параметров поставщика:

настройка параметров поставщика

Так как будем собирать для Android, то на закладке Общие параметры нужно установить флаг Для ОС Android:

настройка параметров поставщика

Появится закладка Параметры для ОС Android. Здесь нужно указать Префикс идентификатора приложения для ОС Android (например ru.test) и создать Ключ подписи приложений:

настройка параметров поставщика

Для создания ключа нужно нажать на кнопку с плюсом:

Ключ подписи приложений

Будет открыто окно где нужно ввести параметры ключа и нажать Сформировать ключ:

Ключ подписи приложений

Хеш ключа будет заполнен в поле Хеш SHA-1 ключа подписи.

Теперь нужно загрузить мобильную платформу в сборщик. Для этого нужно перейти в раздел Мобильные версии, добавить новый элемент и выбрать архив с мобильной платформой. После загрузки будет создан новый элемент справочника, в котором будут указаны параметры мобильной платформы, в том числе версия API, которую нужно использовать при сборке (именно поэтому мы скачивали 29 версию API SDK):

Мобильные версии

В свойствах конфигурации нужно заполнить поставщика и версию:

Затем выбрать пункт меню Конфигурация — Мобильное приложение — Записать в файл и выбрать каталог, куда будет записана мобильная конфигурация.

Записать в файл

В сборщике в разделе Мобильные конфигурации нужно нажать на кнопку Загрузить конфигурацию, выбрать файл с записанной мобильной конфигурацией и нажать Загрузить:

Загрузить конфигурацию

Будет создана группа и в ней элемент с мобильной конфигурацией:

Мобильные конфигурации

После загрузки конфигурации будет предложено создать группу справочника Мобильные приложения. Можно согласиться и заполнить параметры как на рисунке:

Мобильные приложения
Мобильные приложения

В поле Мобильная платформа нужно выбрать элемент справочника Мобильные платформы. А на закладке Конфигурации и представления в поле Источник нужно выбрать группу с мобильной конфигурацией.

После этого в этой группе (справочника Мобильные приложения) нужно создать новый элемент и нажать на кнопку Собрать приложение:

Собрать приложение

Начнется процесс сборки приложения, по окончании которого на закладке Результаты сборки можно будет сохранить собранное приложение на диск:

Результаты сборки

Для установки мобильного приложения на виртуальную машину нужно в командной строке ввести команду adb install F:/ru.test.test-x86.apk

adb

На виртуальной машине в списке приложений появится новое приложение. Уже не в составе мобильной платформы, а как отдельное приложение:

приложение

При запуске будет открыта общая форма и выведено сообщение «Привет, мир»:

Привет, мир

Содержание курса


Подписывайтесь на группу ВКонтакте , где я публикую ссылки на новые статьи с данного сайта, а также интересные материалы с других ресурсов по программированию в 1С
Понравилась статья? Поделиться с друзьями:
Добавить комментарий

;-) :| :x :twisted: :smile: :shock: :sad: :roll: :razz: :oops: :o :mrgreen: :lol: :idea: :grin: :evil: :cry: :cool: :arrow: :???: :?: :!:

Используя этот сайт, Вы даете согласие на использование cookies. На данном этапе Вы можете отказаться от использования cookies, настроив необходимые параметры в своем браузере.
ok