Wireless Debugging Widget

Widget de Depuração Sem Fio

Ative e desative a Depuração Sem Fio (ADB via Wi-Fi) diretamente da sua tela inicial com um único toque. Sem precisar navegar pelas Opções do desenvolvedor, sem acessar as Configurações rápidas — apenas a opção que você precisa, onde você precisa.

Criado para desenvolvedores Android que instalam ROMs personalizadas, executam testes de instrumentação ou se conectam a IDEs pela rede o dia todo. O Widget de Depuração Sem Fio elimina a necessidade de ativar e desativar o ADB via Wi-Fi repetidamente, transformando um processo de cinco toques em apenas um.

** Como funciona **

O widget lê e grava a configuração global `adb_wifi_enabled` do Android. Uma vez concedida a permissão necessária, tocar no botão ativa a Depuração Sem Fio instantaneamente — o mesmo efeito de ativá-la manualmente nas Opções do desenvolvedor, mas sem sair da tela inicial.

** Configuração **

O Widget de Depuração Sem Fio precisa de uma configuração única, pois a Depuração Sem Fio do Android é uma configuração de sistema protegida. O Google restringe o uso do widget a aplicativos que possuam a permissão WRITE_SECURE_SETTINGS, a qual não pode ser concedida por meio de uma caixa de diálogo de instalação padrão — ela precisa ser concedida uma única vez em um computador via ADB.

A tela "Sobre" dentro do aplicativo guia você por toda a configuração:

1) Ative as Opções do desenvolvedor no seu dispositivo.

2) Conecte seu dispositivo a um computador com o ADB instalado e execute:

adb devices

3) Copie o ID do seu dispositivo da saída e execute:

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

Substitua pelo ID obtido na etapa anterior.

4) Adicione o widget à sua tela inicial — com um toque, se o seu launcher for compatível, ou com o método padrão de toque longo.

Ambos os comandos também são exibidos dentro do aplicativo com botões de copiar de um toque. Após a configuração, o widget funciona offline, sem necessidade de contas, sincronização com a nuvem ou coleta de dados. Se o widget não responder aos toques, execute o comando de concessão novamente. O Android restringe a permissão WRITE_SECURE_SETTINGS a uma instalação específica, portanto, reinstalações, atualizações do sistema e restaurações de backup podem revogá-la silenciosamente. Executar o comando de concessão novamente restaura a funcionalidade do widget imediatamente.

Observe que os comandos de exemplo funcionam no Android padrão e na maioria dos dispositivos convencionais, mas alguns fabricantes (Xiaomi, Samsung e outros) adicionam restrições extras ao sistema de permissões do Android. Se o comando retornar um erro no seu dispositivo, talvez seja necessário ativar uma opção de desenvolvedor secundária ou seguir as etapas específicas do fabricante primeiro — uma pesquisa rápida pelo modelo do seu dispositivo juntamente com "grant WRITE_SECURE_SETTINGS" geralmente encontrará o procedimento exato.

**Recursos**

- Ativação/desativação da Depuração Sem Fio com um toque na tela inicial

- Gráfico de alternância com Material Design que reflete o estado atual rapidamente

- Suporte automático aos modos claro e escuro — o widget se adapta ao tema do seu sistema

- Acessível: integração adequada com o TalkBack e anúncios de estado

- Widget compacto de 2x1 que cabe em qualquer lugar da sua tela inicial

- Instruções de configuração e o comando ADB necessário integrados ao aplicativo

- Recurso alternativo às Opções do Desenvolvedor caso a permissão não tenha sido concedida

**Requisitos**

- Android 11 (API 30) ou superior — a Depuração Sem Fio foi introduzida no Android 11

- Configuração única do ADB para conceder a permissão de sistema necessária

- Opções do desenvolvedor ativadas no seu dispositivo

**Privacidade**

O Widget de Depuração Sem Fio não coleta, transmite ou armazena quaisquer dados pessoais. O aplicativo não possui contas de usuário, análises, publicidade ou SDKs de terceiros. A única atividade de rede consiste em uma verificação periódica (no máximo uma vez por semana) para preencher a seção "Mais da CELEST" dentro do aplicativo. Essa verificação busca uma lista de outros aplicativos da CELEST em celest-watches.com e armazena o resultado em cache localmente.

**Sobre a CELEST**

A CELEST cria aplicativos Android e mostradores de relógio Wear OS pequenos e focados, sem assinaturas, anúncios ou rastreamento. Cada produto faz uma coisa bem feita — encontre-nos em celest-watches.com ou procure por "CELEST" no Google Play.