После того, как функционал реализован, необходимо сохранить внесенные изменения в файл с расширением ".apc". Сохранение производится в "Конфигураторе" с помощью команд меню "Файл - Сохранить" (также можно воспользоваться горячими клавишами "Ctrl+S"). Далее необходимо провести сборку нового приложения и установить его на МУ.
Перед тем, как приступать к сборке, необходимо в "Конфигураторе" предварительно установить параметры сборки. Параметры сборки устанавливаются в соответствующем окне, которое можно открыть, перейдя по пунктам меню "Сборка - Параметры". В открывшемся окне необходимо заполнить поля "Путь к создаваемому файлу" и "Путь к исходному файлу". Более подробное описание данных настроек приведено в разделе "Сборка и запуск конфигурации".
Теперь можно приступать к сборке. Для этого в "Конфигураторе" нужно выполнить команду "Собрать заново" (меню "Сборка – Собрать заново") или воспользоваться горячими клавишами "Ctrl+Shift+R". По завершении сборки в папке хранения исходного apc-файла конфигурации будет создан файл сборки с расширением "config.apb".
Установить приложение на МУ можно двумя способами: напрямую при подключении МУ к ПК, или запустив установочный apk-файл непосредственно на МУ.
Для установки напрямую из "Конфигуратора", МУ должно быть подключено к ПК с помощью USB-кабеля в режиме "Отладка по USB". Проверить корректность подключения МУ к ПК можно с помощью утилиты "monitor.bat" (утилита доступна в папке установки "Android SDK", в папке "Tools") – МУ должно отображаться в списке устройств в этом утилите. Для того чтобы установить приложение на МУ, необходимо в "Конфигураторе" выполнить команду "Запустить" (меню "Сборка - Запустить") или нажать на клавишу "F5". Кроме этого, к ПК должно быть подключено только одно МУ (эмулятор ОС "Android" также считается МУ), иначе приложение не будет установлено!
Если нет возможности установить напрямую 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 модуля формы диалогов "ФормаЖурналаДокументов". Описание всех кодов ошибок компиляции приведено в разделе "Коды ошибок компиляции".