Get Started

Our Flutter plugin wrapper makes it easier for you to install the SDK directly on your Flutter app. Follow these simple steps

Add Dependencies

To add the Cooee Flutter plugin to your project, edit your project's pubspec.yaml file:

dependencies:
    cooee_plugin: x.y.z

Replace x.y.z with the latest release of the SDK



Or Run command

$ flutter pub add cooee_plugin

This command will add the latest version of cooee_plugin

Configure Credentials

Android setup

Add the following inside the application tag in AndroidManifest.xml present in android/app/src/main/ folder.

<meta-data
    android:name="COOEE_APP_ID"
    android:value="MY_COOEE_APP_ID"/>

<!-- Sets configuration for com.google.ar.core -->
<meta-data android:name="com.google.ar.core" android:value="optional" />

iOS setup

Add the following snippet in the app's Info.plist present at ios/Runner/ folder.

<key>COOEE_APP_ID</key>
<string>MY_COOEE_APP_ID</string>

Replace MY_COOEE_APP_ID with the App ID which is present at Cooee Portal.

Configure Firebase (Android only)

For Android, Cooee uses Firebase Messaging Service to send push notifications. To enable this feature, follow the steps below:

Register your app with Firebase

1. To connect your app to firebase, follow Step 2 provided in the firebase documentation.
2. Once the app is connected to your firebase project, add the google-service.json file in the android/app folder of your project.

Add Firebase messaging service

Once you registered your app with firebase, add the following inside the application tag in AndroidManifest.xml present at android/app/src/main/ folder

<service android:name="com.letscooee.flutter.FlutterCooeeFirebaseMessagingService"
    android:exported="false">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>

Permission Usage

Android (Optional)

Cooee SDK supports prompting the following permissions via engagement. To make it work, you need to add the following to the app's AndroidManifest.xml file present in android/app/src/main/ folder.

<!-- Cooee SDK use this permission to run Augmented Reality engagements -->
<uses-permission android:name="android.permission.CAMERA" />

<!-- Cooee SDK use this permission to run Location based engagements -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

<!-- Cooee SDK use this permission to post an notification(required only on Android 13 and above) -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

iOS

Cooee SDK uses a few permission if granted (we do not ask explicitly) for analysing the user. This helps us to create and deliver better notifications and in-apps. Apple requires a user-friendly description of such permissions as defined here.

Add the following permission description to App's Info.plist file present at ios/Runner/ folder.

<key>NSLocationWhenInUseUsageDescription</key>
<string>App uses location to search retailer location</string>
<key>NSBluetoothAlwaysUsageDescription</key>
<string>App uses Bluetooth to find out nearby devices</string>
<key>NSCameraUsageDescription</key>
<string>Need to access your camera for a better AR experience.</string>

Import it

Now in your Dart code, import the package and start using it:

import 'package:cooee_plugin/cooee_plugin.dart';

void requestNotificationPermission() {
    CooeePlugin.requestNotificationPermission();
}