iOS, Android, Flutter, React Native

Installazione one package per platform

Ogni piattaforma ha un pacchetto Blipit che accetta la chiave pubblica e l'id del progetto, tutti costruiti sul core di Blipit senza alcuna libreria di crash di terze parti al loro interno: blipit-android v0.7.5, blipit-swift 0.8.0, @blipit/react-native 0.6.3 e blipit_flutter 0.5.3. Crash, ANR, blocchi ed eccezioni non catturate vengono segnalati da soli, scritti prima su disco e inviati all'avvio successivo, e una coda offline conserva i report finché la rete non torna. Conserva i simboli di debug per i crash nativi, perché i file di simboli non vengono ancora letti.

Copia un prompt per il tuo assistente IAIncollalo in Claude Code, Cursor o in qualsiasi assistente di programmazione IA. Contiene i passaggi e il codice. In app.blipit.io, in Chiavi API, lo stesso prompt ha già la tua chiave inserita.
Video: installare Blipit in qualsiasi stack, da 1:56

1Ottieni le chiavi

Accedi su app.blipit.io e apri Chiavi API nella barra laterale, poi il tuo progetto. Ogni progetto ha due chiavi. La chiave pubblica inizia con blipit_pk_: va nel codice del browser e delle app, può solo inviare eventi e chiunque può vederla senza rischi. La chiave segreta inizia con blipit_sk_: resta sul tuo server o in Odoo, mai in un browser, perché può anche leggere e modificare le issue. La chiave segreta viene mostrata una sola volta, subito dopo la creazione, quindi copiala in quel momento; se la perdi, premi Crea una nuova chiave segreta e quella vecchia smette subito di funzionare. Alcuni SDK richiedono anche l'id del progetto, mostrato nella stessa pagina.

Chiavi API su app.blipit.io: la chiave pubblica (blipit_pk_) per il codice del browser e la chiave segreta (blipit_sk_) per i server e Odoo.
Chiavi API su app.blipit.io: la chiave pubblica (blipit_pk_) per il codice del browser e la chiave segreta (blipit_sk_) per i server e Odoo.
Una nuova chiave segreta viene mostrata una sola volta. Copiala subito: viene salvata come hash e non può essere mostrata di nuovo.
Una nuova chiave segreta viene mostrata una sola volta. Copiala subito: viene salvata come hash e non può essere mostrata di nuovo.

2React Native

Il pacchetto collega un piccolo modulo nativo che avvia gli SDK Android e iOS di Blipit per i crash nativi; il suo file Gradle aggiunge da solo il repository JitPack. Avvolgi il componente radice così vengono segnalati anche gli errori di rendering.

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

Sostituisci runApp in main.dart con Blipit.init. Il plugin avvia gli SDK Android e iOS di Blipit per i crash nativi, e gli errori del framework Flutter e gli errori async non catturati vengono segnalati da soli.

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

In Xcode, File, Add Package Dependencies, e inserisci l'URL del repository; oppure aggiungilo a Package.swift e aggiungi BlipitSwift al tuo target. Con CocoaPods, usa il pod BlipitSwift. Poi chiama start una volta all'avvio. Con una chiave o un id progetto vuoti, start stampa un avviso e restituisce false invece di far crashare l'app.

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

Aggiungi JitPack ai repository in settings.gradle.kts, la dipendenza al modulo app, e chiama init 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"
        }
    }
}

6Dove va la chiave in un'app

Le app includono la chiave pubblica e l'id del progetto, e va bene così: la chiave pubblica può solo inviare eventi. Non mettere mai la chiave segreta in un'app. Passale in fase di build, così restano fuori dal tuo repository.

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

7Segnalazioni di bug nelle app

Chiama showReport da una voce di menu della tua app, oppure attiva il pulsante fluttuante Segnala un bug. Lo strumento chiede prima come mostrare il problema: fare uno screenshot, registrare lo schermo (iOS) o solo descriverlo. Lo screenshot si apre a schermo intero con gli strumenti sopra e sotto, mai sopra l'immagine; pizzica o tocca due volte per lo zoom, segna il problema, aggiungi un titolo e cosa è successo e invia. Le segnalazioni arrivano in Segnalazioni di bug con i dati del dispositivo. React Native richiede react-native-view-shot per gli screenshot.

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

8Segnala dalla schermata con il bug

Una voce Segnala un bug in un menu come Profilo cattura il menu, non il problema. Attivi i modi che partono dalla schermata stessa; sono tutti disattivati di default e non chiedono alcun permesso. shakeToReport apre il modulo quando si scuote il telefono. screenshotToReport chiede "Segnalare un bug con questa schermata?" dopo un normale screenshot e allega la cattura di Blipit (iOS e Android 14 o successivo). twoFingerReport lo apre dopo una pressione prolungata di circa un secondo con due dita, senza bloccare i tocchi dell’app. reportAfterCrash chiede cosa stava facendo la persona al primo avvio dopo un crash e collega la segnalazione a quel crash. screenPicker, attivo di default, permette a chi apre il modulo da un menu di scegliere in quale delle ultime schermate si trova il bug: le istantanee restano nella memoria del dispositivo e viene caricata solo quella scelta. Le app Jetpack Compose e SwiftUI danno un nome alle schermate con 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()))),
);

9Pulsante mobile solo per i tester

In app.blipit.io apra il progetto e, nelle impostazioni del pulsante di segnalazione, imposti Pulsante mobile nelle app per telefono su Tutti o Solo tester, con un ID utente o un’email per tester. L’app invia la persona impostata con setUser e Blipit risponde solo sì o no, quindi l’elenco dei tester non viene mai incluso nell’app. Chiamare showReportButton (showButton su React Native e Flutter) mostra ancora il pulsante a tutti.

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

10Accorgersi di un'app che si blocca

Alcuni guasti non causano mai un crash: la schermata iniziale continua a girare o l'accesso non torna mai. Attiva waitForReady e chiama reportReady appena compare la prima schermata utilizzabile. Racchiudi flussi come l'accesso tra startFlow ed endFlow e segna i passi con flowStep. Se uno non termina in tempo, Blipit apre un problema Bloccata con l'ultimo passo e il percorso precedente. Conta solo il tempo sullo schermo, e i limiti di tempo li stabilisce Blipit. I nomi vengono inviati così come sono scritti: usa nomi fissi, mai email o altri dati dell'utente.

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

11Verifica che funzioni

Apri Issue in app.blipit.io. Il primo evento compare entro pochi secondi, raggruppato in una issue, e i responsabili ricevono un'email.

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

Buono a sapersi

  • Cattura manuale su ogni piattaforma: captureException, captureMessage, setUser, setTag, addBreadcrumb e captureSecurity per i tentativi di accesso.
  • Expo: esegui npx expo prebuild o usa una development build. Expo Go non ha codice nativo personalizzato, quindi lì gli errori JavaScript vengono comunque segnalati ma i crash nativi no.
  • Aggiornamento di React Native dalla 0.4: disinstalla il pacchetto di monitoraggio di terze parti che la 0.4 installava insieme e rimuovi il suo config plugin Expo; dsn() e withIdentity() non esistono più. Flutter dalla 0.3: rimuovi quel pacchetto anche da pubspec.yaml; i tipi di livello e utente ora sono BlipitLevel e BlipitUser, le chiamate di cattura restituiscono l'id dell'evento come String?, e Blipit.dsn, Blipit.configure e il callback options: di init non esistono più. Su entrambi, tracesSampleRate è accettato ma in questa versione le trace di performance non vengono inviate.
  • Aggiornamento di Android alla v0.5.0 e iOS alla 0.5.0: la maggior parte delle app aggiorna solo la versione. Le chiamate di cattura restituiscono l'id dell'evento come stringa, il tipo di livello è Level di Blipit e Blipit.dsn non esiste più. Su Android, configure e apply sono stati rimossi e il tag di mascheramento del replay ora è blipit-mask. Su iOS, Options è una classe di Blipit e beforeSend lavora sull'evento come dizionario.
  • Revisione degli store per i modi di segnalare: nessuna nuova richiesta di permesso. iOS usa gli eventi di scuotimento di UIKit (non CoreMotion) e la notifica di screenshot, quindi il privacy manifest non richiede nuove voci. Su Android 14 o successivo l’SDK dichiara DETECT_SCREEN_CAPTURE, un permesso normale concesso all’installazione; per la Sicurezza dei dati di Google Play non viene raccolto nulla di nuovo, perché Blipit sa solo che è stato fatto uno screenshot e non lo legge mai, né legge la galleria. Le versioni precedenti di Android saltano la segnalazione con screenshot. Le build per Huawei AppGallery si comportano allo stesso modo e non usano i servizi Google Play.
  • Controlla la versione installata con npm ls @blipit/react-native (o pnpm list @blipit/react-native). pnpm 11 aspetta un giorno prima di installare una nuova versione (minimum-release-age), quindi il giorno del rilascio pnpm add installa in silenzio la versione precedente; per avere subito quella nuova esegui pnpm add @blipit/react-native@<version> --config.minimum-release-age=0.
  • Tenere Blipit aggiornato: la guida Tenere Blipit aggiornato (docs.blipit.io/updates) spiega il banner di aggiornamento, le email per le versioni importanti, l'avviso nella console di sviluppo e il comando di aggiornamento per questa piattaforma.
  • Un progetto per app e piattaforma: ogni progetto sceglie la sua piattaforma quando viene creato (Android, iOS, React Native, Flutter, Web, Backend o Odoo) e Blipit rifiuta con un errore chiaro i dati di qualsiasi altra piattaforma, quindi un'app iOS e un'app Android hanno bisogno di due progetti con due chiavi. Release, versioni, tassi di crash e build per gli store sono diversi per ogni piattaforma, e mescolarli in un progetto li rende tutti sbagliati. Un progetto Web accetta anche la parte server della stessa app web (il server Next.js o Node), e un progetto React Native o Flutter accetta anche i propri crash nativi Android e iOS.

Bloccato? Scrivi a support@blipit.io. Le chiavi e l'id di ogni progetto sono sotto Chiavi API in app.blipit.io.