Как разрабатывать web на мобильном

Как разрабатывать web на мобильном

КодингКодинг

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

И начинается разная чехарда. Сначала подгонка стилей. Потом PWA, но это вроде просто. Но самая жесть начинается когда на сайте есть авторизация. И вот на компе сайт работает идеально. А на мобильном... очень странные ни с чем не связаные баги.

Логи тоже есть, но из них ничего не понятно, а писать логами весь вебсайт... такое себе. Короче. Эта история про то, как я подключаю свой реальный телефон к компу через Wi-Fi и всё дебажу. Поехали!

Вводные данные

Итак. У меня Fedora linux - если у вас что-то другое, думаю разберётесь как установить android-tools. Кроме того, телефон с android. Рабочий wifi.

И локально запущеный вебсайт. Я свои вебсайты все запускаю все на кастомном домене с https. То есть, мои сайты я разрабатываю не на localhost:3000, а на доменах типа https://localhost.my-website.com. По многим причинам и главная из них - мне так нравится. Поэтому или настройте у себя, или, если у вас не такая история, возможно мой гайд не для вас.

Соединяемся

Как я сказал ранее, нам нужен установленный android-tools. На Fedora он устанавливается крайне просто.

sudo dnf install android-tools

На всякий случай лучше сразу вывести версию, мало ли какие команды есть.

adb version

Окей. Соединяемся.

На телефоне переходим в режим разработчика. Это зависит от версии вашего телефона, но принцип общий веде. В настройках находите внизу О телефоне и там где-то будет Номер сборки (Build number). Вот по нему нужно нажать 7 раз. Всё, вы в режиме разработки.

Теперь мы подключаемся через wifi. Нажимаем на лупу в настройках - в современных версиях android она веде есть и ищем Беспроводная отладка (Wireless debugging). Включаем её.

Заходим внутрь (Wireless debugging) и видим вверху IP/port - это телефон и Pair device with pairing code. Подключение по Wifi состоит из двух частей сопряжение (pair) и подключение (connect).

Сопряжение

Заходим в Pair device with pairing code нам дают ip адрес и пароль. Соединяемся.

adb pair 192.168.1.12:37313

После этого вы должны увидеть ваше устройство (ноутбук) в списке сопряжённых в wireless debug вашего телефона.

Подключение

В Wireless debugging вверху написан айпишник телефона. Поскольку мы уже спарены, нам теперь досаточно сделать коннект по ip - пароля тут не нужно.

adb connect 192.168.1.12:42567

Поздравляю, вы подключены! Ещё можно убедиться что ноут видит ваш телефон:

adb devices -l

Дебажим

Всё было бы слишком хорошо, если бы можно было так налегке зайти и всё бы работало. У нас кастомный домен https://localhost.my-website.com и телефон звонит его в интернет. Нам это вообще не подходит ни разу.

На помощь приходит утилита personalDNSfilter. Если честно, аналогов ей я пока не нашёл. Смысл какой. Android нам не даёт изменять файл hosts, а утилита это умеет. Поэтому качаем-устанавливаем её на телефон.

Дальше (это важно!) утилита должна сработать и включиться как VPN. И тут есть два совсем неочевидных нюанса. Чтобы всё работало у вас дожно быть настроено в Network телефона две вещи:

  1. Настройка Private DNS должна быть жёстко off. Почему. Потому что мы и установили эту утилиту чтобы свои DNS подставить, а не чьи-то-там.
  2. personalDNSfilter работает как vpn. Соответственно, eсли утилита у вас открыта на телефоне, у вас дожно быть в VPN написано personalDNSfilter. Самая частая проблема с этим - у человека уже стоит другой VPN на телефоне и глушит утилиту. Поэтому удаляйте VPN если он у вас есть и перезапускайте personalDNSfilter пока не увидите его в графе VPN.

Итого Private DNS = Off, VPN = personalDNSfilter

Прописываем домен.

Запускаем наш локальный вебсайт. Без этого счастья не будет. Далее, заходим на него на нашем ноуте (например на https://localhost.my-website.com и убеждаемся что вебсайт работает.

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

Идём в Advanced settings и ищем что-то связанное с hosts. В текущей версии у меня это называется Configure additional hosts.

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

# In order to forward to custom ip, add a ">" in front of the host, 
# followed by whitespace and mapped ip. 
# Wildcard Character "*" can be used. 
 
>router 192.168.2.1

И так, домен у нас уже есть, где взять айпишник нашего компа? Я делаю hostname -I, у вас может быть какая-то другая команда.

hostname -I

Получите что-то типа 192.168.1.32 172.17.0.1 172.18.0.1

После этого составляю строку в месседжере который у меня на телефоне и отправляю сам себе (это не какой-то приём, всего-лишь мне так проще копировать всё). У меня получилось:

>localhost.my-website.com 192.168.1.32

Дальше вставляем строку в additional hosts. У вас должно получиться что-то типа:

>router 192.168.2.1
>localhost.my-website.com 192.168.1.32

Возвращаемся на главный экран personalDNSfilter и жмём там restart.

Теперь звоним домен с ноута:

adb shell ping -c 1 localhost.rainbow.su

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

Окей. Пробуем открыть на телефоне. Должно открыться.

SSL сертификаты

Мне они нужны для разных вещей. И без них у меня обычно приложение полноценно работать не может. Для локальной разработки я использую невероятно удобную утилиту mkcert.

И если вы такие же, как я, вам нужно её прописать и на вашем android. А именно, её корневой CA.

Ищем где он лежит на компе

https://github.com/filosottile/mkcert

Будет что-то типа /home/mikita.m/.local/share/mkcert и там и лежит нужный нам rootCA.pem. Передаём его на наш android.

adb push "$(mkcert -CAROOT)/rootCA.pem" /sdcard/Download/rootCA.crt

Убеждаемся, что файл загружен на телефон

adb shell ls -l /sdcard/Download/rootCA.crt

После этого заходим в настройки на телефоне и ищем CA certificate. Вам выскочит сообщение типа "это опасно чужие сертификаты устанавливать" - окей, мы не против, это как раз наш сертификат, а не чужой. Переключаемся на Downloads в дереве файлов и листаем вниз пока не найдём наш rootCA.crt. Кликаем и видим сообщение что он установлен.

Снова переключаемся на поиск, ищем Trusted credentials, заходим и переключаемся на User. Ваш сертификат должен быть там. После этого, если сертификат вдруг не прописался, просто закрывайте сайт, хром, полностью гасите и снова открывайте - сайт должен быть https.

Открываем dev tools

Идём в Google Chrome (я пользуюсь им, у вас может какая-то другая история) и открываем chrome://inspect/#devices. Вы должны увидеть ваш девайс. Если не видите, убедитесь, что галочки стоят на всех верхних пунктах Discover USB devices и Discover network targets.

После того, как вы видите вкладки открытые на телефоне, выбираете нужную вам из списка и делаете на ней inspect. Всё, дэв тулы подключены ко вкладке вашего телефона.