Get started with Firebase In-App Messaging

ios

Before you begin, you need a few things set up in your environment:

• An app with Firebase enabled: If you haven't already, add Firebase to your iOS project.
• Xcode 9.2 or higher: Firebase In-App Messaging needs a relativley-recent version of Xcode to run. You can find the latest Xcode version at Apple's Xcode site.
• CocoaPods 1.4.0 or higher: Firebase In-App Messaging uses CocoaPods to manage dependencies on iOS. You can install it from the CocoaPods site.

android

If you haven't already, add Firebase to your Android project.

ios

To get started, add the Firebase In-App Messaging SDK framework files to your project by adding the Firebase In-App Messaging CocoaPods:

1. Open a new terminal window, and navigate to your Xcode project's directory.
2. Open your Podfile, and add the highlighted lines:

   # Uncomment the next line to define a global platform for your project
   # platform :ios, '9.0'
   
   target 'YourProject' do
   # Comment the next line if you're not using Swift and don't want to use dynamic frameworks
   use_frameworks!
   
   # Pods for YourProject
   pod 'Firebase'
   pod 'Firebase/InAppMessagingDisplay'
   end

3. From your terminal, install the pod's dependencies:

   pod install

4. Open your app's project in Xcode:

   open YOUR-PROJECT.xcworkspace

5. Import the Firebase module in your UIApplicationDelegate, if you haven't yet:

   Swift

   import Firebase

   Objective-C

   @import Firebase;

6. Also configure a FirebaseApp shared instance, typically in your app's application:didFinishLaunchingWithOptions: method, if you haven't yet:

   Swift

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

7. Compile and run your app.

android

Include the SDK in your build files

Add the dependency for the In-App Messaging Android library to your module (app-level) Gradle file (usually app/build.gradle):

dependencies {
    // ...

    // Add the In-App Messaging dependency:
    implementation 'com.google.firebase:firebase-inappmessaging-display:17.1.1'

    // Check that Firebase core is up-to-date:
    implementation 'com.google.firebase:firebase-core:16.0.8'
}

ios

That testing device is determined by a FirebaseInstanceID. To find your testing app's Instance ID, run the app with the runtime command argument -FIRDebugEnabled:

1. With your Xcode project open, select Product > Scheme > Edit scheme... from the top menu bar.
2. Open the Arguments tab of the dialog that pops up.
3. Click + Add items under Arguments Passed On Launch.
4. Enter "-FIRDebugEnabled" in the newly-created field.
5. Click Close, then run your app.

Once your app starts running, look for the following line in the Xcode console's logs:

[Firebase/InAppMessaging][I-IAM180017] Starting InAppMessaging runtime with Instance ID YOUR_APP_ID

android

That testing device is determined by a FirebaseInstanceId. Find your testing app's Instance ID by checking the Logcat in Android Studio for the following `Info` level log:

I/FIAM.Headless: Starting InAppMessaging runtime with Instance ID YOUR_APP_ID