Add Firebase to your Flutter app

Follow this guide to add Firebase services to a Flutter app.

Step 1: Set up your environment

Install Flutter for your specific operating system, including the installation of the following:
- Flutter SDK
- Supporting libraries
- Platform-specific software and SDKs
Install your preferred editor or IDE, such as Android Studio, IntelliJ, Xcode, or VS Code.
Open your Flutter app in your preferred editor or IDE.
- iOS development — The app must target iOS 8 or later.
- Android development — The app must target API level 14 (Jelly Bean) or later.
Note: If you don't already have a Flutter app, you can complete the Get Started: Test Drive to create a new Flutter app using your preferred editor or IDE.
Access a device or emulator for running your app.
- Android development — Emulators must use an emulator image with Google Play.
Sign into Firebase using your Google account.

Step 2: Create a Firebase project

Before you can add Firebase to your Flutter app, create a Firebase project to connect to your Flutter app.

To create a Firebase project:

Go to the Firebase console.
Click Add project, then select or enter a Project name.
- If you have an existing Google project associated with your app, select the project from the Project name dropdown menu.
- If you don't have an existing Google project, enter a new Project name.
(Optional) Edit the Project ID.

Firebase automatically assigns a unique ID to your Firebase project. This identifier displays in publicly visible Firebase services, for example:
- Default Realtime Database URL — your-project-id.firebaseio.com
- Default Cloud Storage bucket name — your-project-id.appspot.com
- Default Hosting subdomain — your-project-id.firebaseapp.com
After Firebase provisions resources for your Firebase project, you cannot change the project ID.
So, if you want to use a specific identifier with your Firebase services, you must enter that identifier for the project ID during this setup step.
Follow the remaining setup steps in the Firebase console, then click Create project (or Add Firebase, if you're using an existing Google project).

Firebase automatically provisions resources for your Firebase project. The process typically takes a few minutes. When the process completes, you'll be taken to the overview page for your Firebase project in the Firebase console.

Step 3: Configure your app to use Firebase

You can configure one or more apps to connect with your Firebase project. To do this, register your app's platform-specific ID with your Firebase project. Firebase will automatically generate configuration files for your app.

For detailed instructions to configure your app, see the platform-specific steps below for iOS and for Android.

In the top-level directory of your Flutter app, the ios and android directories hold platform-specific configuration files for iOS and Android.

Configure an iOS app

In your Firebase project overview page, launch the setup wizard for iOS.

Note: If you've already added an app to your Firebase project (for example, an Android app), click Add app to display the platform options.
Add your app to your Firebase project:
1. Enter your app’s bundle ID in the iOS bundle ID field.
  - Find this bundle ID by opening your app in XCode, then accessing the General tab in the top-level Runner directory. The value of the Bundle Identifier field is the iOS bundle ID (for example, com.yourcompany.yourproject).
2. (Optional) Enter other app information as prompted by the setup wizard.
3. Click Register app.
Add the Firebase iOS configuration file to your app:
1. Click Download GoogleService-Info.plist to obtain your Firebase iOS config file (GoogleService-Info.plist).
  
  You can download your Firebase iOS config file again at any time.
2. Move the file into the Runner/Runner directory of your Flutter app.
Note: A Firebase config file associates your app with your Firebase project and its resources.
The file's content is considered public, including your platform-specific ID (entered in the Firebase console setup wizard) and values that are specific to your Firebase project, like your Realtime Database URL and Storage bucket name. Given this, use security rules to protect your data in Realtime Database, Cloud Firestore, and Storage.

For open source projects, we generally do not recommend including your config file in source control because, in most cases, your users should create their own Firebase projects and point their apps to their own backends.
Back in the Firebase console setup wizard, click Next to skip the remaining steps.
Continue to Add FlutterFire plugins.

Configure an Android app

In your Firebase project overview page, launch the setup wizard for Android.

Note: If you've already added an app to your Firebase project (for example, an iOS app), click Add app to display the platform options.
Add your app to your Firebase project:
1. Enter your app’s application ID in the Android package name field.
  - An application ID is sometimes referred to as as a package name.
  - Find this application ID in your module (app-level) Gradle file, usually android/app/build.gradle (example application ID: com.yourcompany.yourproject).
2. (Optional) Enter other app information as prompted by the setup wizard.
  
  Note: SHA-1 information is required by Google Sign In and Firebase Dynamic Links.
3. Click Register app.
Add the Firebase Android configuration file to your app:
1. Click Download google-services.json to obtain your Firebase Android config file (google-services.json).
  
  You can download your Firebase Android config file again at any time.
2. Move your config file into the android/app directory of your Flutter app.
Note: A Firebase config file associates your app with your Firebase project and its resources.
The file's content is considered public, including your platform-specific ID (entered in the Firebase console setup wizard) and values that are specific to your Firebase project, like your Realtime Database URL and Storage bucket name. Given this, use security rules to protect your data in Realtime Database, Cloud Firestore, and Storage.

For open source projects, we generally do not recommend including your config file in source control because, in most cases, your users should create their own Firebase projects and point their apps to their own backends.
To enable Firebase services in your Android app, add the google-services plugin to your Gradle files.
1. In your root-level (project-level) Gradle file (android/build.gradle), add rules to include the Google Services plugin. Check that you have Google’s Maven repository, as well.
  
  Note: Flutter is currently compatible with version 3.2.1 of the Google Services plugin.
```
buildscript {
  // ...
  dependencies {
    // ...
    // Add the following line:
    classpath 'com.google.gms:google-services:3.2.1'  // Google Services plugin
  }
}
allprojects {
  // ...
  repositories {
    // ...
    // Check that you have following line (if not, add it):
    google()  // Google's Maven repository
  }
}
```
2. In your module (app-level) Gradle file (usually android/app/build.gradle), add the following line to the bottom of the file.
```
dependencies {
  // ...
}

// ...

// Add the following line to the bottom of the file:
apply plugin: 'com.google.gms.google-services'  // Gradle plugin
```
3. Run flutter packages get.
  
  For more information about managing packages and plugins, see Using Packages.
Continue to Add FlutterFire plugins.

Step 4: Add FlutterFire plugins

Flutter uses plugins to provide access to a wide range of platform-specific services, such as Firebase APIs. Plugins include platform-specific code to access services and APIs on each platform.

Firebase is accessed through a number of different libraries, one for each Firebase service (for example: database, authentication, analytics, or storage). Flutter provides a set of Firebase plugins, which is collectively called FlutterFire.

Since Flutter is a multi-platform SDK, each FlutterFire plugin is applicable for both iOS and Android. So, if you add any FlutterFire plugin to your Flutter app, it will be used by both the iOS and Android versions of your Firebase app.

Be sure to check the FlutterFire docs for the most up-to-date list of FlutterFire plugins.

Ensure that your app is not currently running in your emulator or on your device.
From the root directory of your Flutter app, open your pubspec.yaml file.
Add the FlutterFire plugin for the Firebase Core SDK.

Note: All Flutter apps, both iOS and Android versions, require the firebase_core plugin.
```
dependencies:
  flutter:
    sdk: flutter
  firebase_core: ^0.2.5  # add dependency for Firebase Core
```
Add additional FlutterFire plugins to use specific Firebase services.

The following section, Add Analytics, is an example of how to add FlutterFire plugins to your app.
Run your app to verify installation.

Your Flutter app should now be connected to Firebase.

Add analytics (optional)

Adding Google Analytics for Firebase to your Flutter app is optional, but it's a relatively easy way to verify that Firebase is working properly with Flutter. In addition, Analytics can be very useful during development and debugging, as well as helping to track the success of your production apps.

Ensure that your app is not currently running in your emulator or on your device.

In your pubspec.yaml file, add the FlutterFire plugin for Google Analytics for Firebase:

dependencies:
  flutter:
    sdk: flutter
  firebase_core: ^0.2.5       # This dependency was added during initial configuration.
  firebase_analytics: ^1.0.4  # add dependency for Google Analytics for Firebase

Run flutter packages get.

For more information about managing packages and plugins, see Using Packages.

Analytics app example

Like all packages, the firebase_analytics plugin comes with an example program.

Open a Flutter app that you've already [configured to use Firebase](#configure_to_use_firebase.
Access the lib directory of the app, then delete the existing main.dart file.
From the Google Analytics for Firebase example program repository, copy-paste the following two files into your app's lib directory:
- main.dart
- tabs_page.dart
Run your Flutter app.
Go to your app's Firebase project in the Firebase console, then click Analytics in the left-nav.
- Click Dashboard. If Analytics is working properly, the dashboard shows an active user in the "Users active in the last 30 minutes" panel (this might take time to populate this panel).
- Click DebugView. Enable the feature to see all the events generated by the example program.

For more information about setting up Analytics, see the getting started guides for iOS and for Android.

More about Firebase and Flutter

Review the list of FlutterFire plugins.
Get hands-on experience with the Firebase Flutter Codelab.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Cập nhật lần cuối Tháng 1 7, 2019.