SDK Flutter

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

Installation

pub.dev
Git (maintenant)

dependencies:
  pionne_flutter: ^0.3.3

flutter pub get

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

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 natives non capturées par Flutter

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

Géographie (opt-in)

Comme Sentry, 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