· Flutter 개발 · 5 min read
Firebase 한 번에 셋업하기 - Crashlytics, Remote Config, Analytics, FCM
Firebase가 필요한 이유
IoT 앱에서 Firebase는 단순한 백엔드 서비스 이상의 역할을 한다. 크래시 리포트, 원격 설정 변경, 푸시 알림, 사용 분석… 이 모든 걸 Firebase 하나로 해결할 수 있다.
특히 Crashlytics는 필수다. 수백, 수천 명의 사용자가 쓰는 앱에서 특정 기기나 OS 버전에서만 발생하는 크래시를 로컬 테스트로는 발견하기 어렵다. Crashlytics가 실시간으로 크래시를 잡아준다.
FlutterFire CLI로 빠르게 셋업
예전에는 Firebase 콘솔에서 google-services.json과 GoogleService-Info.plist를 수동으로 다운받아서 프로젝트에 추가해야 했다. 지금은 FlutterFire CLI를 쓰면 훨씬 편하다:
dart pub global activate flutterfire_cli
flutterfire configure
실행하면 Firebase 프로젝트를 선택하고, 플랫폼을 선택하면 firebase_options.dart를 자동으로 생성해준다. 이 파일에 모든 플랫폼 설정이 들어있다.
main.dart에서 Firebase 초기화
void main() async {
WidgetsFlutterBinding.ensureInitialized();
// Firebase 초기화
await Firebase.initializeApp(
options: DefaultFirebaseOptions.currentPlatform,
);
// FCM 백그라운드 핸들러 등록 (반드시 top-level 함수)
FirebaseMessaging.onBackgroundMessage(firebaseMessagingBackgroundHandler);
runApp(MyApp());
}
// top-level 함수여야 한다
@pragma('vm:entry-point')
Future<void> firebaseMessagingBackgroundHandler(RemoteMessage message) async {
await Firebase.initializeApp();
// 백그라운드 메시지 처리
}
Crashlytics 설정
Crashlytics는 설정이 간단하다:
// FlutterError를 Crashlytics로 전달
FlutterError.onError = FirebaseCrashlytics.instance.recordFlutterFatalError;
// Dart 비동기 에러도 잡기
PlatformDispatcher.instance.onError = (error, stack) {
FirebaseCrashlytics.instance.recordError(error, stack, fatal: true);
return true;
};
이걸 설정해두면 앱에서 처리되지 않은 모든 예외가 Firebase 콘솔에 보고된다. 실제로 출시 후 특정 Android 버전에서만 발생하는 버그를 Crashlytics로 발견한 경우가 있었다.
개발 중에는 Crashlytics를 비활성화해두는 게 좋다:
await FirebaseCrashlytics.instance
.setCrashlyticsCollectionEnabled(!kDebugMode);
Remote Config 활용
Remote Config의 가장 유용한 활용 사례는 앱 스토어 심사 대응이었다. 심사 중에는 실제 서버 대신 데모 환경으로 동작하도록 Remote Config로 전환한다:
final remoteConfig = FirebaseRemoteConfig.instance;
await remoteConfig.setConfigSettings(RemoteConfigSettings(
fetchTimeout: const Duration(seconds: 3),
minimumFetchInterval: const Duration(hours: 1),
));
await remoteConfig.setDefaults({'env_app_demo': '0'});
await remoteConfig.fetchAndActivate();
final isDemo = remoteConfig.getString('env_app_demo') == '1';
서버 배포 없이 Firebase 콘솔에서 값 하나만 바꾸면 앱 동작이 바뀐다.
Analytics 이벤트
사용자가 어떤 기능을 얼마나 쓰는지 파악하는 데 Analytics를 쓴다:
// 기기 제어 이벤트 기록
await FirebaseAnalytics.instance.logEvent(
name: 'iot_device_power_toggle',
parameters: {
'device_id': deviceId,
'action': isOn ? 'turn_on' : 'turn_off',
},
);
어떤 화면에서 사용자가 이탈하는지, 어떤 기능을 주로 쓰는지 데이터로 볼 수 있다.
FCM 기본 설정
FCM 초기화와 토큰 획득:
// PushNotificationService 초기화
final messaging = FirebaseMessaging.instance;
// iOS 권한 요청
await messaging.requestPermission(
alert: true,
badge: true,
sound: true,
);
// FCM 토큰 획득
final token = await messaging.getToken();
// 이 토큰을 서버에 등록해두면 서버에서 특정 기기로 푸시 가능
// 토큰 갱신 이벤트
messaging.onTokenRefresh.listen((newToken) {
// 서버에 새 토큰 업데이트
});
FCM 상세 처리(포그라운드/백그라운드/종료 상태)는 나중에 별도 편에서 자세히 다룬다.
멀티 환경 Firebase 설정
개발/스테이징/프로덕션 환경마다 Firebase 프로젝트를 분리하는 게 좋다. --dart-define으로 환경을 주입받아서 해당 환경의 Firebase 옵션을 선택한다:
// firebase_options.dart를 환경별로 분리
FirebaseOptions get currentPlatform {
switch (environment) {
case 'prod': return productionOptions;
case 'stage': return stagingOptions;
default: return developmentOptions;
}
}
이렇게 하면 개발 중 발생한 크래시가 프로덕션 Crashlytics에 섞이지 않는다.
다음 편부터는 BLE 연결 파트가 시작된다. 개인적으로 이 프로젝트에서 가장 어려웠던 부분이다.