iOS, Android, Flutter, React Native

Installation one package per platform

Jede Plattform hat ein Blipit-Paket, das den öffentlichen Schlüssel und die Projekt-ID nimmt, alle gebaut auf Blipits eigenem Kern ohne Crash-Bibliothek von Drittanbietern: blipit-android v0.7.5, blipit-swift 0.8.0, @blipit/react-native 0.6.3 und blipit_flutter 0.5.3. Abstürze, ANRs, Hänger und nicht abgefangene Exceptions werden von selbst gemeldet, zuerst auf die Festplatte geschrieben und beim nächsten Start gesendet, und eine Offline-Warteschlange hält Berichte, bis das Netzwerk wieder da ist. Bewahren Sie Debug-Symbole für native Abstürze auf, da Symboldateien noch nicht gelesen werden.

Prompt für Ihren KI-Assistenten kopierenFügen Sie ihn in Claude Code, Cursor oder einen anderen KI-Programmierassistenten ein. Er enthält die Schritte und den Code. In app.blipit.io unter API-Schlüssel steht derselbe Prompt mit Ihrem Schlüssel bereits eingetragen.
Video: Blipit in jedem Stack installieren, ab 1:56

1Schlüssel abrufen

Melden Sie sich bei app.blipit.io an und öffnen Sie API-Schlüssel in der Seitenleiste, dann Ihr Projekt. Jedes Projekt hat zwei Schlüssel. Der öffentliche Schlüssel beginnt mit blipit_pk_: Er gehört in Browser- und App-Code, kann nur Events senden und darf von jedem gesehen werden. Der geheime Schlüssel beginnt mit blipit_sk_: Er bleibt auf Ihrem Server oder in Odoo, nie in einem Browser, weil er auch Issues lesen und ändern kann. Der geheime Schlüssel wird nur einmal angezeigt, direkt nach der Erstellung, kopieren Sie ihn also dann; geht er verloren, klicken Sie auf Neuen geheimen Schlüssel erstellen, und der alte funktioniert sofort nicht mehr. Manche SDKs brauchen zusätzlich die Projekt-ID, die auf derselben Seite steht.

API-Schlüssel in app.blipit.io: der öffentliche Schlüssel (blipit_pk_) für Browser-Code und der geheime Schlüssel (blipit_sk_) für Server und Odoo.
API-Schlüssel in app.blipit.io: der öffentliche Schlüssel (blipit_pk_) für Browser-Code und der geheime Schlüssel (blipit_sk_) für Server und Odoo.
Ein neuer geheimer Schlüssel wird einmal angezeigt. Kopieren Sie ihn sofort: Er wird gehasht gespeichert und kann nicht erneut angezeigt werden.
Ein neuer geheimer Schlüssel wird einmal angezeigt. Kopieren Sie ihn sofort: Er wird gehasht gespeichert und kann nicht erneut angezeigt werden.

2React Native

Das Paket bindet ein kleines natives Modul ein, das Blipits eigene Android- und iOS-SDKs für native Abstürze startet; seine Gradle-Datei fügt das JitPack-Repository von selbst hinzu. Umschließen Sie die Root-Komponente, damit auch Render-Fehler gemeldet werden.

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

Ersetzen Sie runApp in main.dart durch Blipit.init. Das Plugin startet Blipits eigene Android- und iOS-SDKs für native Abstürze, und Fehler des Flutter-Frameworks sowie nicht abgefangene asynchrone Fehler werden von selbst gemeldet.

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 und macOS (Swift Package)

In Xcode: File, Add Package Dependencies, und geben Sie die Repository-URL ein; oder fügen Sie es in Package.swift hinzu und ergänzen Sie BlipitSwift in Ihrem Target. Mit CocoaPods verwenden Sie den Pod BlipitSwift. Rufen Sie dann start einmal beim Start auf. Mit einem leeren Schlüssel oder einer leeren Projekt-ID gibt start eine Warnung aus und liefert false zurück, statt die App abstürzen zu lassen.

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

Fügen Sie JitPack zu den Repositories in settings.gradle.kts hinzu, die Abhängigkeit zum App-Modul, und rufen Sie init in Application.onCreate auf.

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"
        }
    }
}

6Wo der Schlüssel in einer App hingehört

Apps liefern den öffentlichen Schlüssel und die Projekt-ID in der App aus, und das ist in Ordnung: Der öffentliche Schlüssel kann nur Events senden. Legen Sie den geheimen Schlüssel nie in eine App. Übergeben Sie beide zur Build-Zeit, damit sie nicht in Ihrem Repository landen.

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

7Fehlerberichte in Apps

Rufen Sie showReport aus Ihrem eigenen Menüpunkt auf oder schalten Sie den schwebenden Button Fehler melden ein. Der Reporter fragt zuerst, wie Sie das Problem zeigen möchten: Screenshot aufnehmen, Bildschirm aufnehmen (iOS) oder nur beschreiben. Der Screenshot öffnet sich im Vollbild, die Werkzeuge darüber und darunter, nie darauf; mit zwei Fingern oder Doppeltippen zoomen, das Problem markieren, dann Titel und Ablauf ergänzen und senden. Berichte landen unter Fehlerberichte mit den Gerätedaten. React Native braucht react-native-view-shot für Screenshots.

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()

8Vom Bildschirm mit dem Fehler melden

Ein Eintrag „Fehler melden“ in einem Menü wie Profil erfasst das Menü, nicht das Problem. Schalten Sie die Wege ein, die beim Bildschirm selbst beginnen; alle sind standardmäßig aus und brauchen keine Berechtigungsabfrage. shakeToReport öffnet das Meldeformular, wenn das Telefon geschüttelt wird. screenshotToReport fragt nach einem normalen Screenshot „Einen Fehler mit diesem Bildschirm melden?“ und hängt Blipits eigene Aufnahme an (iOS sowie Android 14 und neuer). twoFingerReport öffnet es nach etwa einer Sekunde Gedrückthalten mit zwei Fingern, ohne die Berührungen der App zu blockieren. reportAfterCrash fragt beim ersten Start nach einem Absturz, was die Person gerade getan hat, und verknüpft die Meldung mit diesem Absturz. screenPicker, standardmäßig an, lässt jemanden, der das Formular aus einem Menü öffnet, wählen, auf welchem der letzten Bildschirme der Fehler ist: Die Schnappschüsse bleiben im Speicher des Geräts, und nur der gewählte wird hochgeladen. Jetpack-Compose- und SwiftUI-Apps benennen ihre Bildschirme mit setScreen.

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()))),
);

9Schwebender Button nur für Tester

Öffnen Sie in app.blipit.io das Projekt und stellen Sie in den Einstellungen des Fehlermelde-Buttons „Schwebender Button in Handy-Apps“ auf Alle oder Nur Tester, mit einer Benutzer-ID oder E-Mail pro Tester. Die App sendet die Person, die sie mit setUser gesetzt hat, und Blipit antwortet nur mit Ja oder Nein, sodass die Testerliste nie in der App ausgeliefert wird. Ein Aufruf von showReportButton (showButton unter React Native und Flutter) zeigt den Button weiterhin allen.

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));

10Eine hängende App erkennen

Manche Fehler stürzen nie ab: Der Startbildschirm dreht sich weiter oder die Anmeldung kommt nie zurück. Schalten Sie waitForReady ein und rufen Sie reportReady auf, sobald der erste nutzbare Bildschirm erscheint. Fassen Sie Abläufe wie die Anmeldung in startFlow und endFlow und markieren Sie Schritte mit flowStep. Wird einer nicht rechtzeitig fertig, öffnet Blipit ein Hängt-Issue mit dem letzten Schritt und dem Verlauf davor. Nur die Zeit auf dem Bildschirm zählt, und Blipit legt die Zeitlimits fest. Namen werden so gesendet, wie sie geschrieben sind: Verwenden Sie feste Namen, niemals E-Mail-Adressen oder andere Nutzerdaten.

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');

11Prüfen, ob es funktioniert

Öffnen Sie Issues in app.blipit.io. Das erste Event erscheint innerhalb weniger Sekunden, gruppiert zu einem Issue, und die verantwortlichen Personen erhalten eine E-Mail.

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")

Gut zu wissen

  • Manuelles Erfassen auf jeder Plattform: captureException, captureMessage, setUser, setTag, addBreadcrumb und captureSecurity für Anmeldeversuche.
  • Expo: Führen Sie npx expo prebuild aus oder verwenden Sie einen Development Build. Expo Go enthält keinen eigenen nativen Code, daher werden JavaScript-Fehler dort weiterhin gemeldet, native Abstürze aber nicht.
  • Upgrade von React Native 0.4: Deinstallieren Sie das Monitoring-Paket eines Drittanbieters, das 0.4 mitinstalliert hat, und entfernen Sie sein Expo-Config-Plugin; dsn() und withIdentity() entfallen. Flutter ab 0.3: Entfernen Sie dieses Paket auch aus pubspec.yaml; die Level- und User-Typen heißen jetzt BlipitLevel und BlipitUser, Capture-Aufrufe geben die Event-ID als String? zurück, und Blipit.dsn, Blipit.configure und der options:-Callback von init entfallen. Bei beiden wird tracesSampleRate akzeptiert, Performance-Traces werden in dieser Version aber nicht gesendet.
  • Upgrade von Android auf v0.5.0 und iOS auf 0.5.0: Bei den meisten Apps genügt es, die Version anzuheben. Capture-Aufrufe geben die Event-ID als String zurück, der Level-Typ ist Blipits eigenes Level, und Blipit.dsn entfällt. Unter Android entfallen configure und apply, und das Masken-Tag für Replays heißt jetzt blipit-mask. Unter iOS ist Options Blipits eigene Klasse, und beforeSend arbeitet mit dem Event als Dictionary.
  • Store-Prüfung für die Meldewege: Es gibt keine neue Berechtigungsabfrage. iOS nutzt UIKit-Schüttelereignisse (nicht CoreMotion) und die Screenshot-Benachrichtigung, daher braucht das Privacy Manifest keinen neuen Eintrag. Unter Android 14 und neuer deklariert das SDK DETECT_SCREEN_CAPTURE, eine normale Berechtigung, die bei der Installation erteilt wird; für die Datensicherheit in Google Play wird nichts Neues erfasst, denn Blipit erfährt nur, dass ein Screenshot gemacht wurde, und liest weder ihn noch die Galerie. Ältere Android-Versionen überspringen das Melden per Screenshot. Builds für Huawei AppGallery verhalten sich genauso und nutzen keine Google-Play-Dienste.
  • Prüfen Sie die installierte Version mit npm ls @blipit/react-native (oder pnpm list @blipit/react-native). pnpm 11 wartet einen Tag, bevor es eine neue Version installiert (minimum-release-age), daher installiert pnpm add am Veröffentlichungstag stillschweigend die vorherige Version; für die neue sofort führen Sie pnpm add @blipit/react-native@<version> --config.minimum-release-age=0 aus.
  • Blipit aktuell halten: Die Anleitung „Blipit auf dem neuesten Stand halten“ (docs.blipit.io/updates) erklärt das Update-Banner, die E-Mails zu wichtigen Releases, den Hinweis in deiner Entwicklungskonsole und den Update-Befehl für diese Plattform.
  • Ein Projekt pro App und Plattform: Jedes Projekt legt beim Anlegen seine Plattform fest (Android, iOS, React Native, Flutter, Web, Backend oder Odoo), und Blipit lehnt Daten von jeder anderen Plattform mit einer klaren Fehlermeldung ab. Eine iOS-App und eine Android-App brauchen also zwei Projekte mit zwei Schlüsseln. Releases, Versionen, Absturzraten und Store-Builds sind je Plattform verschieden, und gemischt in einem Projekt stimmt keiner dieser Werte mehr. Ein Web-Projekt nimmt auch die Serverseite derselben Web-App an (den Next.js-Server oder Node), und ein React-Native- oder Flutter-Projekt auch seine eigenen nativen Android- und iOS-Absturzberichte.

Kommen Sie nicht weiter? Schreiben Sie an support@blipit.io. Schlüssel und die Projekt-ID jedes Projekts finden Sie unter API-Schlüssel in app.blipit.io.