Отладка android приложений собраны в Qt Creator на реальных устройствах

Подготовка android устройства

Для того чтобы вы смогли производить отладку приложений на вашем Android устройстве вам необходимо включить режим отладки по USB. Эта возможность скрыта во всех версиях Android начиная с 4.2.

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

Чистый андроид
  1. Чтобы стать разработчиком сначала зайдите в «Настройки» -> «О телефоне» и семь раз нажмите на пункте «Номер сборки»;
  2. Затем в главном меню настроек появится пункт «Для разработчиков»;
  3. Тут необходимо поставить галочку напротив раздела «Разрешить отладку по USB». Нажмите Ok в ответ на появившееся предупреждение;
  4. Теперь ваш телефон готов к работе.
MIUI
  1. Переходим в меню вашего девайся в раздел «Настройки»;
  2. Выбираем пункт «О телефоне»;
  3. Ищем строку «Версия MIUI» и жмем несколько раз по версии вашей прошивки, пока снизу не высветится уведомление «Поздравляем! Вы стали разработчиком!»;
  4. Возвращаемся назад в раздел «Настройки»;
  5. В «Настройках» ищем раздел «Расширенные настройки» и переходим в него;
  6. Ищем раздел «Для разработчиков» и переходим в него;
  7. Ищем в разделе «Для разработчиков» пункты «Отладка по USB» и активируем;
  8. После чего на экране смартфона появится запрос «Разрешить отладку по USB?», нажимаем «Да».

Установка Google USB Driver

Скачать Google USB Driver можно несколькими способами (нужно только для Windows):

  • Через SDK Manager Android Studio (вкладка SDK Tools компонент Google USB Driver). Скачанный драйвер будет лежать в каталоге [путь к корневой папке sdk]/extras/google/usb_driver;
  • Через консольную утилиту sdkmanager;
  • Как отдельный компонент с официального сайта (прямая ссылка).

Подключите телефон к компьютеру с помощью USB кабеля.

В некоторых случаях телефон сам подберёт ADB драйвер, если этого не произошло, откройте Диспетчер устройств и найдите в списке Другие устройства пункт ABD Interface с символом восклицательного знака. Щелкните ПКМ и выберите Обновить драйверы…

Отладка android приложений собраны в Qt Creator на реальных устройствах
Рис. 1 Диспетчер устройств

В открывшемся окне Мастера обновления драйверов выберите Выполнить поиск на этом компьютере.

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

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

Отладка android приложений собраны в Qt Creator на реальных устройствах
Рис. 2 Тип устройства

Нажмите кнопку Установить с диска.

В открывшемся окне нажмите кнопку Обзор и укажите путь к .inf файлу расположенному в корневой папке Google Usb Driver (зависит от того куда вы его скачали) и нажмите Ок.

Отладка android приложений собраны в Qt Creator на реальных устройствах
Рис. 3 Путь к Google USB Driver

Из списка выберите Android ADB Interface и нажимайте Далее.

Появится окно с предупреждением. Согласитесь и продолжите установку.

Отладка android приложений собраны в Qt Creator на реальных устройствах
Рис. 4 Предупреждение

В результате в списке устройств должно получиться что-то вроде этого:

Отладка android приложений собраны в Qt Creator на реальных устройствах
Рис. 5 Диспетчер устройств после установки

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

Все дальнейшие действия предполагают, что вы уже настроили Qt Creator для сборки приложений под android ОС.

Проверять корректность настроек будем на стандартном примере Qt SCXML Calculator QML Example. Выберите его из списка и перейдите к настройкам проекта. Здесь необходимо выбрать комплект сборки под android.

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

Отладка android приложений собраны в Qt Creator на реальных устройствах
Рис. 6 Каталог сборки

Ниже, в разделе Сборка, этапы, выберите ABI armeabi-v7a. В зависимости от устройства или эмулятора на котором вы будете проводить отладку, убедитесь, что выбран соответствующий ABI (для реальных, устройств чаще всего — armeabi-v7a для эмуляторов -x86).

Отладка android приложений собраны в Qt Creator на реальных устройствах
Рис. 7 Выбор ABI

В разделе Сборка Android SDK выберите из списка установленных SDK подходящий под устройство на котором вы планируете проводить отладку. Подходит любой SDK выше или того же уровня, что и используемый на целевом устройстве.

Отладка android приложений собраны в Qt Creator на реальных устройствах
Рис. 8 Выбор сборочный SDK

Внимание! У разных версий Qt разные ограничения на уровни поддерживаемых SDK. Эту информацию можно узнать на официальном сайте разработчиков. Qt 5.14 поддерживает SDK уровня 21 и выше. Это означает, что Qt 5.14 не позволит собрать приложение для устройств поддерживающих только API ниже 21 версии. В реальности, для Qt 5.14, рекомендуется выбирать SDK начиная с версии 24, т.к. несмотря на утверждение разработчиков о поддержке начиная с 21 версии, в процессе сборки, довольно часто, возникают ошибки.

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

В этом же разделе (Сборка Android SDK) в блоке Android нажмите кнопку Создать Шаблоны. Это позволит вам создать произвольно настраиваемый файл AndroidManifest.xml (и другие относящиеся к сборке), т.к. AndroidManifest.xml генерируемы Qt по умолчанию каждый раз пересоздаётся и если его отредактировать это не окажет влияния на проект. В открывшемся окне просто нажмите завершить.
Если вы запускали сборку проекта до того как выполнили вышеуказанные действия, Qt будет спрашивать разрешения перезаписать уже существующие файлы. Просто соглашайтесь.

Отладка android приложений собраны в Qt Creator на реальных устройствах
Рис. 9 Создание шаблона

После этого перед вами откроется содержимое AndroidManifest.xml в виде формы с полями. Перейти к текстовому варианту можно при помощи кнопки Исходник XML вверху окна. Здесь, одним из важных пунктов, для нас является Минимальный требуемый SDK. Убедитесь, что уровень API установленный в этом поле не выше уровня API вашего эмулятора/устройства, в противном случае устройство может отказаться запускать/устанавливать приложение.

Отладка android приложений собраны в Qt Creator на реальных устройствах
Рис. 10 AndroidManifest.xml

Сборка и отладка

Внимание! Перед сборкой/запуском/отладкой каждого нового android-приложения рекомендуется включить VPN, т.к. Qt Creator и система автоматической сборки Gradle могут попробовать докачать недостающие компоненты и зависимости, в том числе, и с подсанкционных гугловских серверов. В случае неудачи сборка завершится с ошибкой. Скаченные зависимости остаются в системе и не требуют повторного скачивания.

Прежде чем начинать отладку убедитесь, что ваше устройство подключено к компьютеру с помощью USB-кабеля.

Перейдите в Qt Creator и нажмите кнопку запуска (зелёный треугольник). В результате откроется окно со списком всех доступных устройств и эмуляторов. Выберите нужный и нажмите OK.

Отладка android приложений собраны в Qt Creator на реальных устройствах
Рис. 11 Выбор устройства

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

Отладка android приложений собраны в Qt Creator на реальных устройствах
Рис. 12 Установка приложения

В дальнейшем можно будет запускать это приложение из общего списка установленных, даже без Qt Creator.

Отладка android приложений собраны в Qt Creator на реальных устройствах
Рис. 13 Запущенное приложение

Все сообщения посылаемые приложением будут видны в Qt Creator на вкладке Вывод приложения.

Отладка android приложений собраны в Qt Creator на реальных устройствах
Рис. 14 Вывод отладочной информации

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

Scroll Up