Instalar por plataforma
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.
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.
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.
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
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.
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 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(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
Adicione o JitPack aos repositories em settings.gradle.kts, a dependência ao módulo do app, e chame init em 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"
}
}
}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 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_key7Relató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.
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()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.
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()))),
);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.
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');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.
Blipit.captureMessage("Hello from React Native");await Blipit.captureMessage('Hello from Flutter');Blipit.captureMessage("Hello from iOS")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.

