Android

После того, как ваше приложение будет готово, его можно экспортировать под выбранную операционную систему (или под несколько при необходимости).

С помощью конструктора EV Toolbox вы можете собрать приложение под мобильную операционную систему Android. Чтобы экспортировать проект в виде Android-приложения в формате .apk/.aab откройте диалог экспорта и в панели слева выберите Android в качестве целевой платформы. Откроется список параметров будущего приложения.

Важно

1. Перед тем, как произвести сборку (экспорт) приложения, убедитесь, что у вас настроена среда окружения Android.

2. В связи с архитектурными особенностями мобильных операционных систем для мобильных приложений кнопку выхода делать не нужно, так как такие операционные системы не подразумевают выход из приложения в привычном понимании.

3. Если вы внесете любые новые изменения в приложение, то такое приложение необходимо будет заново экспортировать (собрать) и еще раз установить на устройство.

Для приложения можно настроить следующие параметры:

  • Имя файла: параметр позволяет указать директорию, куда будет экспортировано приложение и задать его имя.

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

Важно

В связи с особенностями работы операционной системы Android и системой сборки приложений под нее, для корректного экспорта важно, чтобы путь к файлу и имя содержали только буквы латинского алфавита без специальных символов (№, #, ~ и т.д).

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

Обратите внимание, что под платформу Android приложение будет собрано в формате apk или aab

Android App Bundle – это новый официальный формат публикации приложений в Google Play, который предлагает более эффективный способ создания и выпуска приложения. AAB – это формат публикации, который включает в себя весь скомпилированный код и ресурсы вашего приложения, а также откладывает создание APK и подписку в Google Play. Компания Google поясняет, что AAB более универсальный, «пакетный» формат, который позволит уменьшить объем приложений и адаптировать их для разных устройств.

  • Имя приложения: параметр позволяет указать задать имя приложения, которое будет отображаться для приложения непосредственно после

его установки на целевое мобильное устройство.

В имени приложений можно использовать русские буквы и специальные символы.

Примечание

В чем отличие имени файла от имени приложения?

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

  • Имя java пакета: Настройка данного параметра связана с настройками среды окружения Android.

Java пакет – это уникальный внутренний идентификатор приложения. Для разных версий одного и того же приложения следует использовать один и тот же идентификатор.

Итоговое имя java пакета формируется из префикса + первого название проекта, под которым он был сохранено.

Префикс имени Java пакета - префикс Java пакета, который добавляется к итоговому имени Java пакета при создании Android-приложения.

Примечание

В версиях 3.2.Х по умолчанию в настройках среды окружения Android уже задан префикс имени Java пакета.

Начиная с версии 3.3.0 в конструкторе EV Toolbox префикс java пакета в настройках среды окружения Android не заполнен автоматически. Это может привести к ситуации, когда вместо корректного имени java пакета программа автоматически заполнит только короткий вариант имени в окне экспорта, подставив только имя файла evproj, под которым был сохранен проект.

При использовании такого имени java пакета приложение будет экспортировано без ошибки и будет запускаться на тестовых устройствах, которые вы используете при проверке работы приложения, однако при выкладке такого приложения в онлайн сторы могут возникнуть проблемы, поэтому важно сразу корректно заполнять такую настройку, чтобы в дальнейшем не выявлять ошибку и не тратить на это временные ресурсы.

Важно

  1. Каждое слово в имени java пакета должно быть разделено точкой.

2. В имени java пакета не допускается использование пробелов. Если вам необходимо написать словосочетание, то вы можете написать его слитно, например CompanyName или только разделив точкой: Company.Name.

  1. В имени java пакета можно использовать цифры, однако цифру нельзя использовать сразу после точки.
  • Версия приложения: параметр позволяет указать версию релиза кода приложения, которую пользоаатель может увидеть в описании приложения в онлайн сторе.

По умолчанию в параметре Версия приложения установлена версия 1.0

  • versionCode: VersionCode - целое число, которое представляет собой версию кода приложения относительно других версий.

В отличие от Версии приложения, versionCode – это внутренний параметр, который пользователь не увидит. Вы можете установить для значения любое целое число, какое выберете, однако необходимо помнить, что следующая версия приложения (обновление) должно иметь последовательно увеличенный номер версии. Система не принуждает к такому поведению, однако увеличение номера версии с новым релизом является нормой.

По умолчанию в параметре versionCode установлено значение 1.

  • ABIs (архитектура): параметр позволяет выбрать арихитектуру процессоров мобильных целевых устройств, на которых будет запускаться приложение.

АРМ — это архитектура процессора, которую разработала одноименная компания ARM Limited. Такая архитектура мобильного процессора напрямую связана с его разрядностью, которая в свою очередь может быть 64-bit (arm64-v8a) и 32-bit (armeabi-v7a).

Архитектура arm64-v8a имеет преимущества перед armeabi-v7a в области расширенного количества инструкций процессора, а также увеличенного числа регистров общего назначения. Это может дать ощутимый прирост в производительности при работе приложений, а также влияет на оптимизацию их работы на устройстве.

Примечание

Большинство современных мобильных процессоров в устройствах на платформе Android имеют архитектуру arm64.

Важно

Обратите внимание, что в списке архитектур также можно выбрать архитектуру x86. Выбирать такую архитектуру необходимо, если сборка приложения осуществляется для очков дополненной реальности Epson Moverio BT 300/BT-350.

  • Ориентация экрана: параметр позволяет выбрать в какой оринетации будет работать собранное приложение на мобильном целевом устройстве.
Ориентация Описание Пример
portrait/userPortrait

Приложение запускается и работает только в портретной ориентации на смартфоне/планшете.

Портретная (книжная) ориентация заставляет работать приложение в книжной ориентацию независимо от данных датчика (акселерометр/гироскоп).

../../_images/portrait.png
landscape/userLandscape

Приложение запускается и работает только в альбомной ориентации на смартфоне/планшете.

Альбомная ориентация заставляет работать приложение в альбомной ориентации независимо от данных датчика (акселерометр/гироскоп).

../../_images/landscape.png
fullUser

Приложение запускается и работает и в портретной и в альбомной ориентации на смартфоне/планшете.

Если пользователь перевернет мобильное устройство, ориентация приложения будет повернута вслед за поворотом устройства. fullUser заставляет приложение использовать предпочтительную (выбранную) пользователем ориентацию.

Если включен автоматический поворот, можно использовать все 4 ориентации.

../../_images/fulluser.png
locked При запуске приложения фиксирует его ориентацию в текущей ориентации мобильного устройства. Иными словами: если вы держали смартфон в портретной ориентации и запустили приложение, то оно останется работать только в портретной ориентации до следующего запуска приложения.  
  • Иконка приложения: параметр позволяет установить свою иконку для приложения.

Иконка приложения – это важная и неотъемлемая часть самого приложения, поскольку сегодня она является лицом приложения в онлайн сторах.

По умолчанию для иконки выставлено стандартное изображение с логотипом EV.

Изображение для иконки приложения можно загрузить из сети Интернет или создать самостоятельно. Для собственной иконки необходимо использовать квадратное изображение не меньше 512 пикселей в ширину.

  • Изображение при загрузке: параметр позволяет установить свою изображение для экрана загрузки.

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

Примечание

Изображение при загрузке важно подобрать под выбранную ориентацию экрана приложения. Если вы выбрали ориентацию fullUser, то важно выбрать такое изображение, которое будет хорошо выглядеть на экране загрузки при любой ориентации мобильного устройства.

Важно

В связи с особенностями работы операционной системы Android и системой сборки приложений под нее, для корректного экспорта важно, чтобы путь к файлу иконки и изображения при загрузке и их имена содержали только буквы латинского алфавита без специальных символов (№, #, ~ и т.д).

  • Файлы конфигурации: параметр позволяет выбрать файлы конфигурации, которые будут использоваться при сборке приложения под то или иное целевое устройство.
Кофигурация утройства Описание Пример
General Android Device Позволяет выбрать файлы конфигурации, необходимые для экспорта (сборки приложения) под любое мобильное устройство: смартфон/планшет/очки дополненной реальности. ../../_images/device.png
HTC Vive Focus (WaveVR)

Позволяет выбрать файлы конфигурации, необходимые для экспорта (сборки приложения) под автономные беспроводные шлемы HTC Vive Focus/HTC Vive Focus Plus.

Альбомная ориентация заставляет работать приложение в альбомной ориентации независимо от данных датчика (акселерометр/гироскоп).

../../_images/vive_focus_plus.png
Oculus Quest, Quest 2 (OVR) Позволяет выбрать файлы конфигурации, необходимые для экспорта (сборки приложения) под автономные беспроводные шлемы Meta* Quest/Meta*Quest 2. ../../_images/oculus_quest.png
User Presete

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

Самостоятельно вносить изменения в файлы конфигурации возможно только если вы разбираетесь в их структуре.

 
  • Опции Gradle: параметр позволяет определить уровень логгирования - количество выводимой в консоль информации при запуске экспорта.

Для параметра возможны значения default (пустой параметр по умолчанию), -q, -w, -i, -d или –quiet, –warn, –info, –debug по возрастанию количества информации.

  • Целевой уровень API: параметр позволяет указать версию, на которой должно выполняться приложение.

API или Application Programming Interface (программный интерфейс приложения) - это интерфейс, который обеспечивает связь между двумя разными “частями” программного обеспечения и определяет функциональность, которую предоставляет программа.

По мере развития платформы Android и выпуска новых версий Android каждой версии Android назначается уникальный целочисленный идентификатор - уровень API. Таким образом, каждая версия Android соответствует одному уровню API Android.

По умолчанию целевой уровень API установлен как 31, так как начиная с ноября 2022 года новые приложения должны быть ориентированы на Android 12 (API level 31). Это означает, что приложения могут поддерживать любую более старую версию системы, но при этом должны учитывать преимущества Android 12

Примечание

Требования к уровню целевых API приложений поднимаются ежегодно.

  • Использование камеры/Использование ARCore: параметр позволяет определить необходимость использования камеры и технологии ARCore в приложении.

Эти параметры важны для приложений, которые будут распространятся в онлайн сторах. Они будут влиять на возможность загрузки и установки приложения на конкретное мобильное устройство.

Для параметров можно выбрать одно из двух значений: “Опционально” и “Требуется”.

При выборе значение “Требуется” для параметра ARCore загрузить приложение из онлайн стора смогут только владедьцы тех устройств, которые поддерживают технологию ARCore.

Если же для параметра будет установлено значение “Опционально”, то список устройств, на которых можно будет загрузить и установить приложение не будет ограничен только устройствами с поддержкой технологии ARCore.

Аналогично работает параметр «Использование камеры».

* - Meta запрещена в РФ как экстремистская организация.