[firebase_in_app_messaging] add new plugin (#1791)

* add plugin for firebase inappmessaging

Author: prakhar1989

packages/firebase_in_app_messaging/.gitignore

@@ -0,0 +1,7 @@
+.DS_Store
+.dart_tool/
+
+.packages
+.pub/
+
+build/

packages/firebase_in_app_messaging/.metadata

@@ -0,0 +1,10 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: 2e540931f73593e35627592ca4f9a4ca3035ed31
+  channel: stable
+
+project_type: plugin

packages/firebase_in_app_messaging/CHANGELOG.md

@@ -0,0 +1,3 @@
+## 0.0.1
+
+* Initial release.

packages/firebase_in_app_messaging/LICENSE

@@ -0,0 +1,26 @@
+Copyright 2018, the Chromium project authors. All rights reserved.
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above
+      copyright notice, this list of conditions and the following
+      disclaimer in the documentation and/or other materials provided
+      with the distribution.
+    * Neither the name of Google Inc. nor the names of its
+      contributors may be used to endorse or promote products derived
+      from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

packages/firebase_in_app_messaging/README.md

@@ -0,0 +1,90 @@
+# firebase_in_app_messaging plugin
+
+A Flutter plugin to use the [Firebase In-App Messaging API](https://firebase.google.com/products/in-app-messaging).
+
+For Flutter plugins for other Firebase products, see [FlutterFire.md](https://github.com/flutter/plugins/blob/master/FlutterFire.md).
+
+*Note*: This plugin is still under development, and some APIs might not be available yet. [Feedback](https://github.com/flutter/flutter/issues) and [Pull Requests](https://github.com/flutter/plugins/pulls) are most welcome!
+
+## Usage
+
+### Import the firebase_in_app_messaging plugin
+To use the firebase_in_app_messaging plugin, follow the [plugin installation instructions](https://pub.dartlang.org/packages/firebase_in_app_messaging#pub-pkg-tab-installing).
+
+### Android integration
+
+There are a few extra steps required for the Android integration. Enable the Google services by configuring the Gradle scripts as such.
+
+1. Add the classpath to the `[project]/android/build.gradle` file.
+```gradle
+dependencies {
+  // Example existing classpath
+  classpath 'com.android.tools.build:gradle:3.3.0'
+  // Add the google services classpath
+  classpath 'com.google.gms:google-services:4.2.0'
+}
+```
+
+2. Add the apply plugin to the `[project]/android/app/build.gradle` file.
+```gradle
+// ADD THIS AT THE BOTTOM
+apply plugin: 'com.google.gms.google-services'
+```
+
+*Note:* If this section is not completed you will get an error like this:
+```
+java.lang.IllegalStateException:
+Default FirebaseApp is not initialized in this process [package name].
+Make sure to call FirebaseApp.initializeApp(Context) first.
+```
+
+*Note:* When you are debugging on Android, use a device or AVD with Google Play services.
+Otherwise you will not be able to use Firebase In-App Messaging.
+
+### Use the plugin
+
+To show In-App Messages in your app, no extra setup is required - just import the plugin and you
+are good to go. However, to modify message behavior (as documented [here](https://firebase.google.com/docs/in-app-messaging/modify-message-behavior)), the plugin provides the following methods -
+
+First off, add the following imports to your Dart code:
+```dart
+import 'package:firebase_in_app_messaging/firebase_in_app_messaging.dart';
+```
+
+#### Programmatic Triggers ([docs](https://firebase.google.com/docs/in-app-messaging/modify-message-behavior?platform=android#trigger_in-app_messages_programmatically))
+
+To trigger in-app messages programmatically
+
+```dart
+FirebaseInAppMessaging.triggerEvent('eventName');
+```
+
+#### Temporarily disable in-app messages ([docs](https://firebase.google.com/docs/in-app-messaging/modify-message-behavior?platform=android#temporarily_disable_in-app_messages))
+
+If you'd like to suppress message displays for any reason, for example to avoid interrupting a sequence of payment processing screens, you can do that the following
+
+```dart
+FirebaseInAppMessaging.setMessagesSuppressed(true);
+
+
+// To re-enable
+FirebaseInAppMessaging.setMessagesSuppressed(false);
+```
+
+#### Enable opt-out message delivery ([docs](https://firebase.google.com/docs/in-app-messaging/modify-message-behavior?platform=android#enable_opt-out_message_delivery))
+
+First, follow the step outlined [here](https://firebase.google.com/docs/in-app-messaging/modify-message-behavior#enable_opt-out_message_delivery) for both iOS and Android. Then add the following code in your app:
+
+```dart
+FirebaseInAppMessaging.setAutomaticDataCollectionEnabled(false);
+```
+
+## Example
+
+See the [example application](https://github.com/flutter/plugins/tree/master/packages/firebase_in_app_messaging/example) source
+for a complete sample app using the Firebase In-App Messaging.
+
+## Issues and feedback
+
+Please file [issues](https://github.com/flutter/flutter/issues/new)
+to send feedback or report a bug. Thank you!

packages/firebase_in_app_messaging/android/.gitignore

@@ -0,0 +1,8 @@
+*.iml
+.gradle
+/local.properties
+/.idea/workspace.xml
+/.idea/libraries
+.DS_Store
+/build
+/captures

packages/firebase_in_app_messaging/android/build.gradle

@@ -0,0 +1,38 @@
+group 'com.example.firebase_in_app_messaging'
+version '1.0-SNAPSHOT'
+
+buildscript {
+    repositories {
+        google()
+        jcenter()
+    }
+
+    dependencies {
+        classpath 'com.android.tools.build:gradle:3.3.0'
+    }
+}
+
+rootProject.allprojects {
+    repositories {
+        google()
+        jcenter()
+    }
+}
+
+apply plugin: 'com.android.library'
+
+android {
+    compileSdkVersion 28
+
+    defaultConfig {
+        minSdkVersion 16
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+    lintOptions {
+        disable 'InvalidPackage'
+    }
+    dependencies {
+        api 'com.google.firebase:firebase-inappmessaging-display:18.0.1'
+        implementation 'androidx.annotation:annotation:1.0.0'
+    }
+}

packages/firebase_in_app_messaging/android/gradle.properties

@@ -0,0 +1,2 @@
+org.gradle.jvmargs=-Xmx1536M
+

packages/firebase_in_app_messaging/android/settings.gradle

@@ -0,0 +1 @@
+rootProject.name = 'firebase_in_app_messaging'

packages/firebase_in_app_messaging/android/src/main/AndroidManifest.xml

@@ -0,0 +1,3 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+  package="com.example.firebase_in_app_messaging">
+</manifest>