iOS, Android, Flutter, React Native

Installeren one package per platform

Elk platform heeft een Blipit-package dat de publieke sleutel en het project-id gebruikt, allemaal gebouwd op Blipit's eigen kern zonder crashbibliotheek van derden erin: blipit-android v0.7.5, blipit-swift 0.8.0, @blipit/react-native 0.6.3 en blipit_flutter 0.5.3. Crashes, ANR's, hangs en niet-afgevangen exceptions worden vanzelf gemeld, eerst naar schijf geschreven en bij de volgende start verstuurd, en een offline wachtrij bewaart meldingen tot het netwerk terug is. Bewaar debugsymbolen voor native crashes, want symboolbestanden worden nog niet gelezen.

Kopieer een prompt voor je AI-assistentPlak hem in Claude Code, Cursor of een andere AI-codeerassistent. Hij bevat de stappen en de code. In app.blipit.io, onder API-sleutels, staat dezelfde prompt met je sleutel al ingevuld.
Video: Blipit installeren in elke stack, vanaf 1:56

1Haal je sleutels op

Log in op app.blipit.io en open API-sleutels in de zijbalk, en dan je project. Elk project heeft twee sleutels. De publieke sleutel begint met blipit_pk_: hij gaat in browser- en appcode, kan alleen events insturen en mag door iedereen gezien worden. De geheime sleutel begint met blipit_sk_: hij blijft op je server of in Odoo, nooit in een browser, omdat hij ook issues kan lezen en wijzigen. De geheime sleutel wordt maar één keer getoond, direct na het aanmaken, dus kopieer hem dan; raak je hem kwijt, druk dan op Nieuwe geheime sleutel aanmaken, en de oude werkt meteen niet meer. Sommige SDK's hebben ook het project-id nodig, dat op dezelfde pagina staat.

API-sleutels in app.blipit.io: de publieke sleutel (blipit_pk_) voor browsercode en de geheime sleutel (blipit_sk_) voor servers en Odoo.
API-sleutels in app.blipit.io: de publieke sleutel (blipit_pk_) voor browsercode en de geheime sleutel (blipit_sk_) voor servers en Odoo.
Een nieuwe geheime sleutel wordt één keer getoond. Kopieer hem nu: hij wordt gehasht opgeslagen en kan niet meer worden getoond.
Een nieuwe geheime sleutel wordt één keer getoond. Kopieer hem nu: hij wordt gehasht opgeslagen en kan niet meer worden getoond.

2React Native

Het package koppelt een kleine native module die Blipit's eigen Android- en iOS-SDK's start voor native crashes; het Gradle-bestand ervan voegt de JitPack-repository zelf toe. Wikkel de rootcomponent in, zodat renderfouten ook gemeld worden.

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

Vervang runApp in main.dart door Blipit.init. De plugin start Blipit's eigen Android- en iOS-SDK's voor native crashes, en fouten in het Flutter-framework en niet-afgevangen async-fouten worden vanzelf gemeld.

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

In Xcode: File, Add Package Dependencies, en vul de URL van de repository in; of voeg hem toe aan Package.swift en voeg BlipitSwift toe aan je target. Met CocoaPods gebruik je de BlipitSwift-pod. Roep daarna start één keer aan bij het opstarten. Met een lege sleutel of een leeg project-id print start een waarschuwing en geeft false terug in plaats van de app te laten crashen.

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

Voeg JitPack toe aan de repositories in settings.gradle.kts, de dependency aan de app-module, en roep init aan in Application.onCreate.

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

6Waar de sleutel in een app komt

Apps leveren de publieke sleutel en het project-id mee in de app, en dat is prima: de publieke sleutel kan alleen events insturen. Zet de geheime sleutel nooit in een app. Geef ze mee bij het builden, zodat ze buiten je repository blijven.

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

7Bugmeldingen in apps

Roep showReport aan vanuit je eigen menu-item, of zet de zwevende knop Bug melden aan. De reporter vraagt eerst hoe je het probleem wilt laten zien: een screenshot maken, het scherm opnemen (iOS) of alleen beschrijven. De screenshot opent schermvullend met de tools erboven en eronder, nooit erop; knijp of tik twee keer om te zoomen, markeer het probleem, voeg een titel en wat er gebeurde toe en verstuur. Meldingen komen binnen onder Bugmeldingen met de apparaatgegevens. React Native heeft react-native-view-shot nodig voor 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()

8Melden vanaf het scherm met de bug

Een menu-item Bug melden in bijvoorbeeld Profiel legt het menu vast, niet het probleem. Zet de manieren aan die bij het scherm zelf beginnen; ze staan standaard uit en vragen geen toestemming. shakeToReport opent het meldformulier als de telefoon wordt geschud. screenshotToReport vraagt na een gewone screenshot "Een bug melden met dit scherm?" en voegt Blipits eigen opname toe (iOS, en Android 14 en nieuwer). twoFingerReport opent het na ongeveer een seconde met twee vingers ingedrukt houden, zonder de aanrakingen van de app te blokkeren. reportAfterCrash vraagt bij de eerste start na een crash wat de persoon aan het doen was en koppelt de melding aan die crash. screenPicker, standaard aan, laat iemand die het formulier vanuit een menu opent kiezen op welk van de laatste schermen de bug zit: de snapshots blijven in het geheugen van het toestel en alleen de gekozen wordt geüpload. Jetpack Compose- en SwiftUI-apps geven hun schermen een naam met 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()))),
);

9Zwevende knop alleen voor testers

Open in app.blipit.io het project en zet in de instellingen van de meldknop Zwevende knop in telefoonapps op Iedereen of Alleen testers, met één gebruikers-id of e-mailadres per tester. De app stuurt de persoon die met setUser is ingesteld en Blipit antwoordt alleen ja of nee, dus de testerslijst gaat nooit mee in de app. showReportButton aanroepen (showButton bij React Native en Flutter) toont de knop nog steeds aan iedereen.

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

10Een app betrappen die vastloopt

Sommige fouten crashen nooit: het opstartscherm blijft draaien, of inloggen komt nooit terug. Zet waitForReady aan en roep reportReady aan zodra het eerste bruikbare scherm verschijnt. Zet flows zoals inloggen tussen startFlow en endFlow, en markeer stappen met flowStep. Als er een niet op tijd klaar is, opent Blipit een Vastgelopen-issue met de laatste stap en het spoor daarvoor. Alleen tijd op het scherm telt, en Blipit bepaalt de tijdslimieten. Namen worden verstuurd zoals ze geschreven zijn, dus gebruik vaste namen, nooit e-mailadressen of andere gebruikersgegevens.

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

11Check of het werkt

Open Issues in app.blipit.io. Het eerste event verschijnt binnen een paar seconden, gegroepeerd in een issue, en de verantwoordelijken krijgen een 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")

Goed om te weten

  • Handmatige capture op elk platform: captureException, captureMessage, setUser, setTag, addBreadcrumb en captureSecurity voor inlogpogingen.
  • Expo: draai npx expo prebuild of gebruik een development build. Expo Go heeft geen eigen native code, dus JavaScript-fouten worden daar nog gemeld, maar native crashes niet.
  • React Native upgraden vanaf 0.4: verwijder het monitoringpackage van derden dat 0.4 ernaast installeerde en haal de Expo-configplugin ervan weg; dsn() en withIdentity() zijn verdwenen. Flutter vanaf 0.3: verwijder dat package ook uit pubspec.yaml; de level- en user-types zijn nu BlipitLevel en BlipitUser, capture-aanroepen geven het event-id terug als String?, en Blipit.dsn, Blipit.configure en de options:-callback van init zijn verdwenen. Bij beide wordt tracesSampleRate geaccepteerd, maar performance-traces worden in deze versie niet verstuurd.
  • Android upgraden naar v0.5.0 en iOS naar 0.5.0: de meeste apps verhogen alleen de versie. Capture-aanroepen geven het event-id terug als string, het level-type is Blipit's eigen Level, en Blipit.dsn is verdwenen. Op Android zijn configure en apply verwijderd en is de replay-masktag nu blipit-mask. Op iOS is Options Blipit's eigen klasse en werkt beforeSend op het event als dictionary.
  • Storebeoordeling voor de meldmanieren: er is geen nieuwe toestemmingsvraag. iOS gebruikt de schudgebeurtenissen van UIKit (niet CoreMotion) en de screenshotmelding, dus het privacymanifest heeft geen nieuwe regel nodig. Op Android 14 en nieuwer declareert de SDK DETECT_SCREEN_CAPTURE, een normale toestemming die bij installatie wordt gegeven; voor Gegevensveiligheid in Google Play wordt niets nieuws verzameld, want Blipit weet alleen dat er een screenshot is gemaakt en leest die of de galerij nooit. Oudere Android-versies slaan melden via screenshot over. Builds voor Huawei AppGallery werken hetzelfde en gebruiken geen Google Play-services.
  • Controleer de geïnstalleerde versie met npm ls @blipit/react-native (of pnpm list @blipit/react-native). pnpm 11 wacht een dag voordat het een nieuwe release installeert (minimum-release-age), dus op de releasedag installeert pnpm add stilletjes de vorige versie; voor de nieuwe meteen voer je pnpm add @blipit/react-native@<version> --config.minimum-release-age=0 uit.
  • Blipit up-to-date houden: de gids Blipit up-to-date houden (docs.blipit.io/updates) legt de updatebanner uit, de e-mails voor belangrijke releases, de melding in je ontwikkelconsole en het updatecommando voor dit platform.
  • Eén project per app en platform: elk project kiest bij het aanmaken zijn platform (Android, iOS, React Native, Flutter, Web, Backend of Odoo), en Blipit weigert gegevens van elk ander platform met een duidelijke foutmelding. Een iOS-app en een Android-app hebben dus twee projecten met twee sleutels nodig. Releases, versies, crashpercentages en store-builds verschillen per platform, en door ze in één project te mengen klopt geen van die cijfers meer. Een Web-project neemt ook de serverkant van dezelfde web-app aan (de Next.js-server of Node), en een React Native- of Flutter-project ook zijn eigen native Android- en iOS-crashrapporten.

Kom je er niet uit? Mail support@blipit.io. Sleutels en het project-id van elk project staan onder API-sleutels in app.blipit.io.