Synerise Flutter SDK (synerise-flutter-sdk) (1.4.2)

About

Synerise SDK plugin for Flutter.

Documentation

Most up-to-date documentation is available at Developer Guide - Mobile SDK.

Requirements

• Access to workspace
• A Profile API Key
• Development environment configured - Flutter documentation

Android

• Minimum Android SDK version - 21
• Supported targetSDKVersion - 33

iOS

• Xcode 15 and iOS SDK 17
• iOS 9.0+ minimum deployment target
• Valid architectures: arm64 devices and arm64, x86_64 simulators

Installation

With flutter

 $ flutter pub add synerise_flutter_sdk

This will add a line like this to your package's pubspec.yaml (and run an implicit flutter pub get):

dependencies:
  synerise_flutter_sdk: ^1.3.0

Alternatively, your editor might support flutter pub get. Check the docs for your editor to learn more.

Path dependency

via ssh:

synerise_flutter_sdk: 
    git:
      url: git@github.com:Synerise/synerise-flutter-sdk.git

or

via https:

synerise_flutter_sdk: 
    git:
      url: https://github.com/Synerise/synerise-flutter-sdk.git

Importing Synerise SDK

import 'package:synerise_flutter_sdk/synerise.dart';

Android gradle & configuration

Add to the android/build.gradle:

repositories {
    google()
    mavenCentral()
    maven { url 'https://pkgs.dev.azure.com/Synerise/AndroidSDK/_packaging/prod/maven/v1' }
}

in MainActivity add:

public class MainActivity extends FlutterActivity {
@Override    
public void configureFlutterEngine(@NonNull FlutterEngine flutterEngine) {
    super.configureFlutterEngine(flutterEngine);        
    SyneriseMethodChannel.configureChannel(flutterEngine);    
}}

iOS configuration

In iOS portion of your application (/ios) you will need to run pod update.

Initialization

First of all, you need to initialize Synerise Flutter SDK and provide Profile API Key.

To get Profile API Key, please sign in to your Synerise account and visit https://app.synerise.com/settings/apikeys. Then, generate new API Key for Profile audience.

Synerise.initializer()
  .withClientApiKey("YOUR_PROFILE_API_KEY")
  .init(); 

Running example app

• Open project folder in selected IDE
• flutter pub get in the terminal (dependencies pull)
• Select the device/emulator in your IDE (for ios part it is required to run pod update in example/ios directory)
• Fill the file api_key.txt located in example/lib with your profile api key
• Make sure the firebase related files example/ios/Runner/GoogleService-Info.plist and example/android/app/google-services.json are filled with your firebase project configuration data
• Run the example app via selected sdk or execute cd example and flutter run in the terminal

Changelog

Changelog can be found here.

Author

Synerise, developer@synerise.com. If you need support please feel free to contact us.