Instalar por plataforma
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.
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.
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.
npm install @blipit/react-native
npx pod-installimport * 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.
flutter pub add blipit_flutterimport '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(url: "https://github.com/blipit-io/blipit-swift", from: "0.8.0")pod "BlipitSwift", "~> 0.8.0"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.
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven("https://jitpack.io")
}
}implementation("com.github.blipit-io:blipit-android:v0.7.5")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 run --dart-define=BLIPIT_KEY=blipit_pk_your_public_key --dart-define=BLIPIT_PROJECT=12const key = String.fromEnvironment('BLIPIT_KEY');
const project = int.fromEnvironment('BLIPIT_PROJECT');EXPO_PUBLIC_BLIPIT_KEY=blipit_pk_your_public_key
EXPO_PUBLIC_BLIPIT_PROJECT=12buildConfigField("String", "BLIPIT_KEY", "\"${project.findProperty("blipitKey")}\"")BLIPIT_KEY = blipit_pk_your_public_key7Informes 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.
import * as Blipit from "@blipit/react-native";
export default function Root() {
return (
<Blipit.BlipitReporter showButton>
<App />
</Blipit.BlipitReporter>
);
}
Blipit.showReport();appRunner: () => runApp(const BlipitReporter(showButton: true, child: MyApp())),
Blipit.showReport();Blipit.showReportButton()
Blipit.showReport()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.
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")
}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") }Blipit.init({
key: "<public key>",
project: <project id>,
shakeToReport: true,
screenshotToReport: true,
twoFingerReport: true,
reportAfterCrash: true,
});
<NavigationContainer ref={navigation} onReady={() => Blipit.trackNavigation(navigation)}>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()))),
);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.
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")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")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");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.
Blipit.captureMessage("Hello from React Native");await Blipit.captureMessage('Hello from Flutter');Blipit.captureMessage("Hello from iOS")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.

