Як запустити Cordova додаток в режимі відладки (debug) на реальному пристої

Я вам розкажу як запустити ваш Cordova додаток на реальному пристрої в режимі відладки (debug), щоб можна було відкрити іспектор з компьютера, та дебажити додаток. Відразу скажу, що я використовую мак, але для вінди механізм буде практично таким же самим.

1. Увімкнути дебаг на телефоні

Перше що вам треба зробити, це вімкнути відладку по USB на телефоні. В кожній прошивці телефону це робиться плюс мінус однаково. Перейдіть в Налаштування -> Система -> Про пристрій чи Про телефон чи Про систему. Далі у вас буде пункт про пристрій, або збірка, або про систему. В ній буде весія збірки. Вам потрібно на неї клікнути 5-6 разів, тоді на телефоні вімкнеться режим розробника:

 

Після цього перейдіть в пункт налаштування розробника, який в увас зʼявиться в меню. Якщо знайти його буде складно, можете скористатитися пошуком.

В параметрах розробника вам потрібно вімкнути пункт - "Налагодження через USB", або відладка через USB, в різних перекладах він може називатися по різному.

Чудово, тепер практично все готово.

2. Налаштуйте Cordova

Вам потрібно додати в ваш config.xml параметр, який вімкне дебаг режим через хром.

<preference name="AndroidWebViewDebuggingEnabled" value="true"/>

Але враховуйте, що в релізній версії, вам цей параметр ліпше прибрати. Хоч кордова і не вмикає цей режим в релізній версії додатку, але він може впливати на інші плагіни, що може створити діру для зловмисників.

3. Збірка

Стандартна збірка збирає проект в режимі --release, як я казав раніше, дебаг не буде доступним в цьому режимі. Вам потрібно зібрати додаток в режимі --debug, що створить apk файл, який ви можете встановити на свій смартфон. Якщо у вас вже встановлений ваш додаток через плеймаркет, то вам буде потрібно його видалити, або змінити назву дебаг версії.

Для того щоб збілдити додаток в режимі дебагу, вам потрібно встановити флаг --debug, при збірці:

cordova build android --debug --buildConfig --scan

Це створить APK файл в режимі дебаг.

4. Дебажим

Після того, як ви встановили ваш дебаг додаток, підключить телефон через type-c до ваого компьютера, в моєму випадку це мак. Далі у вас на телефоні запитає про права доступу, дозвольте їх. Далі відкрийте в хромі посилання:

chrome://inspect/#devices

Якщо ви підключили телефон Data-кабелем, та дозволи дебаг, то у вас в списку зʼявиться ваш пристрій:

В моєму випадку це A142. Після відкрийте ваш Codova додаток, який ви зібрали в режимі дебагу, та не сплутайте його з релізною версією. І якщо все зробили правильно, то у вас зʼявиться ваш додаток в списку. 

Тепер ви можете натиснути на кнопку inspect, та дебажити ваш додаток в режимі реального часу, на реальному пристрої, бачучи консоль хрома, та всі події.

На цьому все. 🎉🎉🎉