Initialiser le SDK Flutter (héritage)

Le SDK de Rokt pour les applications Flutter peut être utilisé par les partenaires de Rokt pour afficher des placements en superposition ou intégrés, ou par les annonceurs de Rokt pour enregistrer des conversions pour les campagnes. Le SDK Rokt pour Flutter est déployé sur pub.dev .

Tous les cas d'utilisation du SDK suivront les mêmes étapes initiales pour intégrer et initialiser le SDK dans votre application. À un niveau élevé, ces étapes sont :

Intégrer le SDK dans votre application Flutter
Configurer pour les applications Android
Initialiser le SDK Rokt

Après avoir suivi ces étapes, la méthode execute du SDK peut ensuite être utilisée de différentes manières pour s'adapter au cas d'utilisation requis.

Intégrer le SDK dans votre application Flutter

Pour intégrer le SDK dans votre application Flutter, vous devez :

Ajouter rokt_sdk: ^4.x.x aux dépendances du fichier pubspec.yaml.
Exécuter Flutter Pub Get via le terminal ou Android Studio.

Configuration pour Android

Pour configurer le SDK Flutter de Rokt pour les applications Android, vous devez :

Définir le minSdkVersion et activer multidex dans android/app/build.gradle :

android {
    defaultConfig {
        minSdkVersion 21
        multidexEnabled true
    }
}

Cela signifie que l'application ne sera disponible que pour les utilisateurs exécutant Android SDK 19 ou supérieur.

Inclure l'implémentation de la dépendance appcompat

implementation 'androidx.appcompat:appcompat:x.x.x'

Le thème de android/app doit hériter de la famille de thèmes AppCompat, par exemple :

<style name="NormalTheme" parent="Theme.AppCompat.DayNight.DarkActionBar"/>

Changer l'activité parente de MainActivity en FlutterFragmentActivity

// chemin : android/app/src/main/kotlin/<your-package>/MainActivity.kt
import io.flutter.embedding.android.FlutterFragmentActivity

class MainActivity : FlutterFragmentActivity()

Initialiser le SDK Rokt pour Flutter

Initialisez le SDK Rokt pour Flutter avant de l'utiliser. Nous recommandons d'appeler la méthode initialize tôt dans l'application.

attention

Contactez Rokt pour obtenir l'ID de compte Rokt associé à votre compte. Pour tester votre intégration, vous pouvez utiliser l'ID de compte de test ci-dessous. N'oubliez pas, cependant, qu'il doit être remplacé par votre ID de compte Rokt unique avant le lancement.

ID de compte Rokt de test : 222

import 'package:rokt_sdk/rokt_sdk.dart';

// Ce qui suit révélera une intégration de démonstration. Pour voir votre intégration :
// 1) Remplacez l'ID de balise de test d'intégration (222) par votre ID de balise Rokt unique
// 2) Remplacez 1.0.0 par la version de l'application
RoktSdk.initialize('222', appVersion: '1.0.0');

Recevoir le statut d'initialisation

À partir de la version 4.6.0, le SDK Rokt diffuse le statut d'initialisation via son EventChannel.

final EventChannel roktEventChannel = EventChannel('RoktEvents');

roktEventChannel.receiveBroadcastStream().listen((dynamic event) {
    if (event["event"] == "InitComplete") {
    debugPrint("Rokt init completed with status ${event["status"]}");
    }
});

Débogage

Utilisez l'API RoktSdk.setLoggingEnabled(enable: true); pour activer les journaux de débogage du SDK Rokt.

Prochaines étapes

Vos prochaines étapes dépendent du cas d'utilisation de votre intégration. Consultez ces ressources pour plus d'informations :

Intégrer le SDK dans votre application Flutter​

Configuration pour Android​

Initialiser le SDK Rokt pour Flutter​

Recevoir le statut d'initialisation​

Débogage​

Prochaines étapes​