Flutter数据分析与追踪插件karte_core的使用

KARTE Core for Flutter

一个用于Android和iOS平台的Flutter插件，通过KARTE Core API进行事件跟踪。

文档

开发指南位于：

• 开发者门户 - KARTE Flutter SDK

许可证

Flutter KARTE Core包发布于Apache 2.0许可证下。

使用KARTE受条款使用约束。

示例代码

以下是使用karte_core插件的一个完整示例：

import 'dart:async';

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

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

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _visitorId = '未知';
  bool _isOptOut = false;

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
    Tracker.view("测试");
  }

  // 平台消息是异步的，因此我们在这里初始化。
  Future<void> initPlatformState() async {
    String visitorId = await KarteApp.visitorId;
    bool isOptOut = await KarteApp.isOptOut;

    // 如果小部件在异步平台消息发送时从树中移除，则我们需要丢弃回复而不是调用setState来更新我们的非存在的外观。
    if (!mounted) return;

    setState(() {
      _visitorId = visitorId;
      _isOptOut = isOptOut;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('KARTE Core 示例应用'),
        ),
        body: Center(
          child: Column(
            children: [
              Text('访客ID: $_visitorId'),
              Text('是否退出: $_isOptOut'),
              ElevatedButton(
                onPressed: () => Tracker.track("测试"),
                child: Text("跟踪"),
              ),
              ElevatedButton(
                onPressed: () => Tracker.identify({"name": "样本"}),
                child: Text("识别"),
              ),
              ElevatedButton(
                onPressed: () => Tracker.view("测试"),
                child: Text("视图"),
              ),
              ElevatedButton(
                onPressed: () async {
                  KarteApp.optIn();
                  await initPlatformState();
                },
                child: Text("同意"),
              ),
              ElevatedButton(
                onPressed: () async {
                  KarteApp.optOut();
                  await initPlatformState();
                },
                child: Text("退出"),
              ),
              ElevatedButton(
                onPressed: () async {
                  // 忽略: 已弃用的成员使用
                  var url = await UserSync.appendingQueryParameter(
                      "https://example.com");
                  print("URL: $url");
                },
                child: Text("用户同步查询(已弃用)"),
              ),
              ElevatedButton(
                onPressed: () async {
                  var script = await UserSync.getUserSyncScript();
                  print("脚本: $script");
                },
                child: Text("用户同步脚本"),
              ),
            ],
          ),
        ),
      ),
    );
  }
}