İçeriğe geç

Uygulama içi bug raporlama: salla ve bildir, ağ ve loglar ekli

Güncelleme

Midge'in SDK'ları kendi uygulamanın içine bir Report a bug akışı koyar; kullanıcılarının uygulamadan çıkıp bir e-posta yazmasına gerek kalmaz. Uygulamayı kullanan kişi telefonu sallar ya da senin düğmene dokunur, ekranı kaydeder ve neyin ters gittiğini söyler. Rapor, uygulamanın tam o sırada yaptıklarıyla birlikte doğrudan Midge çalışma alanına ulaşır: HTTP istekleri ve yanıtları, log mesajları, cihaz ve kullanıcının kimliği ya da planı gibi senin belirlediğin bağlam.

Aradaki fark büyük: Bir destek talebi yalnızca "telefonumda ödeme bozuk" der; diğeri ise Pay'e dokunuşu, /api/orders'tan dönen 502'yi ve kullanıcının planını tek bir zaman çizelgesinde gösterir.

Üç platform, tek çalışma alanı

PlatformNasıl eklenirAğ yakalama
Web siteleri ve web uygulamalarıTek bir <script> etiketifetch ve XMLHttpRequest
iPhone ve iPad (iOS 17+)Swift paketiURLSession
Android (API 26+)Kotlin kütüphanesiOkHttp, HttpURLConnection, Volley ya da Midge.network()

Hangi platformu seçersen seç, her SDK bir kayıt bağlantısına gönderir; böylece raporlar, ekibinin Chrome eklentisi, Mac uygulaması ve iPhone ile Android uygulamalarıyla oluşturduklarıyla aynı çalışma alanına düşer.

iOS'ta kurulum

import MidgeSDK

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

Hepsi bu kadar: Artık telefonu sallamak rapor ekranını açar. Rapor ekranını kendi düğmenden ya da menünden açmak için Midge.report()'u çağır. Kurulumun tamamı: iOS SDK dokümanı.

Android'de kurulum

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

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

HttpURLConnection ya da Volley kullanan kod, url.openConnection() yerine Midge.openConnection(url)'u çağırır. Kurulumun tamamı: Android SDK dokümanı.

Web'de kurulum

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

Sitenin köşesinde bir Report a bug düğmesi belirir; kendi düğmeni kullanmak istersen onu da bağlayabilirsin. Kurulumun tamamı: website SDK dokümanı.

Her rapor neleri içerir

  • Ekran kaydı, yalnızca senin uygulamanın: Diğer uygulamalar ve gelen bildirimler kaydedilmez.
  • Ağ istekleri: header'lar, 64 KB'a kadar body'ler, durum ve süreyle.
  • Loglar: iOS'ta uygulamanın Logger, os_log ve NSLog mesajları; Android'de uygulamanın kendi logcat satırları; web'de konsol. Midge.log() kendi satırlarını ekler.
  • Cihaz: uygulama adı, sürümü ve build'i, cihaz modeli, işletim sistemi sürümü, dil ve saat dilimi.
  • Midge.metadata() ile belirlediğin metadata ve Midge.user()'dan raporlayanın adı ve e-postası.

Son birkaç dakikanın istekleri yalnızca bellekte tutulur; kişi Send'e dokunmadıkça hiçbir şey gönderilmez. Rapor ekranını açıp vazgeçen bir kullanıcıdan sana hiçbir veri ulaşmaz.

Cihazda maskelenir

Hassas veriler cihazın dışına hiç çıkmaz. Telefondan ya da tarayıcıdan bir şey çıkmadan önce Midge şifreleri, token'ları, çerezleri, authorization header'larını ve kart numaralarını siler, e-postaları ve telefon numaralarını maskeler ve çalışma alanının kendi gizli alan adlarını uygular. Mobilde bu, Chrome eklentisiyle aynı maskeleme kodunu çalıştırır; böylece bir token, hangi platformdan gelirse gelsin, her yerde aynı şekilde yakalanır. Maskeleme sayfasına bak.

Yalnızca senin uygulaman gönderebilir

Başkası senin bağlantını kendi uygulamasına koysa bile işe yaramaz. Web'de SDK yalnızca çalışma alanının doğruladığı alan adlarından gönderir. Mobilde ise bir sahip ya da yönetici, uygulamanın bundle id'sini ya da application id'sini önceden çalışma alanına kaydeder; başka bir uygulamada rapor ekranı bunu söyler ve hiçbir şey göndermez.

Neden kendin yapmıyorsun

Bir metin kutusunu e-postayla gönderen bir "Geri bildirim gönder" formu kolay. Zor olan, bir geliştiricinin sonrasında ihtiyaç duyduğu her şey: kişinin ne yaptığının kaydı, başarısız olan istek ve yanıt body'si, çevresindeki log satırları ve bunların hiçbirinde bir müşterinin şifresinin ya da kart numarasının olmadığından emin olmak. Bunu üç ayrı platform için kurmak, maskelemek, saklamak ve güncel tutmak başlı başına bir proje. Midge ile her uygulama için birkaç satır kod yeterli ve raporlar, yeni bir araç öğrenmeye gerek kalmadan ekibinin zaten çalıştığı yere gelir.

Rapordan düzeltmeye

Her rapor midge.dev'de video ve loglar yan yana, yeniden üretme adımlarını içeren bir yapay zekâ özetiyle açılır; entegrasyonlar üzerinden de tek tıkla Jira, Linear, GitHub ya da Slack'e aktarılır. Claude Code ve Cursor gibi kodlama ajanları aynı raporu Midge'in MCP sunucusu üzerinden okur.

Midge ücretsiz: sınırsız kayıt, 15 dakikaya kadar video ve filigran yok.

Sık sorulan sorular

SDK'lar hangi platformları destekliyor?
Bir script etiketiyle web siteleri ve web uygulamaları, bir Swift paketiyle iPhone ve iPad uygulamaları (iOS 17 ya da üstü) ve bir Kotlin kütüphanesiyle Android uygulamaları (Android 8.0, API 26 ya da üstü).
Kullanıcı rapor ekranını nasıl açıyor?
Mobil uygulamalarda telefonu sallayarak ya da Midge.report()'u çağıran kendi Report a bug düğmenle. Web'de script'in eklediği Report a bug düğmesiyle ya da kendi düğmenle.
Hangi ağ istekleri yakalanıyor?
iOS'ta URLSession istekleri. Android'de bir interceptor üzerinden OkHttp (ve Retrofit, Coil ve Ktor'un OkHttp motoru), HttpURLConnection ve Volley; diğer her istemci için de Midge.network(). Web'de fetch ve XMLHttpRequest.
Hassas veriler Midge'e gönderiliyor mu?
Hayır. Şifreler, token'lar, çerezler, kart numaraları ve çalışma alanının kendi gizli alanları, hiçbir şey gönderilmeden önce cihazda, Chrome eklentisiyle aynı kodla maskelenir.
Mobil SDK'lar şu an kullanılabilir mi?
Website SDK'sı her çalışma alanında kullanılabilir. iOS ve Android SDK'ları erken erişimde: Erişim için uygulamanın adıyla [email protected] adresine e-posta gönder.