Flutter集成Rokt服务插件rokt_sdk的使用

概述

rokt_sdk 是一个用于在Flutter应用程序中集成Rokt服务的插件。通过这个插件，您可以为您的移动应用添加Rokt的功能，以提升用户体验和增加商业价值。

初始化与配置

添加依赖

在 pubspec.yaml 文件中添加以下依赖：

dependencies:
  flutter:
    sdk: flutter

  rokt_sdk: ^4.0.0-alpha.3

Android 配置

1. 在 android/app/build.gradle 中设置 minSdkVersion 和启用 multidex：

android {
    defaultConfig {
        minSdkVersion 21
        multidexEnabled true
    }
}

1. 包含 appcompat 依赖，并确保主题继承自 AppCompat 主题：

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

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

iOS 配置

Rokt iOS SDK 支持 iOS 版本 10 及以上。

更新SDK

为了更新SDK，请执行以下步骤：

1. 运行 flutter clean
2. 删除 /ios/Pods
3. 删除 /ios/Podfile.lock
4. 运行 flutter pub get
5. 在 ios 文件夹内运行 pod install

初始化 Rokt SDK

在应用程序启动时初始化 Rokt SDK：

import 'package:rokt_sdk/rokt_sdk.dart';

void initializeRokt() {
    // Replace the integration test tag ID (222) with your unique Rokt Tag ID
    // Replace 1.0.0 with the application version
    RoktSdk.initialize('222', appVersion: '1.0.0');
}

使用示例

Overlay Placements

在需要的地方调用 Rokt SDK 并传递用户属性：

import 'package:rokt_sdk/rokt_sdk.dart';

void executeRoktOverlay() {
    RoktSdk.execute(
        viewName: "RoktExperience",
        attributes: {
            "email": "j.smith@example.com",
            "firstname": "Jenny",
            "lastname": "Smith",
            "mobile": "(555)867-5309",
            "postcode": "90210",
            "country": "US"
        },
        config: RoktConfig(),
        onLoad: () {
            print("Rokt placement loaded");
        },
        onUnLoad: () {
            print("Rokt placement unloaded");
        },
        onShouldShowLoadingIndicator: () {
            print("Show loading indicator");
        },
        onShouldHideLoadingIndicator: () {
            print("Hide loading indicator");
        }
    );
}

Embedded Placements

在视图中添加 RoktWidget 并在创建后显示它：

import 'package:rokt_sdk/rokt_sdk.dart';

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  void showWidget() {
      RoktSdk.execute(
          viewName: "RoktExperience",
          attributes: {
              "email": "j.smith@example.com",
              "firstname": "Jenny",
              "lastname": "Smith",
              "mobile": "(555)867-5309",
              "postcode": "90210",
              "country": "US"
          },
          config: RoktConfig(),
          onLoad: () {
              print("Rokt placement loaded");
          },
          onUnLoad: () {
              print("Rokt placement unloaded");
          },
          onShouldShowLoadingIndicator: () {
              print("Show loading indicator");
          },
          onShouldHideLoadingIndicator: () {
              print("Hide loading indicator");
          }
      );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
      return MaterialApp(
          home: Scaffold(
              appBar: AppBar(title: Text('Plugin example app')),
              body: Column(children: [
                  const Text("Location 1"),
                  const RoktWidget(placeholderName: "Location1"),
                  const Text("Location 2"),
                  RoktWidget(
                      placeholderName: "Location2",
                      onWidgetCreated: () {
                          showWidget();
                      }
                  ),
                  const Text("The end")
              ])
          )
      );
  }
}