iOS, Android, Flutter, React Native

Installation one package per platform

Chaque plateforme a un paquet Blipit qui prend la clé publique et l'identifiant de projet, tous construits sur le cœur de Blipit sans aucune bibliothèque de crash tierce : blipit-android v0.7.5, blipit-swift 0.8.0, @blipit/react-native 0.6.3 et blipit_flutter 0.5.3. Les crashs, ANR, blocages et exceptions non interceptées sont signalés d'eux-mêmes, écrits d'abord sur disque et envoyés au lancement suivant, et une file hors ligne garde les rapports jusqu'au retour du réseau. Conservez les symboles de débogage pour les crashs natifs, car les fichiers de symboles ne sont pas encore lus.

Copier un prompt pour votre assistant IACollez-le dans Claude Code, Cursor ou tout autre assistant de code IA. Il contient les étapes et le code. Dans app.blipit.io, sous Clés API, le même prompt est fourni avec votre clé déjà renseignée.
Vidéo : installer Blipit dans n'importe quel stack, à partir de 1:56

1Obtenir vos clés

Connectez-vous sur app.blipit.io et ouvrez Clés API dans la barre latérale, puis votre projet. Chaque projet a deux clés. La clé publique commence par blipit_pk_ : elle va dans le code navigateur et applicatif, ne peut qu'envoyer des événements et peut être vue par n'importe qui sans risque. La clé secrète commence par blipit_sk_ : elle reste sur votre serveur ou dans Odoo, jamais dans un navigateur, car elle peut aussi lire et modifier les problèmes. La clé secrète n'est affichée qu'une fois, juste après sa création, alors copiez-la à ce moment-là ; si vous la perdez, appuyez sur Créer une nouvelle clé secrète, et l'ancienne cesse aussitôt de fonctionner. Certains SDK ont aussi besoin de l'identifiant de projet, affiché sur la même page.

Clés API dans app.blipit.io : la clé publique (blipit_pk_) pour le code navigateur et la clé secrète (blipit_sk_) pour les serveurs et Odoo.
Clés API dans app.blipit.io : la clé publique (blipit_pk_) pour le code navigateur et la clé secrète (blipit_sk_) pour les serveurs et Odoo.
Une nouvelle clé secrète n'est affichée qu'une fois. Copiez-la maintenant : elle est stockée sous forme de hash et ne peut plus être affichée.
Une nouvelle clé secrète n'est affichée qu'une fois. Copiez-la maintenant : elle est stockée sous forme de hash et ne peut plus être affichée.

2React Native

Le paquet lie un petit module natif qui démarre les SDK Android et iOS de Blipit pour les crashs natifs ; son fichier Gradle ajoute lui-même le dépôt JitPack. Enveloppez le composant racine pour que les erreurs de rendu soient aussi signalées.

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

Remplacez runApp dans main.dart par Blipit.init. Le plugin démarre les SDK Android et iOS de Blipit pour les crashs natifs, et les erreurs du framework Flutter et les erreurs async non interceptées sont signalées d'elles-mêmes.

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

Dans Xcode, File, Add Package Dependencies, puis saisissez l'URL du dépôt ; ou ajoutez-le à Package.swift et ajoutez BlipitSwift à votre target. Avec CocoaPods, utilisez le pod BlipitSwift. Appelez ensuite start une fois au lancement. Avec une clé ou un identifiant de projet vide, start affiche un avertissement et renvoie false au lieu de faire planter l'application.

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

Ajoutez JitPack aux repositories dans settings.gradle.kts, la dépendance au module app, et appelez init dans 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"
        }
    }
}

6Où placer la clé dans une application

Les applications embarquent la clé publique et l'identifiant de projet, ce qui ne pose aucun problème : la clé publique ne peut qu'envoyer des événements. Ne mettez jamais la clé secrète dans une application. Transmettez-les au moment du build pour qu'elles restent hors de votre dépôt.

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

7Rapports de bugs dans les applications

Appelez showReport depuis votre propre menu, ou activez le bouton flottant Signaler un bug. Le rapporteur demande d'abord comment montrer le problème : prendre une capture, enregistrer l'écran (iOS) ou simplement le décrire. La capture s'ouvre en plein écran avec les outils au-dessus et en dessous, jamais dessus ; pincez ou touchez deux fois pour zoomer, marquez le problème, ajoutez un titre et ce qui s'est passé, puis envoyez. Les rapports arrivent dans Rapports de bugs avec les détails de l'appareil. React Native a besoin de react-native-view-shot pour les captures.

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

8Signaler depuis l’écran qui a le bug

Une entrée Signaler un bug dans un menu comme Profil capture le menu, pas le problème. Activez les moyens qui partent de l’écran lui-même ; tous sont désactivés par défaut et ne demandent aucune autorisation. shakeToReport ouvre le formulaire quand on secoue le téléphone. screenshotToReport demande « Signaler un bug avec cet écran ? » après une capture d’écran normale et joint la capture propre à Blipit (iOS, et Android 14 et plus récent). twoFingerReport l’ouvre après un appui long d’environ une seconde à deux doigts, sans bloquer les gestes de l’app. reportAfterCrash demande ce que la personne faisait au premier lancement après un plantage et relie le rapport à ce plantage. screenPicker, activé par défaut, permet à qui ouvre le formulaire depuis un menu de choisir sur lequel des derniers écrans se trouve le bug : les captures restent dans la mémoire de l’appareil et seule celle choisie est envoyée. Les apps Jetpack Compose et SwiftUI nomment leurs écrans avec 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()))),
);

9Bouton flottant pour les testeurs uniquement

Dans app.blipit.io, ouvrez le projet et, dans les réglages du bouton de rapport de bug, réglez Bouton flottant dans les apps mobiles sur Tout le monde ou Testeurs uniquement, avec un identifiant ou un e-mail par testeur. L’app envoie la personne définie avec setUser et Blipit répond seulement oui ou non, si bien que la liste des testeurs n’est jamais livrée dans l’app. Appeler showReportButton (showButton sous React Native et Flutter) affiche toujours le bouton pour tout le monde.

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

10Repérer une app qui reste bloquée

Certaines pannes ne plantent jamais : l'écran de démarrage tourne sans fin, ou la connexion ne revient jamais. Activez waitForReady et appelez reportReady dès que le premier écran utilisable s'affiche. Encadrez les parcours comme la connexion avec startFlow et endFlow, et marquez les étapes avec flowStep. Si l'un d'eux ne se termine pas à temps, Blipit ouvre un incident Bloquée avec la dernière étape et le fil qui la précède. Seul le temps à l'écran compte, et Blipit fixe les délais. Les noms sont envoyés tels quels : utilisez des noms fixes, jamais d'e-mails ni d'autres données utilisateur.

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

11Vérifier que ça fonctionne

Ouvrez Problèmes dans app.blipit.io. Le premier événement apparaît en quelques secondes, regroupé en un problème, et les responsables reçoivent un 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")

Bon à savoir

  • Capture manuelle sur chaque plateforme : captureException, captureMessage, setUser, setTag, addBreadcrumb et captureSecurity pour les tentatives de connexion.
  • Expo : lancez npx expo prebuild ou utilisez un development build. Expo Go n'a pas de code natif personnalisé : les erreurs JavaScript y sont toujours signalées, mais pas les crashs natifs.
  • Mise à jour de React Native depuis 0.4 : désinstallez le paquet de monitoring tiers que 0.4 installait à côté et retirez son plugin de configuration Expo ; dsn() et withIdentity() ont disparu. Flutter depuis 0.3 : retirez aussi ce paquet de pubspec.yaml ; les types de niveau et d'utilisateur sont désormais BlipitLevel et BlipitUser, les appels de capture renvoient l'identifiant de l'événement en String?, et Blipit.dsn, Blipit.configure et le callback options: de init ont disparu. Sur les deux, tracesSampleRate est accepté mais les traces de performance ne sont pas envoyées dans cette version.
  • Mise à jour d'Android vers v0.5.0 et d'iOS vers 0.5.0 : la plupart des applications changent seulement la version. Les appels de capture renvoient l'identifiant de l'événement sous forme de chaîne, le type de niveau est le Level propre à Blipit, et Blipit.dsn a disparu. Sur Android, configure et apply sont supprimés et le tag de masquage du replay est désormais blipit-mask. Sur iOS, Options est la classe propre à Blipit et beforeSend travaille sur l'événement sous forme de dictionnaire.
  • Validation des stores pour les moyens de signaler : aucune nouvelle demande d’autorisation. iOS utilise les événements de secousse d’UIKit (pas CoreMotion) et la notification de capture d’écran, donc le manifeste de confidentialité n’a besoin d’aucune nouvelle entrée. Sous Android 14 et plus récent, le SDK déclare DETECT_SCREEN_CAPTURE, une autorisation normale accordée à l’installation ; pour la Sécurité des données de Google Play, rien de nouveau n’est collecté, car Blipit sait seulement qu’une capture a été prise et ne la lit jamais, ni la galerie. Les versions plus anciennes d’Android ignorent le signalement par capture. Les builds Huawei AppGallery se comportent de la même façon et n’utilisent aucun service Google Play.
  • Vérifiez la version installée avec npm ls @blipit/react-native (ou pnpm list @blipit/react-native). pnpm 11 attend un jour avant d'installer une nouvelle version (minimum-release-age) : le jour de la sortie, pnpm add installe donc sans prévenir la version précédente ; pour obtenir la nouvelle tout de suite, lancez pnpm add @blipit/react-native@<version> --config.minimum-release-age=0.
  • Garder Blipit à jour : le guide Garder Blipit à jour (docs.blipit.io/updates) explique la bannière de mise à jour, les e-mails pour les versions importantes, l'avis dans votre console de développement et la commande de mise à jour pour cette plateforme.
  • Un projet par application et par plateforme : chaque projet choisit sa plateforme à sa création (Android, iOS, React Native, Flutter, Web, Backend ou Odoo), et Blipit refuse avec une erreur claire les données de toute autre plateforme. Une app iOS et une app Android ont donc besoin de deux projets avec deux clés. Les releases, les versions, les taux de plantage et les builds des stores diffèrent selon la plateforme, et les mélanger dans un projet les rend tous faux. Un projet Web accepte aussi la partie serveur de la même app web (le serveur Next.js ou Node), et un projet React Native ou Flutter accepte aussi ses propres rapports de plantage natifs Android et iOS.

Bloqué ? Écrivez à support@blipit.io. Les clés et l'identifiant de chaque projet sont sous Clés API dans app.blipit.io.