Flutter车辆诊断与追踪插件car_doctor_sdk_tracking的使用

Flutter车辆诊断与追踪插件car_doctor_sdk_tracking的使用

简介

car_doctor_sdk_tracking 是一个用于 Flutter 的插件，旨在为移动设备集成基于位置的车库查找功能。它可以帮助开发者轻松实现车辆诊断和追踪功能。

使用步骤

1. 配置环境

确保您的开发环境满足以下要求：

• flutter: >=3.0.0
• sdk: >=2.12.0 <3.0.0

在项目的 pubspec.yaml 文件中添加依赖项：

dependencies:
  car_doctor_sdk_tracking: ^0.0.3

然后运行以下命令安装依赖：

flutter pub get

2. 初始化插件

在应用启动时初始化插件。确保调用 WidgetsFlutterBinding.ensureInitialized() 并通过 AppTracking.instance.init() 方法设置基础 URL。

示例代码：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized(); // 确保 Flutter 绑定已初始化
  await AppTracking.instance.init('https://your-base-url.com'); // 初始化插件并传入基础 URL
  runApp(const MyApp()); // 启动应用
}

3. 登录事件跟踪

登录成功后，可以通过 trackLogin() 方法记录用户登录信息。

示例代码：

AppTracking.instance.trackLogin('YOUR_USER_ID', ePassId: 'YOUR_EPASS_ID');

4. 动态事件跟踪

当用户触发某些动态事件（例如点击按钮、滚动页面等），可以使用 trackEvent() 方法记录这些事件。

示例代码：

var content = {
  'key1': 'value1',
  'key2': 'value2',
  'userId': 'your_user_id',
};

AppTracking.instance.trackEvent('your_event_name', content: content);

5. 路由观察器集成

为了跟踪页面导航，可以在 MaterialApp 中添加 CarDoctorObserver 作为路由观察器。

示例代码：

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
      navigatorObservers: [CarDoctorObserver()], // 添加路由观察器
    );
  }
}

完整示例代码

以下是一个完整的示例代码，展示了如何集成 car_doctor_sdk_tracking 插件。

文件：example/lib/main.dart

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized(); // 初始化 Flutter binding
  await AppTracking.instance.init('https://your-base-url.com'); // 初始化插件
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
      navigatorObservers: [CarDoctorObserver()], // 添加路由观察器
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  void initState() {
    // 用户登录时触发跟踪
    AppTracking.instance.trackLogin('userId');
    super.initState();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Builder(builder: (context) {
        return Center(
          child: GestureDetector(
            onTap: () async {
              // 跟踪按钮点击事件
              AppTracking.instance.trackButtonClick('open');
              // 跟踪页面滚动事件
              AppTracking.instance.trackScroll('home', 0.7);
            },
            child: const Icon(Icons.add),
          ),
        );
      }),
    );
  }
}