iOS, Android, Flutter, React Native

Instalar one package per platform

Cada plataforma tem um pacote Blipit que recebe a chave pública e o id do projeto, todos construídos sobre o núcleo próprio do Blipit, sem nenhuma biblioteca de falhas de terceiros dentro: blipit-android v0.7.5, blipit-swift 0.8.0, @blipit/react-native 0.6.3 e blipit_flutter 0.5.3. Falhas, ANRs, travamentos e exceções não capturadas são reportados por conta própria, gravados primeiro no disco e enviados na próxima abertura, e uma fila offline guarda os relatórios até a rede voltar. Guarde os símbolos de depuração para falhas nativas, já que arquivos de símbolos ainda não são lidos.

Copie um prompt para o seu assistente de IACole-o no Claude Code, no Cursor ou em qualquer assistente de programação com IA. Inclui os passos e o código. Em app.blipit.io, em Chaves de API, o mesmo prompt já vem com a sua chave preenchida.
Vídeo: instalar o Blipit em qualquer stack, a partir de 1:56

1Obtenha suas chaves

Entre no app.blipit.io e abra Chaves de API na barra lateral, depois o seu projeto. Cada projeto tem duas chaves. A chave pública começa com blipit_pk_: ela vai no código do navegador e do app, só pode enviar eventos e é segura para qualquer pessoa ver. A chave secreta começa com blipit_sk_: ela fica no seu servidor ou no Odoo, nunca em um navegador, porque também pode ler e alterar problemas. A chave secreta é exibida uma única vez, logo depois de criada, então copie-a nesse momento; se você a perder, clique em Criar uma nova chave secreta, e a antiga para de funcionar na hora. Alguns SDKs também precisam do id do projeto, exibido na mesma página.

Chaves de API no app.blipit.io: a chave pública (blipit_pk_) para código de navegador e a chave secreta (blipit_sk_) para servidores e o Odoo.
Chaves de API no app.blipit.io: a chave pública (blipit_pk_) para código de navegador e a chave secreta (blipit_sk_) para servidores e o Odoo.
Uma nova chave secreta é exibida uma única vez. Copie-a agora: ela é armazenada com hash e não pode ser exibida novamente.
Uma nova chave secreta é exibida uma única vez. Copie-a agora: ela é armazenada com hash e não pode ser exibida novamente.

2React Native

O pacote vincula um pequeno módulo nativo que inicia os SDKs próprios do Blipit para Android e iOS para falhas nativas; o arquivo Gradle dele adiciona o repositório JitPack sozinho. Envolva o componente raiz para que erros de renderização também sejam reportados.

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

Substitua runApp no main.dart por Blipit.init. O plugin inicia os SDKs próprios do Blipit para Android e iOS para falhas nativas, e erros do framework Flutter e erros assíncronos não capturados são reportados por conta própria.

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)

No Xcode, File, Add Package Dependencies, e digite a URL do repositório; ou adicione-o ao Package.swift e adicione BlipitSwift ao seu target. Com CocoaPods, use o pod BlipitSwift. Depois chame start uma vez na abertura. Com uma chave ou um id de projeto vazio, start exibe um aviso e retorna false em vez de travar o 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

Adicione o JitPack aos repositories em settings.gradle.kts, a dependência ao módulo do app, e chame init em 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"
        }
    }
}

6Onde a chave fica em um app

Os apps levam a chave pública e o id do projeto dentro do app, e não há problema nisso: a chave pública só pode enviar eventos. Nunca coloque a chave secreta em um app. Passe-as no momento do build para que fiquem fora do seu repositório.

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

7Relatórios de bugs em apps

Chame showReport a partir de um item de menu seu, ou ative o botão flutuante Reportar um bug. O relator pergunta primeiro como mostrar o problema: tirar uma captura, gravar a tela (iOS) ou só descrever. A captura abre em tela cheia com as ferramentas acima e abaixo, nunca por cima; faça pinça ou toque duas vezes para ampliar, marque o problema, adicione um título e o que aconteceu e envie. Os relatos chegam em Relatos de bugs com os dados do aparelho. React Native precisa de react-native-view-shot para 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()

8Reporte a partir da tela com o erro

Um item Reportar um erro num menu como Perfil captura o menu, não o problema. Ative as formas que começam na própria tela; todas vêm desativadas e não pedem permissão. shakeToReport abre o formulário quando o celular é sacudido. screenshotToReport pergunta "Reportar um erro com esta tela?" depois de uma captura de tela normal e anexa a captura própria do Blipit (iOS e Android 14 ou mais recente). twoFingerReport abre o formulário após um toque longo de cerca de um segundo com dois dedos, sem bloquear os toques do app. reportAfterCrash pergunta o que a pessoa estava fazendo na primeira abertura depois de uma falha e liga o relatório a essa falha. screenPicker, ativado por padrão, deixa quem abre o formulário por um menu escolher em qual das últimas telas está o erro: as capturas ficam na memória do aparelho e só a escolhida é enviada. Apps com Jetpack Compose e SwiftUI dão nome às telas com 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ão flutuante só para testadores

No app.blipit.io, abra o projeto e, nas configurações do botão de relatório de erros, defina Botão flutuante nos apps de celular como Todos ou Somente testadores, com um ID de usuário ou e-mail por testador. O app envia a pessoa definida com setUser e o Blipit responde só sim ou não, então a lista de testadores nunca vai dentro do app. Chamar showReportButton (showButton no React Native e no Flutter) continua mostrando o botão para 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));

10Detetar um app que fica travado

Algumas falhas nunca causam um crash: a tela de abertura continua girando ou o login nunca volta. Ative waitForReady e chame reportReady quando a primeira tela utilizável aparecer. Envolva fluxos como o login com startFlow e endFlow e marque os passos com flowStep. Se um deles não terminar a tempo, o Blipit abre um problema Travada com o último passo e o rastro anterior. Só conta o tempo na tela, e o Blipit define os limites de tempo. Os nomes são enviados como escritos, então use nomes fixos, nunca e-mails ou outros dados do usuário.

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

11Confira se funciona

Abra Problemas em app.blipit.io. O primeiro evento aparece em alguns segundos, agrupado em um problema, e os responsáveis recebem um e-mail.

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

Bom saber

  • Captura manual em todas as plataformas: captureException, captureMessage, setUser, setTag, addBreadcrumb e captureSecurity para tentativas de login.
  • Expo: rode npx expo prebuild ou use um development build. O Expo Go não tem código nativo personalizado, então os erros de JavaScript continuam sendo reportados lá, mas as falhas nativas não.
  • Atualizando o React Native da 0.4: desinstale o pacote de monitoramento de terceiros que a 0.4 instalava junto e remova o config plugin do Expo dele; dsn() e withIdentity() foram removidos. Flutter da 0.3: remova esse pacote do pubspec.yaml também; os tipos de nível e de usuário agora são BlipitLevel e BlipitUser, as chamadas de captura retornam o id do evento como String?, e Blipit.dsn, Blipit.configure e o callback options: de init foram removidos. Nos dois, tracesSampleRate é aceito, mas traces de desempenho não são enviados nesta versão.
  • Atualizando o Android para v0.5.0 e o iOS para 0.5.0: a maioria dos apps só precisa subir a versão. As chamadas de captura retornam o id do evento como string, o tipo de nível é o Level próprio do Blipit, e Blipit.dsn foi removido. No Android, configure e apply foram removidos e a tag de máscara do replay agora é blipit-mask. No iOS, Options é uma classe própria do Blipit e beforeSend trabalha com o evento como um dicionário.
  • Revisão das lojas para as formas de reportar: não há nenhum pedido de permissão novo. O iOS usa os eventos de sacudir do UIKit (não CoreMotion) e a notificação de captura de tela, então o manifesto de privacidade não precisa de nenhuma entrada nova. No Android 14 ou mais recente o SDK declara DETECT_SCREEN_CAPTURE, uma permissão normal concedida na instalação; na Segurança dos dados do Google Play nada novo é coletado, porque o Blipit só sabe que uma captura foi feita e nunca a lê nem lê a galeria. Versões mais antigas do Android pulam o relatório por captura. Builds para a Huawei AppGallery funcionam igual e não usam serviços do Google Play.
  • Confira a versão instalada com npm ls @blipit/react-native (ou pnpm list @blipit/react-native). O pnpm 11 espera um dia antes de instalar uma versão nova (minimum-release-age), então no dia do lançamento o pnpm add instala a versão anterior sem avisar; para pegar a nova na hora, rode pnpm add @blipit/react-native@<version> --config.minimum-release-age=0.
  • Manter o Blipit atualizado: o guia Manter o Blipit atualizado (docs.blipit.io/updates) explica o banner de atualização, os e-mails de versões importantes, o aviso no seu console de desenvolvimento e o comando de atualização para esta plataforma.
  • Um projeto por app e plataforma: cada projeto escolhe a sua plataforma quando é criado (Android, iOS, React Native, Flutter, Web, Backend ou Odoo), e o Blipit recusa com um erro claro os dados de qualquer outra plataforma, por isso uma app iOS e uma app Android precisam de dois projetos com duas chaves. Releases, versões, taxas de falhas e builds das lojas são diferentes em cada plataforma, e misturá-los num projeto torna todos errados. Um projeto Web também aceita o lado servidor da mesma app web (o servidor Next.js ou Node), e um projeto React Native ou Flutter também aceita os seus próprios relatórios de falhas nativos de Android e iOS.

Travou? Envie um e-mail para support@blipit.io. As chaves e o id de cada projeto ficam em Chaves de API no app.blipit.io.