iOS, Android, Flutter, React Native

Kurulum one package per platform

Her platformun, public key ve proje id'si alan bir Blipit paketi vardır; hepsi Blipit'in kendi çekirdeği üzerine kuruludur ve içlerinde üçüncü taraf bir çökme kütüphanesi yoktur: blipit-android v0.7.5, blipit-swift 0.8.0, @blipit/react-native 0.6.3 ve blipit_flutter 0.5.3. Çökmeler, ANR'ler, donmalar ve yakalanmamış istisnalar kendiliğinden raporlanır; önce diske yazılır ve bir sonraki açılışta gönderilir, çevrimdışı bir kuyruk da raporları ağ geri gelene kadar saklar. Sembol dosyaları henüz okunmadığından native çökmeler için debug sembollerini saklayın.

Yapay zekâ asistanınız için bir istem kopyalayınClaude Code, Cursor veya başka bir yapay zekâ kodlama asistanına yapıştırın. Adımları ve kodu içerir. app.blipit.io'da API anahtarları altında aynı istem, anahtarınız yazılmış olarak gelir.
Video: Blipit'i her stack'e kurun, 1:56 itibarıyla

1Anahtarlarınızı alın

app.blipit.io'da oturum açın ve kenar çubuğunda API anahtarları'nı, ardından projenizi açın. Her projenin iki anahtarı vardır. Public key blipit_pk_ ile başlar: tarayıcı ve uygulama koduna gider, yalnızca olay gönderebilir ve herkesin görmesi güvenlidir. Secret key blipit_sk_ ile başlar: sunucunuzda ya da Odoo'da kalır, asla tarayıcıda olmaz, çünkü sorunları okuyup değiştirebilir de. Secret key yalnızca bir kez, oluşturulduktan hemen sonra gösterilir, bu yüzden o anda kopyalayın; kaybederseniz Yeni bir secret key oluştur'a basın, eskisi hemen çalışmayı durdurur. Bazı SDK'lar ayrıca aynı sayfada gösterilen proje id'sine ihtiyaç duyar.

app.blipit.io'da API anahtarları: tarayıcı kodu için public key (blipit_pk_), sunucular ve Odoo için secret key (blipit_sk_).
app.blipit.io'da API anahtarları: tarayıcı kodu için public key (blipit_pk_), sunucular ve Odoo için secret key (blipit_sk_).
Yeni bir secret key yalnızca bir kez gösterilir. Şimdi kopyalayın: hash'lenmiş olarak saklanır ve bir daha gösterilemez.
Yeni bir secret key yalnızca bir kez gösterilir. Şimdi kopyalayın: hash'lenmiş olarak saklanır ve bir daha gösterilemez.

2React Native

Paket, native çökmeler için Blipit'in kendi Android ve iOS SDK'larını başlatan küçük bir native modül bağlar; Gradle dosyası JitPack deposunu kendisi ekler. Render hatalarının da raporlanması için kök bileşeni sarın.

sh
npm install @blipit/react-native
npx pod-install
tsx
import * as Blipit from "@blipit/react-native";

Blipit.init({ key: "<public key>", project: <project id>, environment: "production", release: "myapp@1.4.2" });

export default Blipit.wrap(App);

3Flutter

main.dart içinde runApp'i Blipit.init ile değiştirin. Eklenti, native çökmeler için Blipit'in kendi Android ve iOS SDK'larını başlatır; Flutter framework hataları ve yakalanmamış async hatalar kendiliğinden raporlanır.

sh
flutter pub add blipit_flutter
main.dart
import 'package:blipit_flutter/blipit_flutter.dart';

Future<void> main() async {
  await Blipit.init(
    key: '<public key>',
    project: <project id>,
    environment: 'production',
    release: 'myapp@1.4.2',
    appRunner: () => runApp(const MyApp()),
  );
}

4iOS ve macOS (Swift Package)

Xcode'da File, Add Package Dependencies'e gidin ve depo URL'sini girin; ya da Package.swift'e ekleyin ve BlipitSwift'i hedefinize ekleyin. CocoaPods ile BlipitSwift pod'unu kullanın. Ardından açılışta start'ı bir kez çağırın. Anahtar ya da proje id'si boşsa start uygulamayı çökertmek yerine bir uyarı yazdırır ve false döndürür.

Package.swift
.package(url: "https://github.com/blipit-io/blipit-swift", from: "0.8.0")
Podfile
pod "BlipitSwift", "~> 0.8.0"
swift
import BlipitSwift

Blipit.start(key: "<public key>", project: "<project id>", environment: "production", release: "myapp@1.4.2")

5Android

settings.gradle.kts içindeki repositories'e JitPack'i, uygulama modülüne bağımlılığı ekleyin ve Application.onCreate içinde init'i çağırın.

settings.gradle.kts
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven("https://jitpack.io")
    }
}
build.gradle.kts (app)
implementation("com.github.blipit-io:blipit-android:v0.7.5")
kotlin
import io.blipit.android.Blipit

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        Blipit.init(this) {
            key = "<public key>"
            project = "<project id>"
            environment = "production"
            release = "myapp@1.4.2"
        }
    }
}

6Anahtar bir uygulamada nereye konur

Uygulamalar public key'i ve proje id'sini uygulamanın içinde taşır; bu sorun değildir: public key yalnızca olay gönderebilir. Secret key'i asla bir uygulamaya koymayın. Depo dışında kalmaları için bunları derleme sırasında verin.

Flutter
flutter run --dart-define=BLIPIT_KEY=blipit_pk_your_public_key --dart-define=BLIPIT_PROJECT=12
main.dart
const key = String.fromEnvironment('BLIPIT_KEY');
const project = int.fromEnvironment('BLIPIT_PROJECT');
Expo (.env)
EXPO_PUBLIC_BLIPIT_KEY=blipit_pk_your_public_key
EXPO_PUBLIC_BLIPIT_PROJECT=12
Android build.gradle.kts
buildConfigField("String", "BLIPIT_KEY", "\"${project.findProperty("blipitKey")}\"")
iOS xcconfig
BLIPIT_KEY = blipit_pk_your_public_key

7Uygulamalarda hata raporları

showReport'u kendi menü öğenizden çağırın veya kayan Hata bildir düğmesini açın. Bildirici önce sorunu nasıl göstereceğinizi sorar: ekran görüntüsü almak, ekranı kaydetmek (iOS) ya da yalnızca anlatmak. Ekran görüntüsü tam ekran açılır; araçlar görüntünün üstünde ve altındadır, asla üzerinde değildir. Yakınlaştırmak için iki parmakla sıkıştırın veya çift dokunun, sorunu işaretleyin, ardından başlık ve ne olduğunu ekleyip gönderin. Bildirimler cihaz bilgileriyle Hata bildirimleri bölümüne gelir. React Native ekran görüntüsü için react-native-view-shot gerektirir.

React Native
import * as Blipit from "@blipit/react-native";

export default function Root() {
  return (
    <Blipit.BlipitReporter showButton>
      <App />
    </Blipit.BlipitReporter>
  );
}

Blipit.showReport();
Flutter
appRunner: () => runApp(const BlipitReporter(showButton: true, child: MyApp())),

Blipit.showReport();
iOS
Blipit.showReportButton()

Blipit.showReport()
Android
Blipit.showReportButton()

Blipit.showReport()

8Hatanın olduğu ekrandan bildirin

Profil gibi bir menüdeki Hata bildir öğesi sorunu değil menüyü yakalar. Ekranın kendisinden başlayan yolları açın; hepsi varsayılan olarak kapalıdır ve izin istemez. shakeToReport telefon sallandığında bildirim formunu açar. screenshotToReport normal bir ekran görüntüsünden sonra "Bu ekranla bir hata bildirilsin mi?" diye sorar ve Blipit'in kendi görüntüsünü ekler (iOS ile Android 14 ve sonrası). twoFingerReport, uygulamanın kendi dokunuşlarını engellemeden yaklaşık bir saniyelik iki parmakla basılı tutmadan sonra açar. reportAfterCrash bir çökmeden sonraki ilk açılışta kişinin ne yaptığını sorar ve raporu o çökmeye bağlar. Varsayılan olarak açık olan screenPicker, formu menüden açan kişinin hatanın son ekranlardan hangisinde olduğunu seçmesini sağlar: anlık görüntüler cihazın belleğinde kalır ve yalnızca seçilen yüklenir. Jetpack Compose ve SwiftUI uygulamaları ekranlarını setScreen ile adlandırır.

Android
Blipit.init(this) {
    key = "<public key>"
    project = "<project id>"
    shakeToReport = true
    screenshotToReport = true
    twoFingerReport = true
    reportAfterCrash = true
}

navController.addOnDestinationChangedListener { _, destination, _ ->
    Blipit.setScreen(destination.route ?: "screen")
}
iOS
Blipit.start(key: "<public key>", project: "<project id>") { options in
    options.shakeToReport = true
    options.screenshotToReport = true
    options.twoFingerReport = true
    options.reportAfterCrash = true
}

CartView().onAppear { Blipit.setScreen("Cart") }
React Native
Blipit.init({
  key: "<public key>",
  project: <project id>,
  shakeToReport: true,
  screenshotToReport: true,
  twoFingerReport: true,
  reportAfterCrash: true,
});

<NavigationContainer ref={navigation} onReady={() => Blipit.trackNavigation(navigation)}>
Flutter
await Blipit.init(
  key: '<public key>',
  project: <project id>,
  shakeToReport: true,
  screenshotToReport: true,
  twoFingerReport: true,
  reportAfterCrash: true,
  appRunner: () => runApp(BlipitReporter(child: MaterialApp(navigatorObservers: [BlipitNavigatorObserver()], home: const Home()))),
);

9Yalnızca test kullanıcıları için yüzen düğme

app.blipit.io'da projeyi açın ve hata raporu düğmesi ayarlarında Telefon uygulamalarında yüzen düğme seçeneğini Herkes veya Yalnızca test kullanıcıları yapın; her test kullanıcısı için bir kullanıcı kimliği veya e-posta girin. Uygulama setUser ile ayarladığı kişiyi gönderir ve Blipit yalnızca evet ya da hayır yanıtı verir, bu yüzden test kullanıcısı listesi asla uygulamanın içinde gönderilmez. showReportButton çağırmak (React Native ve Flutter'da showButton) düğmeyi yine herkese gösterir.

Android
Blipit.setUser(id = user.id, email = user.email)
iOS
Blipit.setUser(id: user.id, email: user.email)
React Native
Blipit.setUser({ id: user.id, email: user.email });
Flutter
Blipit.setUser(BlipitUser(id: user.id, email: user.email));

10Takılan bir uygulamayı yakalamak

Bazı hatalar hiç çökme yaratmaz: açılış ekranı dönmeye devam eder ya da giriş hiç geri dönmez. waitForReady'yi açın ve ilk kullanılabilir ekran göründüğünde reportReady'yi çağırın. Giriş gibi akışları startFlow ve endFlow arasına alın, adımları flowStep ile işaretleyin. Biri zamanında bitmezse Blipit son adım ve öncesindeki izle birlikte Takıldı türünde bir sorun açar. Yalnızca ekranda geçen süre sayılır ve süre sınırlarını Blipit belirler. Adlar yazıldığı gibi gönderilir; sabit adlar kullanın, asla e-posta ya da başka kullanıcı verisi kullanmayın.

Android
Blipit.init(this) {
    key = "<public key>"
    project = "<project id>"
    waitForReady = true
}

Blipit.reportReady()

Blipit.startFlow("sign-in")
Blipit.flowStep("sign-in", "google-picker")
Blipit.endFlow("sign-in")
iOS
Blipit.start(key: "<public key>", project: "<project id>", waitForReady: true)

Blipit.reportReady()

Blipit.startFlow("sign-in")
Blipit.flowStep("sign-in", "apple-sheet")
Blipit.endFlow("sign-in")
React Native
Blipit.init({ key: "<public key>", project: <project id>, waitForReady: true });

Blipit.reportReady();

Blipit.startFlow("sign-in");
Blipit.flowStep("sign-in", "google-picker");
Blipit.endFlow("sign-in");
Flutter
await Blipit.init(key: '<public key>', project: <project id>, waitForReady: true, appRunner: () => runApp(const MyApp()));

Blipit.reportReady();

Blipit.startFlow('sign-in');
Blipit.flowStep('sign-in', 'google-picker');
Blipit.endFlow('sign-in');

11Çalıştığını kontrol edin

app.blipit.io içinde Sorunlar'ı açın. İlk olay birkaç saniye içinde bir sorun altında gruplanmış olarak görünür ve sorumlu kişilere e-posta gider.

React Native
Blipit.captureMessage("Hello from React Native");
Flutter
await Blipit.captureMessage('Hello from Flutter');
iOS
Blipit.captureMessage("Hello from iOS")
Android
Blipit.captureMessage("Hello from Android")

Bilmekte fayda var

  • Her platformda manuel yakalama: captureException, captureMessage, setUser, setTag, addBreadcrumb ve giriş denemeleri için captureSecurity.
  • Expo: npx expo prebuild çalıştırın ya da bir development build kullanın. Expo Go'da özel native kod yoktur; bu yüzden JavaScript hataları orada da raporlanır ama native çökmeler raporlanmaz.
  • React Native'i 0.4'ten yükseltme: 0.4'ün yanına kurduğu üçüncü taraf izleme paketini kaldırın ve Expo config eklentisini silin; dsn() ve withIdentity() kaldırıldı. Flutter'ı 0.3'ten yükseltme: o paketi pubspec.yaml'dan da kaldırın; level ve user türleri artık BlipitLevel ve BlipitUser, capture çağrıları olay id'sini String? olarak döndürür ve Blipit.dsn, Blipit.configure ile init'in options: callback'i kaldırıldı. İkisinde de tracesSampleRate kabul edilir ancak bu sürümde performans trace'leri gönderilmez.
  • Android'i v0.5.0'a ve iOS'u 0.5.0'a yükseltme: çoğu uygulama yalnızca sürümü yükseltir. Capture çağrıları olay id'sini string olarak döndürür, level türü Blipit'in kendi Level'ıdır ve Blipit.dsn kaldırıldı. Android'de configure ve apply kaldırıldı ve replay maskeleme etiketi artık blipit-mask. iOS'ta Options Blipit'in kendi sınıfıdır ve beforeSend olay üzerinde bir sözlük olarak çalışır.
  • Bildirim yolları için mağaza incelemesi: yeni bir izin istemi yoktur. iOS, UIKit sallama olaylarını (CoreMotion değil) ve ekran görüntüsü bildirimini kullanır, bu yüzden gizlilik bildiriminde yeni bir girişe gerek yoktur. Android 14 ve sonrasında SDK, kurulumda verilen normal bir izin olan DETECT_SCREEN_CAPTURE'ı bildirir; Google Play Veri güvenliği için yeni bir şey toplanmaz, çünkü Blipit yalnızca ekran görüntüsü alındığını öğrenir, görüntüyü veya galeriyi asla okumaz. Eski Android sürümleri ekran görüntüsüyle bildirmeyi atlar. Huawei AppGallery derlemeleri aynı şekilde çalışır ve Google Play hizmetlerini kullanmaz.
  • Kurulu sürümü npm ls @blipit/react-native (veya pnpm list @blipit/react-native) ile kontrol edin. pnpm 11 yeni bir sürümü kurmadan önce bir gün bekler (minimum-release-age), bu yüzden yayın günü pnpm add hiçbir uyarı vermeden önceki sürümü kurar; yenisini hemen almak için pnpm add @blipit/react-native@<version> --config.minimum-release-age=0 komutunu çalıştırın.
  • Blipit'i güncel tutmak: Blipit'i güncel tutmak rehberi (docs.blipit.io/updates) güncelleme afişini, önemli sürümler için e-postaları, geliştirme konsolunuzdaki bildirimi ve bu platformun güncelleme komutunu açıklar.
  • Her uygulama ve platform için bir proje: her proje oluşturulurken platformunu seçer (Android, iOS, React Native, Flutter, Web, Backend veya Odoo) ve Blipit başka bir platformdan gelen verileri açık bir hatayla reddeder. Yani bir iOS uygulaması ile bir Android uygulaması için iki anahtarlı iki proje gerekir. Sürümler, versiyonlar, çökme oranları ve mağaza derlemeleri her platformda farklıdır; bunları tek projede karıştırmak hepsini yanlış yapar. Web projesi aynı web uygulamasının sunucu tarafını da kabul eder (Next.js sunucusu veya Node), React Native veya Flutter projesi de kendi yerel Android ve iOS çökme raporlarını kabul eder.

Takıldınız mı? support@blipit.io adresine e-posta gönderin. Her projenin anahtarları ve proje id'si app.blipit.io içindeki API anahtarları altındadır.