SDK Flutter

🎫 Récupère ton token

Pionne est mobile-first : tu génères ton token depuis l’app mobile Pionne.

1. Télécharge sur App Store (à venir) / Google Play
2. Crée ton compte (30 jours gratuits, carte non requise)
3. + Nouveau projet → choisis Flutter → copie le pio_live_…

Le SDK Pionne pour Flutter. Auto-capture les erreurs FlutterError, les exceptions async via Zone, et enrichit chaque event avec le contexte device.

Astuce

Disponible sur pub.dev.

Tu peux ajouter pionne_flutter directement à ton pubspec.yaml, ou l’installer depuis le repo GitHub si tu veux suivre une version de dev.

Installation

pub.dev

pubspec.yaml

dependencies:
  pionne_flutter: ^0.3.3

flutter pub get

Git (maintenant)

pubspec.yaml

dependencies:
  pionne_flutter:
    git:
      url: https://github.com/agkgcreations/pionne-flutter
      ref: main

flutter pub get

Quickstart

import 'package:flutter/material.dart';
import 'package:pionne_flutter/pionne_flutter.dart';

void main() {
  Pionne.init(
    token: 'pio_live_xxx',
    release: '1.0.0',
    environment: 'production',
  );
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) => const MaterialApp(home: MyHome());
}

Astuce

Pionne.init() est idempotent et safe au hot restart. Tu peux relancer ton app dans le simulateur sans craindre de doublons d’events.

Auto-capture

• FlutterError.onError — erreurs du framework Flutter (build, layout, paint)
• Zone runner (via runZonedGuarded) — exceptions Dart async non capturées
• PlatformDispatcher.instance.onError (Flutter 3.3+) — erreurs côté Dart non capturées par Flutter

Capture des crashs natifs

Les handlers Dart ne voient que les crashs de l’isolate Dart. Un crash natif détruit tout le process avant qu’aucun Dart ne tourne. Depuis 0.4.0, le SDK embarque du code natif iOS + Android qui les enregistre via l’OS et les rejoue en événements fatal au lancement suivant.

Activé par défaut. Pour désactiver :

Pionne.init(PionneOptions(
  token: 'pio_live_…',
  captureNativeCrashes: false,
));

Ce qui est capturé sur iOS 14+

Via MetricKit (MXCrashDiagnostic) :

• NSException Objective-C / Swift — nom de l’exception + message composé sur iOS 17+ (ex. NSInvalidArgumentException)
• Signaux — SIGSEGV, SIGABRT, SIGBUS, SIGILL, SIGFPE, SIGTRAP
• Kills mémoire (OOM) et terminations watchdog (0x8badf00d)
• Call stack tree — frames système symbolisées par l’OS ; frames app sous forme binaryName 0xADDRESS

Ce qui est capturé sur Android 11+

Via ActivityManager.getHistoricalProcessExitReasons() :

• REASON_CRASH — exception JVM non catchée
• REASON_CRASH_NATIVE — crash natif NDK (C/C++)
• REASON_ANR — Application Not Responding (avec la trace ANR)
• REASON_LOW_MEMORY — kill mémoire (OOM)

Rebuild du plugin requis à l'upgrade

0.4.0 transforme le package, jusque-là pur Dart, en Flutter Plugin qui embarque du code natif. Après upgrade depuis 0.3.x, lance flutter clean && flutter pub get puis rebuild l’app (flutter run / flutter build) pour que le côté natif soit lié. Sur la cible web — ou tout build sans le plugin natif compilé — l’option est silencieusement ignorée.

Les crashs natifs arrivent au lancement qui suit le crash (l’OS les livre post-mortem), avec mechanism.type = "native" et un tag native.source (metrickit sur iOS, app_exit sur Android).

Auto-context

• Platform.operatingSystem — ios, android, linux, etc.
• Platform.operatingSystemVersion — version OS
• package_info_plus — version d’app, build number, package name (peer dep optionnelle)
• device_info_plus — modèle, manufacturer (peer dep optionnelle)

Capture manuelle

try {
  await fetchData();
} catch (error, stackTrace) {
  await Pionne.captureException(
    error,
    stackTrace: stackTrace,
    tags: {'feature': 'sync'},
    contexts: {'sync': {'retry': 2}},
  );
}

API

Pionne.init(token: '…', release: '…', environment: '…');
Pionne.captureException(error, stackTrace: stack, tags: {});
Pionne.captureMessage('Cache miss', level: PionneLevel.warning);
Pionne.setUser(id: 'user_42');
Pionne.setTags({'region': 'eu'});
Pionne.setEnabled(false);
Pionne.addBreadcrumb(category: 'navigation', message: '/checkout');

Plateformes supportées

Plateforme	Statut
iOS	Supporté
Android	Supporté
Web	Supporté
macOS	Supporté
Windows	Supporté
Linux	Supporté

Source maps / obfuscation

Attention

La symbolication des stacks Dart obfuscés (via --obfuscate --split-debug-info) est plus complexe que pour JS — il faut uploader les fichiers .symbols générés par Flutter. Cette feature arrive en V1.1.

En attendant, build sans --obfuscate pour avoir des stacks lisibles, ou symbolicate manuellement via flutter symbolize.

Géographie (opt-in)

Pionne peut afficher la ville/région/pays approximatif de l’utilisateur sur chaque event. Désactivé par défaut pour la vie privée.

Pionne.init(PionneOptions(
  token: 'pio_live_xxx',
  sendGeography: true, // ← opt-in
));

Au démarrage, un seul appel HTTP vers https://ipapi.co/json/ (timeout 4 s) résout contexts.geo = { city, region, country, country_code } qui est attaché à tous les events suivants. Aucune permission iOS/Android requise (pas de GPS, juste l’inverse-DNS de l’IP). Si le lookup échoue, le SDK continue sans géo.

Pour un fournisseur custom : geographyEndpoint: 'https://geo.tonapi.com/'.

Anti-token-theft

Le package_name (par exemple com.tonapp.app) est auto-pinné côté serveur au premier event. Si ton token fuite et qu’il est utilisé depuis une autre app, les events sont rejetés.

Voir aussi

• Index des SDKs — tous les SDKs Pionne
• API Ingest — protocole HTTP brut