Pular para o conteúdo

Bug report dentro do app: chacoalhe para reportar, com a rede e os logs anexados

Atualizado em

Os SDKs do Midge colocam um fluxo de Report a bug dentro do seu próprio app. Quem está usando chacoalha o celular, ou toca no seu botão, grava a tela e diz o que deu errado. O report chega ao seu workspace do Midge com o que o app fez naquele intervalo: as requisições e respostas HTTP, as mensagens de log, o dispositivo e o contexto que você definiu, como o ID ou o plano do usuário.

É a diferença entre um ticket de suporte que diz "o checkout está quebrado no meu celular" e um que mostra o toque em Pay, o 502 de /api/orders e o plano do usuário, numa única linha do tempo.

Três plataformas, um workspace

PlataformaComo adicionarCaptura de rede
Sites e aplicações webUma tag <script>fetch e XMLHttpRequest
iPhone e iPad (iOS 17+)Swift packageURLSession
Android (API 26+)Biblioteca KotlinOkHttp, HttpURLConnection, Volley ou Midge.network()

Todo SDK envia para um link de gravação, então os reports caem no mesmo workspace dos que o seu time faz com a extensão do Chrome, o app para Mac e os apps para iPhone e Android.

Configuração no iOS

import MidgeSDK

@main
struct ShopApp: App {
    init() {
        Midge.start(link: "rl_YOUR_TOKEN")
    }
}

Agora, chacoalhar o celular abre a tela de report. Para abri-la a partir de um botão seu, chame Midge.report(). Configuração completa: documentação do SDK para iOS.

Configuração no Android

class ShopApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        Midge.start(this, link = "rl_YOUR_TOKEN")
    }
}

val client = OkHttpClient.Builder()
    .addInterceptor(Midge.okHttpInterceptor())
    .build()

Código que usa HttpURLConnection ou Volley chama Midge.openConnection(url) em vez de url.openConnection(). Configuração completa: documentação do SDK para Android.

Configuração na web

<script src="https://midge.dev/sdk/v1.js" data-link="YOUR_LINK_TOKEN" async></script>

Um botão Report a bug aparece no canto do seu site. Configuração completa: documentação do SDK para sites.

O que cada report contém

  • A gravação de tela, só do seu app: outros apps e notificações não são gravados.
  • Requisições de rede com headers, bodies de até 64 KB, status e tempos.
  • Logs: no iOS, as mensagens de Logger, os_log e NSLog do seu app; no Android, as linhas de logcat do próprio app; na web, o console. Midge.log() adiciona linhas suas.
  • Dispositivo: nome, versão e build do app, modelo do aparelho, versão do sistema, idioma e fuso horário.
  • Metadados que você define com Midge.metadata(), e o nome e o e-mail de quem reportou, vindos de Midge.user().

As requisições dos últimos minutos ficam só na memória, e nada é enviado a menos que a pessoa toque em Send.

Ocultado no aparelho

Antes que qualquer coisa saia do celular ou do navegador, o Midge remove senhas, tokens, cookies, headers de autorização e números de cartão, mascara e-mails e telefones, e aplica os nomes de campos ocultos definidos pelo seu workspace. No mobile, isso roda o mesmo código de ocultação da extensão do Chrome, então um token é pego do mesmo jeito em qualquer lugar. Veja a ocultação.

Só o seu app consegue enviar

Na web, o SDK só envia a partir de domínios que o seu workspace verificou. No mobile, um owner ou admin registra o bundle id ou o application id do app no workspace; para qualquer outro app, a tela de report avisa isso e não envia nada.

Por que não construir isso você mesmo

Um formulário de "Enviar feedback" que manda uma caixa de texto por e-mail é fácil. O difícil é tudo de que um dev precisa em seguida: uma gravação do que a pessoa fez, a requisição que falhou e o body da resposta, as linhas de log em volta e a confiança de que nada disso contém a senha ou o número de cartão de um cliente. Construir, ocultar e armazenar isso para três plataformas é um projeto à parte. Com o Midge, são poucas linhas por app, e os reports chegam onde o seu time já trabalha.

Do report à correção

Cada report abre no midge.dev com o vídeo e os logs lado a lado, um resumo de IA com os passos para reproduzir e envio com um clique para o Jira, o Linear, o GitHub ou o Slack pelas integrações. Agentes de código como o Claude Code e o Cursor leem o mesmo report pelo servidor MCP do Midge.

O Midge é grátis: gravações ilimitadas, vídeos de até 15 minutos e sem marca d'água.

Perguntas frequentes

Quais plataformas os SDKs suportam?
Sites e aplicações web por uma tag de script, apps de iPhone e iPad (iOS 17 ou mais recente) por um Swift package, e apps Android (Android 8.0, API 26, ou mais recente) por uma biblioteca Kotlin.
Como um usuário abre a tela de report?
Em apps mobile, chacoalhando o celular ou por um botão Report a bug seu que chama Midge.report(). Na web, por um botão Report a bug que o script adiciona, ou por um botão seu.
Quais requisições de rede são capturadas?
No iOS, as requisições de URLSession. No Android, OkHttp (e Retrofit, Coil e a engine OkHttp do Ktor) por um interceptor, HttpURLConnection e Volley, e qualquer outro cliente por Midge.network(). Na web, fetch e XMLHttpRequest.
Dados sensíveis são enviados ao Midge?
Não. Senhas, tokens, cookies, números de cartão e os campos ocultos definidos pelo seu workspace são ocultados no próprio aparelho, pelo mesmo código da extensão do Chrome, antes que qualquer coisa seja enviada.
Os SDKs mobile já estão disponíveis?
O SDK para sites está disponível para todo workspace. Os SDKs de iOS e Android estão em acesso antecipado: mande um e-mail para [email protected] com o nome do seu app para pedir acesso.