Wireless Debugging Widget на Андроид

Виджет беспроводной отладки

Переключайте беспроводную отладку (ADB через Wi-Fi) прямо с главного экрана одним касанием. Не нужно просматривать параметры разработчика, не нужно открывать быстрые настройки — просто нужный переключатель там, где он вам нужен.

Создан для разработчиков Android, которые в течение дня прошивают сборки, запускают инструментальные тесты или подключаются к IDE по сети. Виджет беспроводной отладки избавляет от необходимости постоянно включать и выключать ADB через Wi-Fi, превращая пятикратное нажатие в одно.

**Как это работает**

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

**Настройка**

Виджету беспроводной отладки требуется однократная настройка, поскольку флаг беспроводной отладки Android является защищенной системной настройкой. Google ограничивает использование приложениями, имеющими разрешение WRITE_SECURE_SETTINGS, которое нельзя предоставить через стандартный диалог установки — его необходимо предоставить один раз с компьютера через ADB.

На экране «О приложении» вы найдете пошаговую инструкцию по настройке:

1) Включите параметры разработчика на вашем устройстве.

2) Подключите устройство к компьютеру с установленным ADB и выполните команду:

adb devices

3) Скопируйте идентификатор вашего устройства из вывода, затем выполните команду:

adb -s shell pm grant com.celestwatches.wirelessdebuggingwidget android.permission.WRITE_SECURE_SETTINGS

Замените на идентификатор из предыдущего шага.

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

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

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

Обратите внимание, что примеры команд работают на стандартном Android и большинстве распространенных устройств, но некоторые производители (Xiaomi, Samsung и другие) добавляют дополнительные ограничения поверх системы разрешений Android. Если команда возвращает ошибку на вашем устройстве, вам может потребоваться включить дополнительный переключатель разработчика или сначала выполнить действия, специфичные для производителя — быстрый поиск модели вашего устройства вместе с «grant WRITE_SECURE_SETTINGS» обычно позволяет найти точную процедуру.

**Особенности**

- Переключение беспроводной отладки одним касанием с главного экрана
- Графическое отображение текущего состояния в стиле Material Design
- Автоматическая поддержка светлого и темного режимов — виджет адаптируется к системной теме
- Доступность: корректная интеграция TalkBack с объявлениями о состоянии
- Компактный размер виджета 2×1, который помещается в любом месте главного экрана
- Инструкции по настройке и необходимая команда ADB встроены в приложение
- Корректный возврат к параметрам разработчика, если разрешение не было предоставлено

**Требования**

- Android 11 (API 30) или выше — беспроводная отладка была представлена ​​в Android 11
- Однократная настройка ADB для предоставления необходимого системного разрешения
- Параметры разработчика включены на вашем устройстве

**Конфиденциальность**

Виджет беспроводной отладки не собирает, не передает и не хранит никаких личных данных. В приложении нет учетных записей пользователей, аналитики, рекламы и сторонних SDK. Единственная сетевая активность — это периодическая проверка (не чаще одного раза в неделю) для заполнения раздела «Больше от CELEST» внутри приложения. Эта проверка получает список других приложений CELEST с сайта celest-watches.com и кэширует результат локально.

**О CELEST**

CELEST создает небольшие, специализированные приложения для Android и циферблаты для часов Wear OS, без подписок, рекламы и отслеживания. Каждый продукт отлично справляется со своей задачей — найдите нас на сайте celest-watches.com или выполните поиск «CELEST» в Google Play.

Updated feed caching logic.