O que é debug por usb ativado

O app Configurações do Android inclui uma tela chamada Opções do desenvolvedor, que permite que você configure comportamentos do sistema para criar perfis e depurar o desempenho do seu app. Por exemplo, é possível ativar a depuração por USB, capturar o relatório de um bug, ativar o feedback visual para toques, atualizar superfícies de janela, usar a GPU para renderizar gráficos 2D e muito mais.

Ativar as opções do desenvolvedor e a depuração USB

Figura 1. Opções do desenvolvedor.

No Android 4.1 e em versões anteriores, a tela Opções do desenvolvedor está disponível por padrão. No Android 4.2 e versões mais recentes, é necessário ativar essa tela. Para ativar as opções do desenvolvedor, toque em Número da versão sete vezes. Você pode encontrar essa opção em um dos seguintes locais, dependendo da versão do Android:

• Android 9 (API de nível 28) ou mais recente: Configurações > Sobre o dispositivo > Número da versão
• Android 8.0.0 (API de nível 26) e Android 8.1.0 (API de nível 26): Configurações > Sistema > Sobre o dispositivo > Número da versão
• Android 7.1 (API de nível 25) e anteriores: Configurações > Sobre o dispositivo > Número da versão

Na parte de cima da tela Opções do desenvolvedor, é possível ativar e desativar as opções (figura 1), mas é recomendável deixá-las ativadas. Quando elas estão desativadas, a maioria das opções fica inacessível, exceto as que não exigem comunicação entre o dispositivo e seu computador de desenvolvimento.

Antes de usar o depurador e outras ferramentas, é necessário ativar a depuração USB, que permite que o Android Studio e outras ferramentas do SDK reconheçam seu dispositivo quando conectado via USB. Para ativar a depuração USB, alterne a opção Depuração USB no menu "Opções do desenvolvedor". Você pode encontrar essa opção em um dos seguintes locais, dependendo da sua versão do Android:

• Android 9 (API de nível 28) ou mais recente: Configurações > Sistema > Avançado > Opções do desenvolvedor > Depuração USB
• Android 8.0.0 (API de nível 26) e Android 8.1.0 (API de nível 26): Configurações > Sistema > Opções de desenvolvedor > Depuração USB
• Android 7.1 (API de nível 25) e anteriores: Configurações > Opções do desenvolvedor > Depuração USB

O restante desta página descreve algumas das outras opções disponíveis nessa tela.

Opções gerais

No Android 8.0 e em versões mais recentes, você pode tocar em Blocos de desenvolvedor para configurações rápidas para adicionar opções do desenvolvedor selecionadas ao painel "Configurações rápidas". Depois de selecionar um ou mais dos blocos disponíveis (figura 2), abra o painel "Configurações rápidas" e toque no lápis para entrar no modo de edição. Em seguida, arraste os blocos do desenvolvedor para o painel "Configurações rápidas" e toque novamente no lápis para sair do modo de edição.

Figura 2. Adicionar ao painel "Configurações rápidas".

Outras opções gerais incluem:

• Memória (no Android 8.0 e em versões mais recentes): exibe as estatísticas da memória, como o uso médio, o desempenho, o total disponível, a média usada, a quantidade livre disponível e a quantidade sendo usada pelos apps.
• Criar relatório do bug: receba uma cópia dos arquivos de registros atuais do dispositivo para compartilhar com alguém. Quando receber uma notificação de que o relatório do bug está pronto, toque nela para compartilhar o relatório.
• Modo de demonstração da IU do sistema: facilita capturas de tela nítidas ao exibir uma barra de notificações genérica predefinida que não mostra notificações ou avisos de pouca bateria. A opção Ativar modo de demonstração permite que você mude a aparência da barra de status com comandos do modo de demonstração adb. Você também pode usar a opção Mostrar modo de demonstração para ocultar notificações e exibir uma barra de status predefinida. Observação: os comandos do modo de demonstração adb podem não funcionar em todos os dispositivos porque eles não são verificados durante os testes de certificação do Android. É verificado apenas se eles funcionam em dispositivos Nexus e Pixel.
• Senha de backup local: define uma senha de backup para que você possa usar comandos adb para fazer backup e restaurar apps e dados do dispositivo com proteção por senha.
• Permanecer ativo: configura a tela para permanecer ativada sempre que você conectar o dispositivo à tomada.
• Ativar registro de rastreamento da Interface de controlador do host Bluetooth (HCI): captura todos os pacotes Bluetooth HCI em um arquivo armazenado em /sdcard/btsnoop_hci.log. É possível recuperar os pacotes e usar um programa como o Wireshark para analisar e solucionar problemas nas informações.

Depuração

Figura 3. Opções de depuração ativadas.

As opções de depuração oferecem maneiras de configurar a depuração no dispositivo e estabelecer a comunicação entre o dispositivo e o computador de desenvolvimento.

Ative a depuração USB (figura 3) para que o dispositivo Android possa se comunicar com a máquina de desenvolvimento usando o Android Debug Bridge (adb). A opção Aguardar depurador fica indisponível até que você use Selecionar app de depuração para selecionar o app a ser depurado. Se você ativar Aguardar depurador, o app selecionado esperará que o depurador seja conectado antes de ser executado.

Outras opções de depuração incluem:

• Armazenar dados de logger constantemente no dispositivo: selecione o tipo de mensagem de registro que você quer armazenar persistentemente no dispositivo. Opções disponíveis: "Desativados", "Todos", "Todos, exceto o rádio" ou "Somente kernel".
• Selecionar app de local fictício: use essa opção para criar uma localização de GPS falsa do seu dispositivo e testar se o app se comporta da mesma forma em outros locais. Para usar essa opção, faça o download e instale um app de locais fictícios de GPS.


Figura 4. Atributos de visualização

• Ativar visualização de inspeção de atributo: salva as informações de atributo de visualização na variável de membro mAttributes de uma instância View para que elas possam ser usadas para depuração. É possível acessar as informações de atributo pela interface de usuário do Layout Inspector, conforme mostrado na figura 4. Se essa opção estiver desativada, o item "Atributos" não estará disponível.
• Ativar camadas de depuração de GPU: disponível em dispositivos com Android 9 (API de nível 28) e versões mais recentes. Ative essa opção para permitir o carregamento de camadas de validação Vulkan do armazenamento local do dispositivo. Para saber mais, consulte Camadas de validação da Vulkan no Android.

Redes

Figura 5. Selecionar configuração USB.

As opções de rede oferecem formas de definir as configurações de Wi-Fi e DHCP.

Toque em Selecionar configuração USB para especificar como você quer que o computador identifique o dispositivo. Conforme mostrado na figura 5, é possível configurar dispositivos para apenas carregar, transferir arquivos (MTP), transferir imagens (PTP), usar a Internet para dispositivos móveis no PC (RNDIS) ou transferir arquivos de áudio ou MIDI.

Toque em Versão do Bluetooth AVRCP e selecione a versão de perfil que você quer usar para controlar todo o equipamento de Bluetooth A/V a que seu dispositivo tem acesso. Além disso, para ajustar a reprodução de áudio no dispositivo, defina as seguintes opções:

• Codec de áudio Bluetooth: ajuste a qualidade do som (codec) dos seus dispositivos selecionando um dos seguintes codecs:
  • SBC: transfere dados para dispositivos de saída de áudio Bluetooth, como fones de ouvido e alto-falantes.
  • AAC: oferece qualidade de som de dispositivos com fio melhor do que MP3 com taxas de bits semelhantes.
  • aptX: oferece um som sem fio nítido em smartphones, alto-falantes, soundbars, fones de ouvido e tablets de alta qualidade.
  • aptX HD: oferece streaming de alta resolução em dispositivos Bluetooth.
  • LDAC: oferece música de alta qualidade em conexões sem fio.
  • Ativar codecs opcionais e Desativar codecs opcionais: se tiver outras implementações de codec instaladas, use essas opções para ativá-las e desativá-las.
• Intervalo de amostras de áudio Bluetooth: ajuste o número de amostras de áudio por segundo ao selecionar uma taxa de amostragem para o codec de áudio. Taxas de amostragem mais altas usam mais recursos.
• Bits por amostra do áudio Bluetooth: defina o número de bits de informação em cada amostra de áudio. Quanto maior for a taxa de bits, melhor será o som, mas o arquivo da amostra também será maior.
• Modo de canal de áudio Bluetooth: selecione mono ou estéreo.
• Codec de áudio Bluetooth LDAC: otimize o som para melhorar a qualidade do áudio, equilibrar a qualidade do áudio e da conexão, aumentar a qualidade da conexão ou usar uma taxa de bits adaptável para equilibrar a qualidade do áudio e da conexão.

A lista a seguir descreve outras maneiras de definir as configurações de Wi-Fi e DHCP:

• Certificação de Display sem fio: ativa configurações e controles de configuração avançados para a certificação de Display sem fio de acordo com as especificações definidas na Especificação de Display Wi-Fi da Wi-Fi Alliance. Essa certificação se aplica ao Android 4.4 (API de nível 19) e versões mais recentes.
• Ativar registro detalhado de Wi-Fi: aumenta o nível de registro de Wi-Fi para cada rede sem fio (SSID) conectada de acordo com a força relativa de sinal recebido (RSSI). Para saber mais sobre os registros, consulte Gravar e visualizar registros com o Logcat.
• Transferência agressiva de Wi-Fi para celular: quando o sinal está baixo, essa opção torna o Wi-Fi mais eficiente ao transferir a conexão de dados para uma rede celular.

Entrada

Figura 6. Localização do cursor

Ative Mostrar toques para exibir toques quando você tocar na tela. Um círculo é exibido embaixo do seu dedo ou da sua stylus, acompanhando o movimento feito na tela. Um toque funciona como um cursor quando você grava um vídeo no dispositivo.

Ative Localização do cursor para mostrar a localização do cursor (toque) no dispositivo com um símbolo de mira. Uma barra é exibida no topo da tela para rastrear as coordenadas da mira (figura 6). Quando você move o cursor, as coordenadas na barra rastreiam a localização da mira, e o caminho do cursor é desenhado na tela.

Desenho

Figura 7. Construções da interface do usuário.

As opções de desenho oferecem indicações visuais sobre a interface do usuário do app e como ela é operada.

Ative Mostrar limites de layout para mostrar os limites de corte, as margens e outras construções da interface do usuário do seu app no dispositivo, conforme mostrado na figura 7.

Outras opções de desenho incluem:

• Forçar layout da direita p/ esquerda: força a direção do layout da tela da direita para a esquerda (RTL, na sigla em inglês) ou da esquerda para a direita (padrão).
• Escala de animação da janela: define a velocidade de reprodução da animação da janela para que você possa verificar o desempenho em diferentes velocidades. Uma escala menor resulta em uma velocidade maior.
• Escala de animação de transição: define a velocidade para a reprodução da animação de transição para que você possa verificar o desempenho em diferentes velocidades. Uma escala menor resulta em uma velocidade maior.
• Simular telas secundárias: cria uma tela secundária como sobreposição no dispositivo. Isso é útil ao oferecer compatibilidade com mais telas com a API Presentation. Consulte Telas secundárias.

Renderização acelerada por hardware

Figura 8. Espaço de cor para deuteranomalia.

As opções de renderização acelerada por hardware oferecem maneiras de otimizar seu app para as plataformas de hardware de destino utilizando opções baseadas em hardware, como GPU, camadas de hardware e anti-aliasing multiamostra (MSAA, na sigla em inglês).

Toque em Simular espaço de cores para mudar o esquema de cores da IU de todo o dispositivo. As opções fazem referência aos tipos de daltonismo. As opções são: "Desativado" (nenhum esquema de cores simulado), "Monocromacia" (preto, branco e cinza), "Deuteranomalia" (vermelho e verde), "Protanomalia" (vermelho e verde) e "Tritanomalia" (azul e amarelo). Protanomalia se refere ao daltonismo de vermelho e verde cuja deficiência é focada na cor vermelha, enquanto deuteranomalia (mostrada na figura 8) se refere ao daltonismo de vermelho e verde cuja deficiência é focada na cor verde.

Se você fizer uma captura de tela em um espaço de cor simulado, ela terá uma aparência normal, como se você não tivesse mudado o esquema de cores.

Outras maneiras de utilizar as opções baseadas em hardware são:

• Definir renderizador de GPU: muda o mecanismo de gráficos Open GL padrão para abrir o mecanismo de gráficos Open GL Skia.
• Forçar renderização GPU: força os apps a usar a GPU para desenhos 2D, se eles tiverem sido programados sem a renderização de GPU por padrão.
• Mostrar atualiz. da GPU: exibe qualquer elemento na tela desenhado com a GPU.
• Depurar overdraw da GPU: exibe codificação por cores no seu dispositivo para que você possa visualizar quantas vezes o mesmo pixel foi desenhado no mesmo frame. A visualização mostra onde seu app pode estar renderizando mais do que o necessário. Para saber mais, consulte Visualizar overdraw da GPU.
• Depurar operações de corte não retangulares: desativa a área de corte na tela para criar áreas de tela incomuns (não retangulares). Normalmente, a área de corte impede que desenhos sejam feitos fora dos limites da área de corte circular.
• Forçar MSAA 4x: habilita o anti-aliasing multiamostra (MSAA, na sigla em inglês) em apps Open GL ES 2.0.
• Desativar sobreposição HW: usar a sobreposição de hardware permite que cada app que exibe algo na tela use menos capacidade de processamento. Sem a sobreposição, um app compartilha a memória de vídeo e precisa verificar constantemente a presença de colisões e cortes para renderizar uma imagem correta. A verificação usa muita capacidade de processamento.

Configure a opção Desativar roteamento de áudio USB para desativar o roteamento automático para dispositivos de áudio externos conectados a um computador por uma porta USB. O roteamento automático pode interferir em apps que reconhecem USB.

No Android 11 e em versões mais recentes, quando um aplicativo sem a permissão RECORD_AUDIO usa UsbManager para solicitar acesso direto a um dispositivo de áudio USB com recurso de captura de áudio, como um fone de ouvido USB, um aviso é exibido pedindo que o usuário confirme a permissão de uso do dispositivo. O sistema ignora qualquer opção "sempre usar", de modo que o usuário precisa reconhecer o aviso e conceder permissão toda vez que um app solicitar acesso. Para evitar esse comportamento, o app precisa solicitar a permissão RECORD_AUDIO.

Monitoramento

Figura 9. Representação em barras.

As opções de monitoramento oferecem informações visuais sobre o desempenho do app, como linhas de execução longas e operações de GPU.

Toque em Classificar renderização de GPU e em Na tela em barras para exibir o perfil de renderização de GPU como barras (figura 9). Para saber mais, consulte Criação do perfil de renderização de GPU.

Figura 10. Definir limites de processamento em segundo plano.

As opções de aplicativo ajudam você a entender como seu app funciona no dispositivo de destino.

Toque em Limite do processamento em segundo plano para definir o número de processos que podem ser executados em segundo plano de uma só vez. As possíveis configurações são mostradas na figura 10.

Toque em Redefinir limite de taxa do ShortcutManager durante os testes para que os apps em segundo plano possam continuar a chamar APIs de atalho até que o limite de taxa seja atingido novamente. Para saber mais sobre os atalhos e limites de taxa, consulte ShortcutManager.

Ative Não manter atividades para aumentar a duração da bateria, eliminando atividades assim que o usuário sair da visualização principal delas.