Flutter集成Qt功能插件qt_common_sdk的使用

本文将详细介绍如何在Flutter项目中集成qt_common_sdk插件，并展示完整的示例代码。

简介

qt_common_sdk插件可以帮助开发者在Flutter应用中集成Qt的功能。通过该插件，您可以实现诸如事件跟踪、属性设置等高级功能。

步骤

1. 添加依赖

首先，在pubspec.yaml文件中添加qt_common_sdk依赖：

dependencies:
  flutter:
    sdk: flutter
  qt_common_sdk: ^1.0.0

2. 初始化SDK

在main.dart文件中初始化qt_common_sdk插件。以下是一个简单的初始化示例：

import 'dart:async';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:qt_common_sdk/qt_common_sdk.dart';
import 'package:qt_common_sdk_example/page/auto_track_page.dart';
import 'package:qt_common_sdk_example/page/auto_track_page_component.dart';
import 'page/auto_track_page_a.dart';
import 'page/auto_track_page_b.dart';
import 'page/auto_track_page_skip.dart';

const kAndroidUserAgent = 
    'Mozilla/5.0 (Linux; Android 6.0; Nexus 5 Build/MRA58N) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/62.0.3202.94 Mobile Safari/537.36';

String selectedUrl = 'file:///android_asset/index.html';

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      initialRoute: '/',
      routes: {
        '/': (_) => const MainPage(title: 'Flutter Demo'),
        '/auto_track': (context) => AutoTrackPage(),
        '/auto_track_a': (context) => AutoTrackPageA(username: ''),
        '/auto_track_b': (context) => AutoTrackPageB(),
        '/auto_track_skip': (context) => AutoTrackPageSkip(),
        '/auto_track_component': (context) => AutoTrackPageComponent(),
      },
      navigatorObservers: QTTrackNavigationObserver.wrap([]),
    );
  }
}

3. 配置和使用SDK

接下来，配置和使用qt_common_sdk插件。以下是在MainPage中配置和使用的示例：

class MainPage extends StatefulWidget {
  final String title;

  const MainPage({Key? key, required this.title}) : super(key: key);

  [@override](/user/override)
  _MainPageState createState() => _MainPageState();
}

class _MainPageState extends State<MainPage> {
  static bool sdkHasInit = false;

  static final String APP_KEY = "your_app_key";
  static final String DOMAIN = "https://your_domain";

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
    if (!sdkHasInit) {
      sdkHasInit = true;
      QTCommonSdk.setCustomDomain(DOMAIN, DOMAIN);
      QTCommonSdk.setLogEnabled(true);
      QTCommonSdk.initCommon(APP_KEY, APP_KEY, '配置发布渠道');
      
      QTAutoTrack()
          .config(QTAutoTrackConfig(
            pageConfigs: [
              QTAutoTrackPageConfig<AutoTrackPage>(
                pageName: 'auto_track',
                pagePath: '/auto_track',
                pageTitle: 'rabby test auto_track',
              ),
              QTAutoTrackPageConfig<AutoTrackPageA>(
                pageName: 'auto_track_a',
                pagePath: '/auto_track_a',
                pageTitle: 'rabby test auto_track_a',
              ),
              QTAutoTrackPageConfig<AutoTrackPageB>(
                pageName: 'auto_track_b',
                pagePath: '/auto_track_b',
                pageTitle: 'rabby test auto_track_b',
              ),
              QTAutoTrackPageConfig<AutoTrackPageSkip>(
                pageName: 'auto_track_skip',
                pagePath: '/auto_track_skip',
                pageTitle: 'rabby test auto_track_skip',
                skipMe: true
              )
            ],
            eventHandler: (model) {
              // 前置回调函数
              QTTrackLogger.i("测试页面", model);
            },
          ))
          .enable()
          .enableLog();
    }
  }

  Future<void> initPlatformState() async {
    String platformVersion;
    try {
      platformVersion = (await QTCommonSdk.platformVersion)!;
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Running on: $_platformVersion'),
        ),
        body: Center(
          child: GridView.count(
            primary: false,
            padding: const EdgeInsets.all(20),
            crossAxisSpacing: 20,
            mainAxisSpacing: 20,
            crossAxisCount: 3,
            children: [
              TextButton(
                style: ButtonStyle(
                  backgroundColor: MaterialStateProperty.all<Color>(Colors.purple.shade500),
                  foregroundColor: MaterialStateProperty.all<Color>(Colors.white),
                  shape: MaterialStateProperty.all<RoundedRectangleBorder>(RoundedRectangleBorder(borderRadius: BorderRadius.circular(20.0))),
                ),
                child: Text("自动埋点测试页面"),
                onPressed: () {
                  Navigator.pushNamed(context, '/auto_track');
                },
              ),
              TextButton(
                style: ButtonStyle(
                  backgroundColor: MaterialStateProperty.all<Color>(Colors.orange.shade500),
                  foregroundColor: MaterialStateProperty.all<Color>(Colors.white),
                  shape: MaterialStateProperty.all<RoundedRectangleBorder>(RoundedRectangleBorder(borderRadius: BorderRadius.circular(20.0))),
                ),
                child: Text("组件测试页"),
                onPressed: () {
                  Navigator.pushNamed(context, '/auto_track_component');
                },
              ),
              TextButton(
                style: ButtonStyle(
                  backgroundColor: MaterialStateProperty.all<Color>(Colors.blue),
                  foregroundColor: MaterialStateProperty.all<Color>(Colors.white),
                  shape: MaterialStateProperty.all<RoundedRectangleBorder>(RoundedRectangleBorder(borderRadius: BorderRadius.circular(20.0))),
                ),
                child: Text("onEvent(testEkv, {name:jack, age:18,id_number:5220891219})"),
                onPressed: () async {
                  QTCommonSdk.onEvent('testEkv', {
                    'name': 'jack',
                    'age': 18,
                    'id_number': 5220891219
                  });
                },
              ),
              // 其他按钮...
            ],
          ),
        ),
      ),
    );
  }
}