iOS, Android, Flutter, React Native

Instalar one package per platform

Cada plataforma tiene un paquete de Blipit que recibe la clave pública y el id del proyecto, todos construidos sobre el núcleo propio de Blipit y sin ninguna biblioteca de fallos de terceros dentro: blipit-android v0.7.5, blipit-swift 0.8.0, @blipit/react-native 0.6.3 y blipit_flutter 0.5.3. Los fallos, ANR, bloqueos y excepciones no capturadas se reportan solos: se escriben primero en disco y se envían en el siguiente arranque, y una cola offline guarda los reportes hasta que vuelve la red. Conserva los símbolos de depuración para los fallos nativos, porque los archivos de símbolos aún no se leen.

Copia un prompt para tu asistente de IAPégalo en Claude Code, Cursor o cualquier asistente de programación con IA. Incluye los pasos y el código. En app.blipit.io, en Claves de API, el mismo prompt viene con tu clave ya puesta.
Vídeo: instalar Blipit en cualquier stack, desde 1:56

1Obtén tus claves

Inicia sesión en app.blipit.io y abre Claves API en la barra lateral y luego tu proyecto. Cada proyecto tiene dos claves. La clave pública empieza por blipit_pk_: va en el código del navegador y de las apps, solo puede enviar eventos y cualquiera puede verla sin riesgo. La clave secreta empieza por blipit_sk_: se queda en tu servidor o en Odoo, nunca en un navegador, porque también puede leer y cambiar incidencias. La clave secreta solo se muestra una vez, justo al crearla, así que cópiala entonces; si la pierdes, pulsa Crear una nueva clave secreta y la anterior deja de funcionar al instante. Algunos SDKs también necesitan el id del proyecto, que aparece en la misma página.

Claves API en app.blipit.io: la clave pública (blipit_pk_) para el código del navegador y la clave secreta (blipit_sk_) para servidores y Odoo.
Claves API en app.blipit.io: la clave pública (blipit_pk_) para el código del navegador y la clave secreta (blipit_sk_) para servidores y Odoo.
Una nueva clave secreta se muestra una sola vez. Cópiala ahora: se guarda con hash y no se puede volver a mostrar.
Una nueva clave secreta se muestra una sola vez. Cópiala ahora: se guarda con hash y no se puede volver a mostrar.

2React Native

El paquete enlaza un pequeño módulo nativo que arranca los SDKs propios de Blipit para Android e iOS para los fallos nativos; su archivo de Gradle añade el repositorio de JitPack por su cuenta. Envuelve el componente raíz para que también se reporten los errores de renderizado.

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

Sustituye runApp en main.dart por Blipit.init. El plugin arranca los SDKs propios de Blipit para Android e iOS para los fallos nativos, y los errores del framework de Flutter y los errores asíncronos no capturados se reportan solos.

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

En Xcode, File, Add Package Dependencies, e introduce la URL del repositorio; o añádelo a Package.swift y añade BlipitSwift a tu target. Con CocoaPods, usa el pod BlipitSwift. Luego llama a start una vez al arrancar. Con una clave o un id de proyecto vacíos, start muestra un aviso y devuelve false en lugar de cerrar la 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

Añade JitPack a los repositorios en settings.gradle.kts, la dependencia al módulo de la app, y llama a init en 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"
        }
    }
}

6Dónde va la clave en una app

Las apps incluyen la clave pública y el id del proyecto dentro de la app, y no pasa nada: la clave pública solo puede enviar eventos. Nunca pongas la clave secreta en una app. Pásalas al compilar para que no queden en tu repositorio.

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

7Informes de errores en apps

Llama a showReport desde tu propio menú o activa el botón flotante Informar de un error. El reportador pregunta primero cómo mostrar el problema: hacer una captura, grabar la pantalla (iOS) o solo describirlo. La captura se abre a pantalla completa con las herramientas arriba y abajo, nunca encima; pellizca o toca dos veces para hacer zoom, marca el problema, añade un título y lo que pasó y envía. Los informes llegan a Informes de errores con los datos del dispositivo. React Native necesita react-native-view-shot para las capturas.

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

8Informar desde la pantalla con el error

Una opción Informar de un error en un menú como Perfil captura el menú, no el problema. Active las formas que empiezan en la propia pantalla; todas están desactivadas por defecto y no piden ningún permiso. shakeToReport abre el formulario al agitar el teléfono. screenshotToReport pregunta "¿Informar de un error con esta pantalla?" tras una captura normal y adjunta la captura propia de Blipit (iOS y Android 14 o posterior). twoFingerReport lo abre al mantener pulsado con dos dedos alrededor de un segundo, sin bloquear los toques de la app. reportAfterCrash pregunta qué estaba haciendo la persona en el primer arranque tras un fallo y vincula el informe con ese fallo. screenPicker, activado por defecto, permite a quien abre el formulario desde un menú elegir en cuál de las últimas pantallas está el error: las instantáneas se quedan en la memoria del dispositivo y solo se sube la elegida. Las apps con Jetpack Compose y SwiftUI nombran sus pantallas 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()))),
);

9Botón flotante solo para testers

En app.blipit.io, abra el proyecto y, en los ajustes del botón de informes de errores, ponga Botón flotante en apps móviles en Todos o Solo testers, con un ID de usuario o correo por tester. La app envía la persona que definió con setUser y Blipit solo responde sí o no, así que la lista de testers nunca va dentro de la app. Llamar a showReportButton (showButton en React Native y Flutter) sigue mostrando el botón a todos.

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

10Detectar una app que se queda atascada

Algunos fallos nunca provocan un cierre: la pantalla de inicio sigue girando o el inicio de sesión nunca vuelve. Activa waitForReady y llama a reportReady cuando se muestre la primera pantalla usable. Envuelve flujos como el inicio de sesión con startFlow y endFlow, y marca los pasos con flowStep. Si uno no termina a tiempo, Blipit abre una incidencia Atascada con el último paso y el recorrido anterior. Solo cuenta el tiempo en pantalla, y Blipit fija los límites de tiempo. Los nombres se envían tal cual, así que usa nombres fijos, nunca correos ni otros datos del usuario.

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

11Comprueba que funciona

Abre Incidencias en app.blipit.io. El primer evento aparece en unos segundos, agrupado en una incidencia, y los responsables reciben un correo.

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

Conviene saber

  • Captura manual en todas las plataformas: captureException, captureMessage, setUser, setTag, addBreadcrumb y captureSecurity para intentos de inicio de sesión.
  • Expo: ejecuta npx expo prebuild o usa una development build. Expo Go no tiene código nativo propio, así que allí se siguen reportando los errores de JavaScript pero no los fallos nativos.
  • Si actualizas React Native desde 0.4: desinstala el paquete de monitorización de terceros que 0.4 instalaba junto a él y quita su plugin de configuración de Expo; dsn() y withIdentity() ya no existen. Flutter desde 0.3: quita también ese paquete de pubspec.yaml; los tipos de nivel y de usuario ahora son BlipitLevel y BlipitUser, las llamadas de captura devuelven el id del evento como String?, y Blipit.dsn, Blipit.configure y el callback options: de init ya no existen. En ambos, tracesSampleRate se acepta pero esta versión no envía traces de rendimiento.
  • Si actualizas Android a v0.5.0 e iOS a 0.5.0: la mayoría de las apps solo suben la versión. Las llamadas de captura devuelven el id del evento como string, el tipo de nivel es el Level propio de Blipit y Blipit.dsn ya no existe. En Android, configure y apply se han eliminado y la etiqueta de enmascarado de replay ahora es blipit-mask. En iOS, Options es una clase propia de Blipit y beforeSend trabaja con el evento como diccionario.
  • Revisión de las tiendas para las formas de informar: no hay ninguna solicitud de permiso nueva. iOS usa los eventos de agitar de UIKit (no CoreMotion) y la notificación de captura de pantalla, así que el manifiesto de privacidad no necesita entradas nuevas. En Android 14 o posterior el SDK declara DETECT_SCREEN_CAPTURE, un permiso normal que se concede al instalar; en Seguridad de los datos de Google Play no se recoge nada nuevo, porque Blipit solo sabe que se hizo una captura y nunca la lee ni lee la galería. Las versiones anteriores de Android omiten informar con captura. Las compilaciones para Huawei AppGallery funcionan igual y no usan servicios de Google Play.
  • Comprueba la versión instalada con npm ls @blipit/react-native (o pnpm list @blipit/react-native). pnpm 11 espera un día antes de instalar una versión nueva (minimum-release-age), así que el día del lanzamiento pnpm add instala sin avisar la versión anterior; para obtener la nueva enseguida, ejecuta pnpm add @blipit/react-native@<version> --config.minimum-release-age=0.
  • Mantener Blipit actualizado: la guía Mantener Blipit actualizado (docs.blipit.io/updates) explica el banner de actualización, los correos para versiones importantes, el aviso en tu consola de desarrollo y el comando de actualización para esta plataforma.
  • Un proyecto por app y plataforma: cada proyecto elige su plataforma al crearse (Android, iOS, React Native, Flutter, Web, Backend u Odoo) y Blipit rechaza con un error claro los datos de cualquier otra plataforma, así que una app de iOS y una de Android necesitan dos proyectos con dos claves. Las versiones, las compilaciones, las tasas de fallos y las builds de tienda son distintas en cada plataforma, y mezclarlas en un proyecto hace que todas sean incorrectas. Un proyecto Web también acepta la parte de servidor de la misma app web (el servidor de Next.js o Node), y un proyecto de React Native o Flutter también acepta sus propios informes de fallos nativos de Android e iOS.

¿Atascado? Escribe a support@blipit.io. Las claves y el id de cada proyecto están en Claves API en app.blipit.io.