Flutter의 Firebase Crashlytics 사용법

Firebase Crashlytics는 Firebase에서 제공하는 실시간 충돌 보고 서비스로, Flutter 애플리케이션에서 발생하는 충돌을 추적하고 분석할 수 있는 강력한 도구입니다. Crashlytics를 사용하면 앱의 안정성을 높이고, 문제를 빠르게 해결할 수 있습니다. 이번 글에서는 Flutter에서 Firebase Crashlytics를 사용하는 방법과 이를 구현하는 예제를 자세히 살펴보겠습니다.

1. Firebase 프로젝트 설정

Firebase Crashlytics를 사용하려면 먼저 Firebase 콘솔에서 프로젝트를 생성하고 설정해야 합니다.

1. Firebase 콘솔에 접속하여 새 프로젝트를 생성합니다.
2. Android 및 iOS 애플리케이션을 Firebase 프로젝트에 추가합니다.
3. Firebase 프로젝트 대시보드에서 "Crashlytics" 섹션으로 이동하여 Crashlytics를 설정합니다.

2. Firebase 플러그인 설치

Firebase Crashlytics를 Flutter 프로젝트에 통합하려면 firebase_core 및 firebase_crashlytics 패키지를 설치해야 합니다. pubspec.yaml 파일에 다음 의존성을 추가합니다.

dependencies:
  flutter:
    sdk: flutter
  firebase_core: ^2.3.0
  firebase_crashlytics: ^3.0.0

 

그리고 pub get 명령어를 실행하여 패키지를 설치합니다.

3. Firebase 초기화

Firebase를 사용하려면 애플리케이션을 초기화해야 합니다. main.dart 파일에서 Firebase를 초기화하고 Crashlytics를 설정합니다.

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_crashlytics/firebase_crashlytics.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  
  // Crashlytics 설정
  FlutterError.onError = FirebaseCrashlytics.instance.recordFlutterFatalError;

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

class HomeScreen extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Firebase Crashlytics Example')),
      body: Center(
        child: Text('Welcome to Firebase Crashlytics Example!'),
      ),
    );
  }
}

 

위 코드는 Firebase를 초기화하고 Flutter 애플리케이션에서 발생하는 에러를 Crashlytics로 보고할 수 있도록 설정합니다.

 

 

반응형

 

4. 커스텀 로깅

Crashlytics를 사용하면 커스텀 로그를 추가하여 더 많은 정보를 제공할 수 있습니다. log 메서드를 사용하여 로그를 추가할 수 있습니다.

class HomeScreen extends StatelessWidget {
  final FirebaseCrashlytics crashlytics = FirebaseCrashlytics.instance;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Firebase Crashlytics Example')),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text('Welcome to Firebase Crashlytics Example!'),
            ElevatedButton(
              onPressed: _sendTestLog,
              child: Text('Send Test Log'),
            ),
          ],
        ),
      ),
    );
  }

  void _sendTestLog() {
    crashlytics.log('Test log from HomeScreen');
    print('Test log sent to Crashlytics');
  }
}

 

위 코드는 'Test log from HomeScreen'이라는 로그 메시지를 Crashlytics로 전송하는 예제입니다. log 메서드를 사용하여 로그 메시지를 추가할 수 있습니다.

5. 커스텀 키 및 사용자 정보 설정

Crashlytics를 사용하면 커스텀 키와 사용자 정보를 설정하여 충돌 보고서를 더욱 유용하게 만들 수 있습니다.

class HomeScreen extends StatelessWidget {
  final FirebaseCrashlytics crashlytics = FirebaseCrashlytics.instance;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Firebase Crashlytics Example')),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text('Welcome to Firebase Crashlytics Example!'),
            ElevatedButton(
              onPressed: _setCustomKey,
              child: Text('Set Custom Key'),
            ),
            ElevatedButton(
              onPressed: _setUserInfo,
              child: Text('Set User Info'),
            ),
          ],
        ),
      ),
    );
  }

  void _setCustomKey() {
    crashlytics.setCustomKey('example_key', 'example_value');
    print('Custom key set in Crashlytics');
  }

  void _setUserInfo() {
    crashlytics.setUserIdentifier('user_12345');
    crashlytics.setCustomKey('user_email', 'user@example.com');
    print('User info set in Crashlytics');
  }
}

 

위 코드는 커스텀 키와 사용자 정보를 설정하는 예제입니다. setCustomKey 메서드를 사용하여 커스텀 키를 설정하고, setUserIdentifier 메서드를 사용하여 사용자 ID를 설정할 수 있습니다.

6. 강제 충돌 보고

Crashlytics가 제대로 작동하는지 확인하기 위해 강제 충돌을 발생시켜 보고서를 테스트할 수 있습니다.

class HomeScreen extends StatelessWidget {
  final FirebaseCrashlytics crashlytics = FirebaseCrashlytics.instance;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Firebase Crashlytics Example')),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text('Welcome to Firebase Crashlytics Example!'),
            ElevatedButton(
              onPressed: _causeCrash,
              child: Text('Cause Crash'),
            ),
          ],
        ),
      ),
    );
  }

  void _causeCrash() {
    crashlytics.log('Cause crash button pressed');
    throw StateError('This is a test crash');
  }
}

 

위 코드는 강제 충돌을 발생시키는 예제입니다. 버튼을 클릭하면 StateError 예외가 발생하여 Crashlytics에 보고됩니다.

결론

Firebase Crashlytics는 Flutter 애플리케이션에서 발생하는 충돌을 실시간으로 추적하고 분석할 수 있는 강력한 도구입니다. 커스텀 로깅, 커스텀 키 및 사용자 정보 설정, 강제 충돌 보고 등의 기능을 통해 충돌 보고서를 더욱 유용하게 만들 수 있습니다. 이번 글에서 소개한 방법들을 활용하여 Flutter 애플리케이션에서 Firebase Crashlytics를 효율적으로 사용해보세요. Crashlytics를 통해 앱의 안정성을 높이고, 문제를 빠르게 해결할 수 있습니다.