CrashLens
CrashLens
/ Docs
← Voltar para o site
Documentação / Começando

Guia de Início Rápido

Instale o CrashLens no seu projeto Flutter e comece a monitorar erros em menos de 5 minutos.


1

Crie uma conta

Acesse o painel do CrashLens e crie sua conta. Após o login, crie um projeto para sua aplicação Flutter.

2

Adicione a dependência

Adicione o pacote crashlens_flutter ao seu pubspec.yaml:

dependencies:
  crashlens_flutter: ^0.4.1

Em seguida, execute:

flutter pub get
3

Inicialize o SDK

No main.dart do seu app, importe e inicialize o CrashLens antes do runApp():

import 'package:crashlens_flutter/crashlens_flutter.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await CrashLens.init(
    options: CrashLensOptions(
      // 🔑 Chave do ambiente (criada no painel)
      apiKey: 'sua-api-key-aqui',

      // 🌐 URL do backend
      baseUrl: 'https://apicrashlens.laziv.com/api',

      // 🎯 Taxa de amostragem (1.0 = 100%)
      sampleRate: 1.0,

      // ✅ Capturas automáticas
      enableFlutterErrorCapture: true,
      enablePlatformDispatcherCapture: true,
      enableZoneCapture: true,

      // 👤 Identificação do usuário (opcional)
      user: CrashLensUser(
        id: 'user-123',
        email: 'usuario@exemplo.com',
      ),
    ),
  );

  runApp(const MyApp());
}
4

Configure o NavigatorObserver (opcional)

Adicione o CrashLensNavigatorObserver ao seu MaterialApp para capturar automaticamente a navegação entre rotas:

MaterialApp(
  navigatorObservers: [
    CrashLensNavigatorObserver(),
  ],
  // ...
)
5

Configure interceptors HTTP (opcional)

Se você usa Dio para requisições HTTP, adicione o CrashLensDioInterceptor para capturar chamadas de rede:

import 'package:dio/dio.dart';

final dio = Dio()
  ..interceptors.add(CrashLensDioInterceptor());

Se você usa o pacote http, use o CrashLensHttpClient:

import 'package:http/http.dart' as http;

final client = CrashLensHttpClient(http.Client());
final response = await client.get(Uri.parse('https://api.exemplo.com/data'));
6

Obtenha sua API Key

No painel do CrashLens, crie um projeto e um ambiente (production, staging ou development). Cada ambiente gera uma API Key única que você usará no CrashLensOptions.apiKey.


Próximos passos