← На главную

Разработка мобильных приложений на платформе «1С:Предприятие 8.3» — увлекательный процесс, однако этап отладки часто вызывает у разработчиков трудности. Традиционная отладка через USB-кабель не всегда удобна: кабель может отходить, порт мобильного устройства изнашивается, да и свобода перемещения тестировщика или разработчика сильно ограничивается. Намного удобнее настроить беспроводную отладку через локальную сеть Wi-Fi по протоколу HTTP.

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

Шаг 1. Подготовка конфигурации и окружения на рабочем компьютере

Для начала нам необходимо подготовить среду разработки в локальной системе. Прежде всего убедимся, что компьютер и мобильное устройство подключены к одной и той же локальной беспроводной сети (Wi-Fi). Это критически важное условие, без которого прямая маршрутизация пакетов будет невозможна.

Далее откроем Конфигуратор нашей информационной базы и перейдем к настройкам запуска мобильного приложения:

1. В главном меню выберем пункт Сервис – Параметры.
2. В открывшемся окне перейдем на вкладку Запуск 1С:Предприятия, а затем выберем подраздел Мобильное приложение.
3. В этом разделе рекомендуется отключить автоматический поиск устройств, если вы планируете подключаться вручную. Укажем путь к каталогу Android SDK (если он установлен, хотя для Wi-Fi отладки сам SDK не является строго обязательным).
4. Для параметра При отсутствии доступных устройств выставим значение Ожидать подключения. Это позволит Конфигуратору не выдавать ошибку сразу, а терпеливо ожидать инициализации сеанса с мобильного устройства.

Шаг 2. Настройка HTTP-сервера отладки в Конфигураторе

Платформа 1С поддерживает два протокола отладки: TCP/IP и HTTP. Для мобильной разработки используется исключительно протокол HTTP. Нам необходимо настроить локальный сервер отладки dbgs.exe, который запускается вместе с Конфигуратором.

1. В окне Параметры перейдем на вкладку Отладка.
2. В поле Протокол отладки выберем значение по HTTP.
3. В поле Адрес локальной сетевой карты (или адрес сервера отладки) необходимо прописать IP-адрес вашего компьютера в локальной сети Wi-Fi. Важно: пишем только чистый IP-адрес без префиксов протокола (например, 192.168.0.11). Выяснить свой IP-адрес можно через командную строку Windows, выполнив команду ipconfig.
4. В поле Порт укажем свободный порт. Рекомендуется использовать порты из диапазона динамических, например, 45455 или 1560. Главное, чтобы этот порт не был занят другими службами или веб-серверами на вашем ПК.
5. Нажмем кнопку Применить, после чего платформа предложит перезапустить Конфигуратор для применения изменений. Соглашаемся и перезапускаем среду разработки.

После перезапуска в фоновом режиме запустится процесс отладочного сервера. Проверить его работоспособность можно в Диспетчере задач Windows (процесс dbgs.exe) или выполнив в командной строке команду проверки прослушивания портов:

netstat -ano | findstr 45455

Шаг 3. Настройка мобильного устройства и приложения

Теперь перейдем к мобильному устройству. Откроем установленную мобильную платформу разработчика 1С. Нам необходимо правильно указать параметры подключения к конфигурации:

1. При добавлении или редактировании мобильной информационной базы найдем поле, отвечающее за адрес обновления или публикации.
2. В поле адреса конфигурации пропишем путь к опубликованной базе или локальному веб-серверу (например, http://192.168.0.11/mobile_base).
3. Внимание: распространенная ошибка новичков заключается в попытке вручную заполнить поле «Адрес сервера отладки» непосредственно в настройках самого мобильного приложения на телефоне. Этого делать не нужно! Если в Конфигураторе настроен перезапуск, мобильная платформа автоматически получит адрес отладчика при обновлении базы из конфигуратора.
4. Убедимся, что на мобильном устройстве включена опция Перезапускать при обновлении из конфигуратора.

Шаг 4. Запуск и инициализация сеанса отладки

Выполним финальные действия по связыванию конфигуратора и мобильного клиента:

1. Запустим мобильное приложение 1С на смартфоне или планшете.
2. На стационарном компьютере в Конфигураторе откроем меню Отладка – Подключение....
3. В появившемся окне нажмем кнопку Настройка... и убедимся, что включена опция автоматического подключения предметов отладки. Рекомендуется установить флажки для всех типов приложений (включая тонкий клиент, мобильный клиент и фоновые задания).
4. В меню Конфигуратора запустим процесс обновления/отладки мобильного приложения.
5. На мобильном устройстве база автоматически перезапустится, подтянув актуальную конфигурацию.
6. Вернемся в Конфигуратор, откроем окно Отладка – Подключение... и в списке доступных сеансов мы должны увидеть наш мобильный сеанс. Если автоподключение сработало — он автоматически переместится в список подключенных предметов отладки.

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

Устранение типичных неполадок и подводных камней

На практике процесс настройки беспроводной отладки часто натыкается на сетевые ограничения или особенности операционной системы. Рассмотрим самые частые проблемы и способы их решения.

Брандмауэр Windows и сторонние антивирусы

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

Решение: необходимо открыть порт (например, 45455) в брандмауэре Windows. Для этого создадим новое правило для входящих подключений по протоколу TCP для указанного порта. Также проверьте настройки сетевых экранов установленных антивирусов (Kaspersky, ESET Nod32 и др.) и добавьте исполняемый файл dbgs.exe в список исключений с неограниченным сетевым доступом.

Изоляция беспроводных клиентов (AP Isolation) на роутере

Многие современные Wi-Fi роутеры в целях безопасности по умолчанию активируют функцию изоляции клиентов. Эта технология запрещает беспроводным устройствам «общаться» друг с другом напрямую внутри одной сети, позволяя им только выходить в интернет.

Решение: зайдите в панель управления вашего Wi-Fi роутера, найдите в настройках беспроводного режима параметр AP Isolation (или "Изоляция точки доступа", "Client Isolation") и отключите его.

Зависание процесса dbgs.exe в памяти

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

Решение: откройте Диспетчер задач Windows, перейдите на вкладку «Процессы» или «Подробности», найдите все экземпляры процесса dbgs.exe и принудительно завершите их, после чего перезапустите Конфигуратор.

Что делать, если Конфигуратор падает при запуске после включения HTTP-отладки?

Это крайне неприятная проблема, с которой сталкиваются разработчики на некоторых релизах платформы (например, 8.3.8 или 8.3.17). При активации HTTP-отладки Конфигуратор падает с критической ошибкой Windows сразу при попытке старта, не давая даже зайти в меню, чтобы вернуть настройки обратно.

Часто причиной этого является использование кириллических символов в системных путях Windows (например, имя пользователя операционной системы написано русскими буквами — C:\Users\Иван или C:\Users\ПКК). Платформа некорректно обрабатывает пути к временным файлам отладки, содержащим кириллицу.

Решение: настройки режима отладки конкретной информационной базы сохраняются в файле конфигурации пользователя 1Cv8.pfl. Нам нужно сбросить кэш и настройки этой базы. Для этого выполните следующие действия:

1. Перейдите в каталог кэша приложений 1С на вашем компьютере. Обычно он расположен по пути:

   %APPDATA%\1C\1cv8\ (что эквивалентно C:\Users\<Имя_Пользователя>\AppData\Roaming\1C\1cv8\).

2. Найдите папку с уникальным идентификатором вашей информационной базы (ее GUID можно сопоставить по списку баз или просто очистить кэш целиком, если баз немного).
3. Удалите файлы настроек или сам файл 1Cv8.pfl внутри папки настроек пользователя этой базы.
4. Также рекомендуется переименовать или создать нового пользователя Windows на английском языке без использования кириллических символов во избежание других подобных ошибок при работе со встроенными веб-сервисами 1С.

После удаления файла настроек Конфигуратор успешно запустится со стандартным протоколом TCP/IP, и вы сможете скорректировать сетевые пути перед повторной попыткой настройки беспроводной отладки.