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
| Plataforma | Como adicionar | Captura de rede |
|---|---|---|
| Sites e aplicações web | Uma tag <script> | fetch e XMLHttpRequest |
| iPhone e iPad (iOS 17+) | Swift package | URLSession |
| Android (API 26+) | Biblioteca Kotlin | OkHttp, 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_logeNSLogdo 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 deMidge.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.