Last updated 31 janv. 2025

Initialiser le SDK Flutter

Le SDK de Rokt pour les applications Flutter peut être utilisé par les partenaires Rokt pour afficher des emplacements en superposition ou intégrés, ou par les annonceurs 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
Configuration 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 convenir 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.7.0 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 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 utilisant 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 s'étendre 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/<votre-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. Afin de 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 tag de test d'intégration (222) par votre ID de tag 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("Initialisation Rokt terminée avec le statut ${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​