This Flutter Integration SDK contains code to help you use our Android and/or iOS Native/Web SDKs from Flutter.

Tested with Flutter 3.13.4, Dart 3.1.2, DevTools 2.25.0, Xcode 15.0.

• Download the flutter-tools folder from our github repo flutter-integration-sdk.

• From the downloaded flutter-tools/android/android-package folder, copy the flutter package to your Android Native Root Project.

This package contains the extension function .loadMopinionFlutterBridge(flutterEngine: FlutterEngine), which will handle the Method Channel from Flutter and perform actions on the Native SDK.

• In your Android Native Project, make your MainActivity.kt (or equivalent) extend from FlutterFragmentActivity.

• You can call loadMopinionFlutterBdrige(flutterEngine) in the override method configureFlutterEngine(flutterEngine: FlutterEngine) like the following:

    @ExperimentalStdlibApi
    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        loadMopinionFlutterBridge(flutterEngine)
    }

• Download the flutter-tools folder from our github repo flutter-integration-sdk.

• Open your Xcode project (default is ios/Runner.xcworkspace).
• From the downloaded flutter-tools/ios folder, copy the MopinionFlutterBridge.swift file somewhere into your Xcode main project. For example to the main folder of the Runner project of a default Flutter generated project.
• In your AppDelegate.swift file, add a line for the method MopinionFlutterBridge.shared.mopinionSdkBind(). This will bind the Native project with the Flutter project and will receive the desired events.

Here is an example of the AppDelegate.swift:

import UIKit
import Flutter

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
  override func application(_ application: UIApplication,didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    
    MopinionFlutterBridge.shared.mopinionSdkBind()
    GeneratedPluginRegistrant.register(with: self)
    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
  }
}

• If your iOS project uses a podspec file, add the following line above the end :

  s.dependency 'MopinionSDKWeb', '>= 0.6.0'

P.S: Flutter uses iOS 11 by default, which our MopinionSDKWeb supports. You can also use our fully native MopinionSDK version 1.0.2 or higher, but that requires upgrading your Flutter project to iOS 12 :

  s.dependency 'MopinionSDK', '>= 1.0.2'

• Alternatively, you can manually add one of our iOS SDK's to your Xcode project via swift package manager. See instructions for MopinionSDKWeb or the native MopinionSDK.

• From the downloaded folder flutter-tools, copy the file flutter-package/MopinionFlutterBridge.dart to your Flutter project. It contains the class with all the methods that the SDK can perform.

• Add a single call to initSdk(), to make the SDK ready to use, preferrably as soon as your project has displayed a user interface, as for example after the initState():

    //example class: main.dart
    ...
class _MyHomePageState extends State<MyHomePage> {
	...
	@override
  void initState() {
	...
    MopinionFlutterBridge.initSdk(String DEPLOYMENT_KEY, bool log)

Your deployment key is a code-string that you can get from the Mopinion Deployment Editor in a web browser.

The initSdk() should happen before using any of the other SDK methods, as they expect the SDK to be initialised. Once this is done, the SDK is ready to use.

P.S: The functions of MopinionFlutterBridge.dart are static, thus there is no need of initialise it as an object.

• Once the SDK is initialised, you can invoke our form events from any View class of the Flutter project, as the following example:

    //example class: main.dart

    // .event accepts a EVENT_NAME string like "_button" as you have previously 
    // defined in the Mopinion Deployment Editor.
    MopinionFlutterBridge.event(EVENT_NAME);

• The method data from MopinionFlutterBridge will receive a Map<String, String> as parameted for the metadata.
• The method removeMetadata from MopinionFlutterBridge will receive a key as String to delete the key metadata you refer to.
• The method removeAllMetadata from MopinionFlutterBridge will remove all the metadata stored previously.

    //example class: main.dart

    //.data will receive a Map<String, String> as key and value map, which will add metadata to the form.
    Map<String, String> metadataMap = {
        "age": "29",
        "name": "Manuel"
    };
    MopinionFlutterBridge.data(metadataMap);