Este guia tem como objetivo auxiliar na identificação do nome do pacote (Package Name) de um aplicativo ou tela do sistema operacional Android utilizando a ferramenta ADB (Android Debug Bridge). Essa informação é fundamental para liberar aplicativos no Perfil de Configuração de Launcher (Android), e identificar restrições C4M.

Importante: Para identificar o aplicativo corretamente, o ideal é que o dispositivo de testes não possua configurações restritivas aplicadas. Deste modo no Perfil de Configuração de Políticas (Android Enterprise), em Segurança Opções de Desenvolvedor deve estar como Permitido e Política de Acesso a Dados por USB como Permitir Transferência de Dados. Ainda se o aparelho estiver utilizando um perfil de Configuração de Laucher, o sistema poderá barrar a inicialização do aplicativo antes que o comando consiga registrá-lo na tela.

Passo 1: Baixar o ADB no Computador

1. Realize o download das ferramentas oficiais Android SDK Platform-Tools para Windows diretamente no site oficial do Android.
2. Extraia o conteúdo do arquivo ZIP para uma pasta de fácil acesso no seu computador (por exemplo: C:\platform-tools).

Passo 2: Preparar o Celular Android

1. No dispositivo, acesse Configurações > Sobre o telefone.
2. Toque 7 vezes seguidas sobre o campo Número da versão (ou Build Number) até que a mensagem “Você agora é um desenvolvedor” seja exibida.
3. Volte ao menu anterior de Configurações, entre em Sistema (ou diretamente no menu principal) e acesse Opções do desenvolvedor.
4. Procure pela opção Depuração USB e ative-a.

Passo 3: Conectar e Autorizar o Dispositivo

1. Conecte o celular ao computador utilizando um cabo USB de boa qualidade.
2. Fique atento à tela do celular: uma mensagem solicitando autorização para depuração USB será exibida.
3. Marque a opção “Sempre permitir a partir deste computador” e toque em Permitir.

Passo 4: Abrir o Prompt de Comando (ADB)

1. Abra a pasta onde você extraiu os arquivos (ex: C:\platform-tools).
2. Clique na barra de endereços do Windows Explorer no topo da pasta, digite cmd e pressione Enter.
3. Uma janela preta do Prompt de Comando se abrirá diretamente no diretório correto.

Passo 5: Validar a Conexão

No Prompt de Comando, digite o seguinte comando e pressione Enter:

DOS

adb devices

• O retorno esperado deve mostrar uma sequência de números seguida da palavra device (ex: ZY22GXXXXX device).
• Se aparecer unauthorized, olhe para a tela do celular e conceda a permissão de depuração novamente.

Passo 6: Identificar o Aplicativo em Execução

Com o celular conectado e respondendo aos comandos, abra no aparelho o aplicativo ou a tela que você deseja identificar. Em seguida, execute um dos comandos abaixo no Prompt de Comando do computador:

Método A: Captura Instantânea (Foco Atual)

Recomendado para identificar o aplicativo que está aberto na tela neste exato momento.

DOS

adb shell “dumpsys activity activities | grep mResumedActivity”

(Caso o comando acima não retorne nada no Windows, utilize: adb shell “dumpsys activity | findstr top-activity”)

• Como ler o resultado: O terminal retornará uma linha contendo o pacote e a atividade ativa. O texto que fica antes da barra / é o nome do pacote que você precisa.
  • Exemplo de retorno: mResumedActivity: … u0 com.instagram.android/.activity.MainActivity
  • Pacote identificado: com.instagram.android

Método B: Monitoramento em Tempo Real (Modo “Watch”)

Ideal para quando você precisa clicar em um botão ou link e ver qual aplicativo é disparado imediatamente após o clique.

Execute o comando abaixo (ele manterá o terminal atualizando a cada 1 segundo):

DOS

powershell “while($true) { adb shell dumpsys window | Select-String mCurrentFocus; Start-Sleep -Seconds 1 }”

• Como usar: Deixe o terminal aberto, mexa no celular e abra o aplicativo desejado. A linha no Prompt de Comando mudará na hora mostrando o nome do novo pacote em foco. Para parar o monitoramento, pressione Ctrl + C no teclado.

Não conseguiu liberar ou o pacote identificado é um serviço do sistema?

Caso você consiga identificar o nome do pacote, mas a liberação não funcione (o que pode acontecer se for um serviço nativo do sistema rodando sob restrições profundas), ou se você tiver dificuldades para interpretar o retorno do terminal, encaminhe os dados para a nossa equipe de suporte analisar.

O que enviar no chamado de suporte:

• Nome do Pacote (Package Name): Envie o texto exato copiado do terminal (ex: com.google.android.captiveportallogin).
• Captura de Tela (Print): Envie um print da tela do Prompt de Comando (CMD) mostrando o comando executado e o retorno obtido no momento do teste.
• Dados do Dispositivo: Informe o fabricante, modelo do aparelho (ex: Moto G35 5G) e a versão do Android utilizada.

Dica: Se o terminal não tiver retornado nenhuma linha no momento do teste, informe isso no chamado. Isso ajuda nosso time de analistas a identificar se a atividade foi bloqueada de forma silenciosa e se será necessário gerar um relatório completo de logs (bugreport) para investigação.