Network Inspector — o que é, princípio de funcionamento e monitoramento de requisições de rede

O que é o Network Inspector?

Network Inspector é uma ferramenta de perfilamento de atividade de rede integrada no Android Studio. Permite que os desenvolvedores visualizem em tempo real todas as requisições HTTP e HTTPS enviadas pelo aplicativo, incluindo cabeçalhos, corpo da requisição e resposta, códigos de status e duração da execução. Está disponível através do painel Android Profiler a partir do Android Studio 3.0.

Propósito e escopo de aplicação

A principal tarefa do Network Inspector é depurar a comunicação de rede entre o aplicativo móvel e o servidor. A ferramenta é usada para verificar a correção dos dados transmitidos, analisar o tempo de resposta, buscar erros de API e detectar padrões de rede não ideais. O Network Inspector funciona em qualquer dispositivo com API Level 14.

Compatibilidade e bibliotecas

A ferramenta suporta todos os principais clientes HTTP Android: OkHttp (a partir da versão 2.x), Retrofit, Ktor (KMM), UrlConnection, Apache HttpClient (legado) e WebView. Para OkHttp e Retrofit é necessária a biblioteca OkHttp Profiler — ela é conectada automaticamente ao usar Android Studio 4.1+. Para Ktor é necessária uma configuração de interceptador separada.

Como o Network Inspector funciona

O Network Inspector intercepta chamadas de rede no nível do sistema usando o mecanismo Profiler Agent, que é injetado junto com o Android Profiler. É necessária uma compilação de depuração do aplicativo para o funcionamento correto. A ferramenta não modifica o código do aplicativo nem requer adição de dependências para a funcionalidade básica.

Mecanismo de interceptação de tráfego

Ao iniciar o perfilamento, o Network Inspector se conecta ao processo de depuração do aplicativo e escuta todas as chamadas HTTP que passam pelo OkHttp Client, UrlConnection ou outras bibliotecas compatíveis. Cada requisição é registrada com um carimbo de data/hora, permitindo construir uma linha do tempo da atividade de rede. Para HTTPS, é usada uma camada do sistema que preserva a criptografia durante a transmissão mas permite visualizar o conteúdo decodificado dentro do Studio.

Arquitetura de coleta de dados

A coleta de dados ocorre através do Serviço Profiler do Android Studio, que executa em um processo separado do host. No dispositivo, um agente leve transmite metadados das requisições pelo canal ADB. Isso minimiza o impacto no desempenho do aplicativo — a sobrecarga é inferior a 3% segundo o Google. Os dados da requisição (corpo, cabeçalhos) são transmitidos apenas quando a visualização de detalhes está ativa.

// Conexão OkHttp para integração com Network Inspector
val client = OkHttpClient.Builder()
    .addInterceptor(HttpLoggingInterceptor().apply {
        level = HttpLoggingInterceptor.Level.BASIC
    })
    .build()

// Network Inspector intercepta automaticamente todas as chamadas através do cliente
client.newCall(Request.Builder()
    .url("https://api.example.com/data")
    .build()).execute()

Principais recursos do Network Inspector

O Network Inspector fornece um conjunto de ferramentas para análise abrangente do tráfego de rede. Cada recurso é voltado para resolver uma tarefa específica de depuração.

Linha do tempo de requisições

A tela principal do Network Inspector exibe uma cronologia de todas as requisições como uma linha do tempo. Cada requisição é representada por uma barra colorida: verde — resposta bem-sucedida (2xx), azul — redirecionamento (3xx), amarelo — erro do cliente (4xx), vermelho — erro do servidor (5xx).

Visualização detalhada da requisição

Ao selecionar uma requisição específica, um painel de detalhes é aberto com: Headers, Request Body, Response Body, Cookies, Timing.

Filtragem e busca

O Network Inspector suporta filtragem de requisições por URL, método HTTP, código de status e tipo de conteúdo.

Agrupamento e comparação de requisições

A linha do tempo suporta agrupamento de requisições por padrões de URL.

Depuração de requisições de rede com Network Inspector

O uso prático do Network Inspector abrange cenários típicos de depuração: verificação do formato de dados, identificação de endpoints lentos, detecção de vazamentos de memória e análise de cache.

Verificação da estrutura de resposta JSON

Uma tarefa comum é garantir que o servidor retorne dados no formato esperado. O Network Inspector mostra o corpo da resposta com formatação JSON.

Análise do tempo de execução

A aba Timing divide a execução da requisição em fases: Resolução DNS, Conexão TCP, Handshake TLS, Envio da Requisição, Recebimento da Resposta.

Busca de requisições duplicadas

O Network Inspector ajuda a identificar requisições redundantes.

// Cache de requisições com OkHttp para eliminar duplicação
val cache = Cache(
    File(context.cacheDir, "http_cache"),
    cacheSize = 10L * 1024 * 1024 // 10 MB
)

val cachedClient = OkHttpClient.Builder()
    .cache(cache)
    .addNetworkInterceptor(CacheInterceptor())
    .build()

Limitações do Network Inspector e alternativas

Apesar de suas amplas capacidades, o Network Inspector tem uma série de limitações importantes.

Limitações de plataforma e bibliotecas

O Network Inspector funciona apenas com aplicativos Android e não suporta iOS.

Ferramentas alternativas

Para análise mais profunda do tráfego de rede, existem soluções de terceiros: Charles Proxy, Proxyman, Wireshark, Stetho, Chucker.