Firebase Flutter Quickstarts

This repository contains a collection of quickstart samples designed to demonstrate the capabilities of various Firebase Flutter plugins. Each sample is an independent project that can be run on a mobile device, a virtual device (emulator/simulator), or a web browser.

Available samples include:

• Firestore: Demonstrates Cloud Firestore integration.
• Authentication: Demonstrates Firebase Authentication integration.
• Crashlytics: Demonstrates Firebase Crashlytics integration.

The AdMob quickstart demonstrates two primary ad types:

1. Banner Ads: Displayed using AdRequest and AdView.
2. Interstitial Ads: Full-screen ads displayed using the InterstitialAd class.

By default, the sample application displays a test banner ad and provides a button to trigger a test interstitial ad.

This quickstart demonstrates the two primary ways to use Google Analytics for Firebase in a Flutter app:

• Logging in-app events: Capturing specific user actions.
• Setting user properties: Defining attributes that describe your users.

To test functions locally without deploying to production, use the Firebase Emulator Suite. In the cloud_functions directory, you can build the function code and start the emulators with a single command. This quickstart uses a V1 function located in the firebase_functions folder.

npm run build && firebase emulators:start

To change the image displayed during the app's launch on iOS, you can either replace the image files directly in the cloud_functions/ios/Runner/Assets.xcassets/LaunchImage.imageset/ directory or use Xcode for a more visual approach.

Using Xcode:

1. Open the iOS workspace from your Flutter project root using: open ios/Runner.xcworkspace.
2. In the Xcode Project Navigator, navigate to Runner/Assets.xcassets.
3. Drag and drop your desired images into the asset catalog to replace the existing launch images.

As you interact with the UI controls in the quickstart (which log events and set user properties), you can view the data live in the Firebase Console:

1. Navigate to your project in the Firebase Console.
2. Select Realtime under the Analytics section in the left-hand vertical menu.
3. Interact with the app to see data appear live.

To use Firestore in this project, follow these setup steps:

1. Flutter Setup: Follow the official Firebase Flutter setup guide.
2. Enable Authentication: In the Firebase Console, go to the Authentication tab > Sign-in Method and enable the 'Anonymous sign in provider'.
3. Create Database: Create a Firestore database instance in the Firebase Console.
4. Environment: Ensure your Flutter development environment is configured for Firestore.

Use the flutterfire configure command to automatically download and set up the Firebase configuration for your project. Use the -y flag to accept defaults and specify your application ID with the -a flag.

flutterfire configure -y -a com.example.dataconnect

Before running the quickstart, you must have a Firebase project and the flutterfire_cli installed.

1. Create a project in the Firebase console.
2. Install the flutterfire_cli globally using dart pub.

dart pub global activate flutterfire_cli

To use AdMob in your Flutter project on iOS, you must provide your AdMob app ID in the Info.plist file. Locate the ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy placeholder and replace it with your actual AdMob app ID.

File path: ios/Runner/Info.plist

<!-- In ios/Runner/Info.plist -->
<key>GADApplicationIdentifier</key>
<string>ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy</string>

You can measure the performance of specific activities in your Flutter application by using custom traces. To implement a custom trace:

1. Create a new trace using FirebasePerformance.instance.newTrace('yourTraceName').
2. Start the trace.
3. Perform the activity you want to measure.
4. Stop the trace by awaiting the stop method.

Once recorded, you can view these traces in the Firebase console under the 'Custom Traces' tab.

var trace = FirebasePerformance.instance.newTrace('myTag');
await trace.start();
// ... perform activity ...
await trace.stop();

For the Email/Password authentication example to work, you must enable the provider in your Firebase project settings:

1. Open the Firebase Console.
2. Select your project.
3. Navigate to the Auth panel.
4. Click on the Sign In Method tab.
5. Locate Email/Password.
6. Toggle the Enable switch to on.
7. Click Save.