Flutter 앱에 Firebase 추가
기본 요건
원하는 편집기 또는 IDE를 설치합니다.
실제 Apple 기기를 설정하거나 시뮬레이터를 사용하여 앱을 실행합니다.
Cloud Messaging을 사용하시겠어요?
Apple 플랫폼에서 Cloud Messaging을 사용하려면 다음 기본 요건을 충족해야 합니다.
- 실제 Apple 기기를 설정합니다.
- Apple 개발자 계정의 Apple 푸시 알림 인증 키를 가져옵니다.
- Xcode의 App(앱) > Capabilities(기능)에서 푸시 알림을 사용 설정합니다.
Flutter 앱이 다음 플랫폼 버전 이상을 타겟팅하는지 확인합니다.
- iOS 13
- macOS 10.15
다음을 비롯하여 특정 운영체제에 맞는 Flutter를 설치합니다.
- Flutter SDK
- 지원 라이브러리
- 플랫폼별 소프트웨어 및 SDK
Google 계정을 사용하여 Firebase에 로그인합니다.
아직 Flutter 앱이 없다면 시작하기: 시험 사용을 완료하여 선호하는 편집기나 IDE를 통해 새 Flutter 앱을 만들 수 있습니다.
1단계: 필수 명령줄 도구 설치
아직 설치하지 않았으면 Firebase CLI를 설치합니다.
다음 명령어를 실행하여 Google 계정으로 Firebase에 로그인합니다.
firebase login
디렉터리에서 다음 명령어를 실행하여 FlutterFire CLI를 설치합니다.
dart pub global activate flutterfire_cli
2단계: Firebase를 사용하도록 앱 구성
FlutterFire CLI를 사용하여 Firebase에 연결하도록 Flutter 앱을 구성합니다.
Flutter 프로젝트 디렉터리에서 다음 명령어를 실행하여 앱 구성 워크플로를 시작합니다.
flutterfire configure
flutterfire configure
워크플로는 어떤 역할을 하나요?
flutterfire configure
워크플로는 다음을 수행합니다.
Flutter 앱에서 지원되는 플랫폼(iOS, Android, Web)을 선택하도록 요청합니다. 선택한 각 플랫폼에 대해 FlutterFire CLI가 Firebase 프로젝트에서 새 Firebase 앱을 만듭니다.
기존 Firebase 프로젝트를 사용하거나 새 Firebase 프로젝트를 만들도록 선택할 수 있습니다. 기존 Firebase 프로젝트에 등록된 앱이 있으면 FlutterFire CLI가 현재 Flutter 프로젝트 구성을 기준으로 일치하는 항목을 찾으려고 시도합니다.
Firebase 구성 파일(
firebase_options.dart
)을 만들고 이를lib/
디렉터리에 추가합니다.(Android의 Crashlytics 또는 Performance Monitoring의 경우) 필요한 제품별 Gradle 플러그인을 Flutter 앱에 추가합니다.
3단계: 앱에서 Firebase 초기화
Flutter 프로젝트 디렉터리에서 다음 명령어를 실행하여 core 플러그인을 설치합니다.
flutter pub add firebase_core
Flutter 프로젝트 디렉터리에서 다음 명령어를 실행하여 Flutter 앱의 Firebase 구성이 최신 상태인지 확인합니다.
flutterfire configure
lib/main.dart
파일에서 Firebase core 플러그인 및 앞에서 생성한 구성 파일을 가져옵니다.import 'package:firebase_core/firebase_core.dart'; import 'firebase_options.dart';
또한
lib/main.dart
파일에서 구성 파일로 내보낸DefaultFirebaseOptions
객체를 사용하여 Firebase를 초기화합니다.WidgetsFlutterBinding.ensureInitialized(); await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, ); runApp(const MyApp());
Flutter 애플리케이션을 다시 빌드합니다.
flutter run
데모 프로젝트를 사용하려면 Firebase 에뮬레이터를 시작하고 lib/main.dart
파일에서 demoProjectId
(demo-
로 시작해야 함)를 사용하여 Firebase를 초기화합니다.
await Firebase.initializeApp(
demoProjectId: "demo-project-id",
);
4단계: Firebase 플러그인 추가
각 Firebase 제품에 대해 하나씩 여러 Firebase Flutter 플러그인을 사용하여 Flutter 앱에서 Firebase에 액세스합니다(예: Cloud Firestore, Authentication, Analytics 등).
Flutter가 멀티 플랫폼 프레임워크이기 때문에 각 Firebase 플러그인은 Apple, Android, 웹 플랫폼에 적용될 수 있습니다. 따라서 Firebase 플러그인을 Flutter 앱에 추가하면 Apple, Android, 앱의 웹 버전에 사용됩니다.
Firebase Flutter 플러그인을 추가하는 방법은 다음과 같습니다.
Flutter 프로젝트 디렉터리에서 다음 명령어를 실행합니다.
flutter pub add
PLUGIN_NAME Flutter 프로젝트 디렉터리에서 다음 명령어를 실행합니다.
flutterfire configure
이 명령어를 실행하면 Flutter 앱의 Firebase 구성이 최신 상태인지 확인하고 Android의 Crashlytics 및 Performance Monitoring의 경우 필수 Gradle 플러그인이 앱에 추가됩니다.
완료되면 Flutter 프로젝트를 다시 빌드합니다.
flutter run
다 되었습니다. Flutter 앱이 등록되고 Firebase를 사용하도록 구성되었습니다.
사용 가능한 플러그인
제품 | 플러그인 이름 | iOS | Android | 웹 | 기타 Apple (macOS 등) |
Windows |
---|---|---|---|---|---|---|
Analytics | firebase_analytics |
베타 | ||||
App Check | firebase_app_check |
베타 | ||||
Authentication | firebase_auth |
베타 | 베타 | |||
Cloud Firestore | cloud_firestore |
베타 | 베타 | |||
Cloud Functions | cloud_functions |
베타 | ||||
Cloud Messaging | firebase_messaging |
베타 | ||||
Cloud Storage | firebase_storage |
베타 | 베타 | |||
Crashlytics | firebase_crashlytics |
베타 | ||||
Data Connect | firebase_data_connect |
|||||
Dynamic Links | firebase_dynamic_links |
|||||
In-App Messaging | firebase_in_app_messaging |
|||||
Firebase 설치 | firebase_app_installations |
베타 | ||||
ML 모델 다운로더 | firebase_ml_model_downloader |
베타 | ||||
Performance Monitoring | firebase_performance |
|||||
Realtime Database | firebase_database |
베타 | ||||
Remote Config | firebase_remote_config |
베타 | ||||
Vertex AI in Firebase | firebase_vertexai |
베타 |
Analytics에서 예시 앱 사용해 보기
모든 패키지와 마찬가지로 firebase_analytics
플러그인은 프로그램 예시와 함께 제공됩니다.
이미 Firebase를 사용하도록 구성한 Flutter 앱을 엽니다(이 페이지의 안내 참조).
앱의
lib
디렉터리에 액세스한 후에 기존main.dart
파일을 삭제합니다.Google Analytics 프로그램 예시 저장소에서 다음의 두 파일을 복사하여 앱의
lib
디렉터리에 붙여넣습니다.main.dart
tabs_page.dart
Flutter 앱을 실행합니다.
Firebase Console에서 앱의 Firebase 프로젝트로 이동한 후 왼쪽 탐색 메뉴에서 애널리틱스를 클릭합니다.
Analytics 설정에 대한 자세한 내용은 iOS+, Android, 웹 시작 가이드를 참조하세요.
다음 단계
Firebase Flutter Codelab에서 사용 방법 실습
앱 출시를 준비합니다.
- Google Cloud 콘솔에서 프로젝트의 예산 알림을 설정합니다.
- Firebase 콘솔에서 사용량 및 결제 대시보드를 모니터링하여 여러 Firebase 서비스에서 프로젝트 사용량을 전체적으로 파악합니다.
- Firebase 출시 체크리스트를 검토합니다.