Перейти к содержимому

Баг-репорты из приложения: встряхните телефон, а сеть и логи приложатся сами

Обновлено

SDK Midge встраивают сценарий Report a bug прямо в ваше приложение. Пользователь встряхивает телефон или нажимает вашу кнопку, записывает экран и рассказывает, что пошло не так. Репорт приходит в ваше рабочее пространство Midge вместе с тем, что делало приложение в это время: HTTP-запросами и ответами, сообщениями логов, данными об устройстве и контекстом, который задали вы, например ID пользователя или его тарифом.

Это разница между тикетом в поддержку с текстом «на телефоне не работает оформление заказа» и тикетом, где на одной временной шкале видно нажатие на Pay, ответ 502 от /api/orders и тариф пользователя.

Три платформы, одно рабочее пространство

ПлатформаКак подключитьПерехват сети
Сайты и веб-приложенияОдин тег <script>fetch и XMLHttpRequest
iPhone и iPad (iOS 17+)Пакет SwiftURLSession
Android (API 26+)Библиотека KotlinOkHttp, HttpURLConnection, Volley или Midge.network()

Каждый SDK отправляет репорты через ссылку для записи, поэтому они попадают в то же рабочее пространство, что и репорты, которые ваша команда делает расширением для Chrome, приложением для Mac и приложениями для iPhone и Android.

Настройка на iOS

import MidgeSDK

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

Теперь встряхивание телефона открывает окно репорта. Чтобы открыть его своей кнопкой, вызовите Midge.report(). Полная настройка — в документации iOS SDK.

Настройка на Android

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

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

Код, который использует HttpURLConnection или Volley, вызывает Midge.openConnection(url) вместо url.openConnection(). Полная настройка — в документации Android SDK.

Настройка в вебе

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

В углу вашего сайта появится кнопка Report a bug. Полная настройка — в документации SDK для сайтов.

Что содержит каждый репорт

  • Запись экрана, только вашего приложения: другие приложения и уведомления не записываются.
  • Сетевые запросы с заголовками, телами до 64 KB, статусом и таймингами.
  • Логи: на iOS — сообщения Logger, os_log и NSLog вашего приложения; на Android — собственные строки logcat вашего приложения; в вебе — консоль. Midge.log() добавляет ваши собственные строки.
  • Устройство: название приложения, версия и сборка, модель устройства, версия ОС, язык и часовой пояс.
  • Метаданные, которые вы задаёте через Midge.metadata(), а также имя и email автора репорта из Midge.user().

Запросы за последние несколько минут хранятся только в памяти, и ничего не отправляется, пока человек не нажмёт Send.

Очистка на устройстве

Прежде чем что-либо покинет телефон или браузер, Midge удаляет пароли, токены, cookies, заголовки авторизации и номера карт, маскирует email и номера телефонов и применяет названия скрытых полей, заданные вашим рабочим пространством. На мобильных устройствах работает тот же код очистки, что и в расширении для Chrome, поэтому токен ловится одинаково везде. Подробнее — на странице скрытия данных.

Отправлять может только ваше приложение

В вебе SDK отправляет репорты только с доменов, которые подтвердило ваше рабочее пространство. На мобильных устройствах владелец или администратор регистрирует в рабочем пространстве bundle id или application id приложения; для любого другого приложения окно репорта сообщит об этом и ничего не отправит.

Почему не сделать это самим

Форму «Отправить отзыв», которая пересылает текстовое поле на email, сделать легко. Сложно всё то, что разработчику нужно дальше: запись того, что делал человек, упавший запрос и тело его ответа, строки логов вокруг него и уверенность, что нигде нет пароля или номера карты клиента. Собрать, очистить и хранить всё это на трёх платформах — отдельный проект. С Midge это несколько строк кода на приложение, а репорты приходят туда, где ваша команда уже работает.

От репорта до исправления

Каждый репорт открывается на midge.dev с видео и логами рядом, ИИ-сводкой с шагами воспроизведения и передачей в Jira, Linear, GitHub или Slack в один клик через интеграции. ИИ-агенты для программирования, такие как Claude Code и Cursor, читают тот же репорт через MCP-сервер Midge.

Midge бесплатен: записи без ограничений, видео до 15 минут и без водяного знака.

Частые вопросы

Какие платформы поддерживают SDK?
Сайты и веб-приложения — через тег script, приложения для iPhone и iPad (iOS 17 или новее) — через пакет Swift, приложения для Android (Android 8.0, API 26 или новее) — через библиотеку Kotlin.
Как пользователь открывает окно репорта?
В мобильных приложениях — встряхнув телефон или нажав вашу собственную кнопку Report a bug, которая вызывает Midge.report(). В вебе — кнопкой Report a bug, которую добавляет скрипт, или своей собственной.
Какие сетевые запросы записываются?
На iOS — запросы URLSession. На Android — OkHttp (а также Retrofit, Coil и Ktor с движком OkHttp) через интерсептор, HttpURLConnection и Volley, а любой другой клиент — через Midge.network(). В вебе — fetch и XMLHttpRequest.
Отправляются ли в Midge чувствительные данные?
Нет. Пароли, токены, cookies, номера карт и скрытые поля, заданные вашим рабочим пространством, удаляются на устройстве тем же кодом, что и в расширении для Chrome, ещё до отправки.
Мобильные SDK уже доступны?
SDK для сайтов доступен каждому рабочему пространству. SDK для iOS и Android находятся в раннем доступе: напишите на [email protected] и укажите название вашего приложения, чтобы получить доступ.