Flutter集成CellRebel SDK插件flutter_cellrebel_sdk的使用

描述

flutter_cellrebel_sdk 是一个用于在 Flutter 应用中集成 CellRebel SDK 的插件。通过该插件，您可以轻松地实现用户行为跟踪、版本信息获取以及用户数据清除等功能。

使用方法

1. 初始化 SDK 在应用启动时，首先需要调用 CellRebelSDK.init 方法，并传入您的唯一 CLIENT_KEY 字符串。

   import 'package:flutter_cellrebel_sdk/flutter_cellrebel_sdk.dart';
   
   void main() {
     runApp(MyApp());
   }
   
   class MyApp extends StatelessWidget {
     @override
     Widget build(BuildContext context) {
       // 初始化 SDK
       CellRebelSDK.init("YOUR_CLIENT_KEY");
       return MaterialApp(
         home: HomeScreen(),
       );
     }
   }
   

2. 开始跟踪 调用 CellRebelSDK.startTracking 开始收集用户行为数据。通常建议在用户同意位置权限后调用此方法。

   CellRebelSDK.startTracking();
   

3. 停止跟踪 如果某些高负载任务正在进行，可以调用 CellRebelSDK.stopTracking 中止当前的跟踪序列。

   CellRebelSDK.stopTracking();
   

4. 获取 SDK 版本 使用 CellRebelSDK.getVersion 获取当前 SDK 的版本号。

   String sdkVersion = await CellRebelSDK.getVersion();
   print("SDK Version: $sdkVersion");
   

5. 清除用户数据 如果需要根据 GDPR 的“被遗忘权”删除用户数据，可以调用 CellRebelSDK.clearUserData 方法。

   bool success = await CellRebelSDK.clearUserData();
   if (success) {
     print("User data cleared successfully.");
   } else {
     print("Failed to clear user data.");
   }
   

完整示例 Demo

以下是一个完整的示例代码，展示了如何在 Flutter 应用中集成和使用 flutter_cellrebel_sdk。

import 'package:flutter/material.dart';
import 'dart:async';

import 'package:flutter/services.dart';
import 'package:flutter_cellrebel_sdk/flutter_cellrebel_sdk.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

class HomeScreen extends StatefulWidget {
  @override
  _HomeScreenState createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  String _version = "Unknown";
  bool _isEnabled = true;

  @override
  void initState() {
    super.initState();
    initPlatformState();
  }

  Future<void> initPlatformState() async {
    // 初始化 SDK
    CellRebelSDK.init("YOUR_CLIENT_KEY");

    String sdkVersion;
    try {
      sdkVersion = await CellRebelSDK.getVersion ?? "Unknown platform version";
    } on PlatformException {
      sdkVersion = "Failed to get platform version.";
    }

    if (!mounted) return;

    setState(() {
      _version = sdkVersion;
    });
  }

  void clearUserData() async {
    // 清除用户数据
    bool success = await CellRebelSDK.clearUserData();
    if (success) {
      setState(() {
        _isEnabled = false;
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text("CellRebel SDK 示例"),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.spaceEvenly,
          children: [
            Text("SDK 版本: $_version\n"),
            ElevatedButton(
              child: Text("开始跟踪"),
              onPressed: _isEnabled ? CellRebelSDK.startTracking : null,
            ),
            ElevatedButton(
              child: Text("停止跟踪"),
              onPressed: _isEnabled ? CellRebelSDK.stopTracking : null,
            ),
            ElevatedButton(
              child: Text("清除用户数据"),
              onPressed: _isEnabled ? clearUserData : null,
            ),
          ],
        ),
      ),
    );
  }
}

注意事项

• 确保在项目的 pubspec.yaml 文件中添加了 flutter_cellrebel_sdk 依赖。

  dependencies:
    flutter_cellrebel_sdk: ^1.0.0