Installation nach Plattform
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.
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.
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.
npm install @blipit/react-native
npx pod-installimport * 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.
flutter pub add blipit_flutterimport '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(url: "https://github.com/blipit-io/blipit-swift", from: "0.8.0")pod "BlipitSwift", "~> 0.8.0"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.
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven("https://jitpack.io")
}
}implementation("com.github.blipit-io:blipit-android:v0.7.5")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 run --dart-define=BLIPIT_KEY=blipit_pk_your_public_key --dart-define=BLIPIT_PROJECT=12const key = String.fromEnvironment('BLIPIT_KEY');
const project = int.fromEnvironment('BLIPIT_PROJECT');EXPO_PUBLIC_BLIPIT_KEY=blipit_pk_your_public_key
EXPO_PUBLIC_BLIPIT_PROJECT=12buildConfigField("String", "BLIPIT_KEY", "\"${project.findProperty("blipitKey")}\"")BLIPIT_KEY = blipit_pk_your_public_key7Fehlerberichte 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.
import * as Blipit from "@blipit/react-native";
export default function Root() {
return (
<Blipit.BlipitReporter showButton>
<App />
</Blipit.BlipitReporter>
);
}
Blipit.showReport();appRunner: () => runApp(const BlipitReporter(showButton: true, child: MyApp())),
Blipit.showReport();Blipit.showReportButton()
Blipit.showReport()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.
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")
}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") }Blipit.init({
key: "<public key>",
project: <project id>,
shakeToReport: true,
screenshotToReport: true,
twoFingerReport: true,
reportAfterCrash: true,
});
<NavigationContainer ref={navigation} onReady={() => Blipit.trackNavigation(navigation)}>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()))),
);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.
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")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")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");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.
Blipit.captureMessage("Hello from React Native");await Blipit.captureMessage('Hello from Flutter');Blipit.captureMessage("Hello from iOS")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.

