Создание установочного файла

После того, как функционал реализован, необходимо сохранить внесенные изменения в файл с расширением «.apc». Сохранение производится в «Конфигураторе» с помощью команд меню «Файл → Сохранить» (также можно воспользоваться горячими клавишами «Ctrl+S»). Далее необходимо провести сборку нового приложения и установить его на МУ.

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

Теперь можно приступать к сборке. Для этого в «Конфигураторе» нужно выполнить команду «Собрать заново» (меню «Сборка → Собрать заново») или воспользоваться горячими клавишами «Ctrl+Shift+R». По завершении сборки в папке хранения исходного apc-файла конфигурации будет создан файл сборки с расширением «config.apb».

Установить приложение на МУ можно двумя способами: напрямую при подключении МУ к ПК, или запустив установочный apk-файл непосредственно на МУ.

Для установки напрямую из «Конфигуратора», МУ должно быть подключено к ПК с помощью USB-кабеля в режиме «Отладка по USB». Проверить корректность подключения МУ к ПК можно с помощью утилиты «monitor.bat» (утилита доступна в папке установки «Android SDK», в папке «Tools») – МУ должно отображаться в списке устройств в этом утилите. Для того чтобы установить приложение на МУ, необходимо в «Конфигураторе» выполнить команду «Запустить» (меню «Сборка → Запустить») или нажать на клавишу «F5».

Если нет возможности установить напрямую apk-файл на МУ, то возможно из Конфигуратора создать apk-файл, скопировать его на МУ и установить. Чтобы создать установочный apk-файл приложения, необходимо последовательно выполнить команды «Собрать заново» (меню «Сборка → Собрать заново») и «Создать установочный файл» (меню «Сборка → Создать установочный файл»). После этого в папке, указанной в параметрах сборки в поле «Путь к создаваемому файлу» будет создан установочный apk-файл приложения, который можно скопировать на МУ (во встроенную или внешнюю карту памяти) и установить.

Возможные ошибки

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

1. Ошибка «Не найдена утилита »jarsigner»». Ошибка может быть связана с тем, что на ПК не установлена утилита «Java SE Development Kit». В «Конфигураторе» реализована поддержка всех версий утилит JDK до проверенной версии. Если используется другая версия JDK, то необходимо ее переустановить до указанной версии. Относительно версии «Android SDK», то в работе мы рекомендуем использовать последнюю версию «SDK».  После того, как «Android SDK» и «JDK» установлены на ПК необходимо в настройках Конфигуратора (меню «Сервис → Настройки» закладка «Андроид») указать пути к папкам установки. 

2. Ошибка при подписывании файлом «jarsigner».  Данная ошибка может быть связана с неверно установленными параметрами сборки. Для решения проблемы необходимо в Конфигураторе перейти по пунктам меню «Сборка → Параметры» и проверить значение настройки «Путь к создаваемому файлу» и «Путь к исходному файлу». В значении данных настроек должен быть указан полный путь к создаваемому файлу с указанием его наименования и путь к исходному файлу (путь к исходному apk-файлу платформы «Агент Плюс 2.0»). Конфигуратор по завершении сборки создаст в папке, указанной в поле «Путь к создаваемому», файл с названием, заданным в этом же поле. Файл может изначально отсутствовать в данной папке. 

3. Также при установке дистрибутива приложения на экране МУ может возникнуть ошибка: «Приложение не установлено» или «Приложение остановлено, т.к. имеет конфликтующую подпись». Данная ситуация связана с тем, что на МУ, скорее всего, уже установлено приложение, созданное на платформе «Агент Плюс 2.0», а устанавливаемая сейчас версия подписана другим сертификатом. Для переустановки мобильного приложения на ОС Android поверх более ранней версии, обе версии должны иметь единый сертификат. В этом случае необходимо предыдущую версию приложения обязательно удалить. Если производить на МУ постоянно установку версий, подписанных одним сертификатом, то предварительное удаление приложения не требуется. 

Удаление приложения проводится с помощью «Менеджера приложений», стандартными средствами ОС Android:

меню «Settings (Настройки) → Applications (Приложения) → Manage Applications (Менеджер приложений) → Agent+ 2.0» кнопка «Uninstall (Удаление)».

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

Указанная ошибка «Неопределенное имя («ТекКонтрол»)» возникла строке 4433 модуля формы диалогов «ФормаЖурналаДокументов». Описание всех кодов ошибок компиляции приведено в разделе «Коды ошибок компиляции».