Flutter插件conch_api的介绍与使用方法

Flutter插件conch_api的简介

conch_api 是一个用于定义 conch loader 的 API。它主要用于动态加载补丁文件，并支持多种功能如补丁信息更新、加载状态监控等。本文将通过一个完整的示例代码展示如何在 Flutter 中使用 conch_api 插件。

示例代码

以下是一个完整的 Flutter 示例代码，展示了如何初始化 conch_loader 并实现补丁加载的功能。

import 'dart:io';

import 'package:example/router.dart';
import 'package:flutter/material.dart';
import 'package:conch_api/conch_api.dart';

void main() async {
  runApp(MaterialApp(home: MyApp()));
}

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

  static BuildContext? context;

  [@override](/user/override)
  Widget build(BuildContext context) {
    MyApp.context = context;
    return MaterialApp(
      title: "Conch示例",
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(
        title: "Conch示例",
      ),
      onGenerateRoute: ExampleRoute.onGenerateRoute,
    );
  }
}

/// 首页
class MyHomePage extends StatefulWidget {
  MyHomePage({
    Key? key,
    required this.title,
  }) : super(key: key);

  final String title;

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

class _MyHomePageState extends State<MyHomePage> {
  String patchInfoDesc = "补丁信息：None";
  String patchLoadDesc = "未触发";

  [@override](/user/override)
  void initState() {
    super.initState();
    _initConchLoader();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Container(
        alignment: Alignment.center,
        padding: EdgeInsets.all(16),
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Container(
              width: 200,
              child: OutlinedButton(
                onPressed: () {
                  Navigator.pushNamed(context, "image");
                },
                child: Text('图片'),
              ),
            ),
            Container(
              width: 200,
              child: OutlinedButton(
                onPressed: () {
                  Navigator.pushNamed(context, "list");
                },
                child: Text('列表'),
              ),
            ),
            Container(
              width: 200,
              child: OutlinedButton(
                onPressed: () {
                  Navigator.pushNamed(context, "anim");
                },
                child: Text('动画'),
              ),
            ),
            Container(
              width: 200,
              child: OutlinedButton(
                onPressed: () {
                  Navigator.pushNamed(context, "touch");
                },
                child: Text('拖拽'),
              ),
            ),
            Container(
              width: 200,
              child: OutlinedButton(
                onPressed: () {
                  Navigator.pushNamed(context, "loop");
                },
                child: Text('循环/通信'),
              ),
            ),
            Container(
              margin: EdgeInsets.only(left: 10, top: 100, right: 10),
              child: Text(
                "$patchInfoDesc",
                textDirection: TextDirection.ltr,
              ),
            ),
            Container(
              margin: EdgeInsets.only(left: 10, top: 5, right: 10),
              child: Text(
                "加载状态：$patchLoadDesc",
                textDirection: TextDirection.ltr,
              ),
            ),
            Container(
              width: 200,
              margin: EdgeInsets.only(left: 10, top: 5, right: 10),
              child: OutlinedButton(
                onPressed: () {
                  ConchLoaderAPI.getPatchLoadResult(preload: true);
                },
                child: Text('加载补丁'),
              ),
            ),
          ],
        ),
      ),
    );
  }

  /// 初始化ConchLoader
  void _initConchLoader() {
    // 自定义日志输出
    ConchLoaderAPI.setCustomLogger((level, tag, message) {
      print('[Custom ${level.toString().split('.').last[0]}] $tag: $message');
    });

    // 初始化参数
    final appId = Platform.isAndroid ? "f17bd7de78" : "019c4398e4";
    final appKey = Platform.isAndroid ? "e7993b46-6140-4c86-acd6-f90b502a0ca5" : "e57ae316-38ee-47fe-9d21-827115e39e76";
    final params = ConchParams(
      appId: appId,
      appKey: appKey,
      moduleName: "conch_module",
      deviceId: "12345",
      appVersion: "1.0.0",
      remoteFirst: true,
      debugEnable: true,
    );

    // 补丁加载结果回调
    PatchLoadCallback patchLoadCallback = (patchLoadResult) => _updatePatchLoadResult(patchLoadResult);

    ConchLoaderAPI.init(params, patchLoadCallback: patchLoadCallback);
  }

  /// 更新补丁加载结果
  void _updatePatchLoadResult(PatchLoadResult? patchLoadResult) {
    setState(() {
      if (patchLoadResult == null) {
        patchInfoDesc = "补丁信息：NULL";
        patchLoadDesc = "NULL";
      } else {
        final moduleName = patchLoadResult.moduleName;
        final md5 = patchLoadResult.md5.isEmpty ? '' : patchLoadResult.md5.substring(0, 8);
        final version = patchLoadResult.version;

        patchInfoDesc = "模块: $moduleName  版本: $version  MD5: $md5";
        patchLoadDesc = patchLoadResult.resultCode.name;
      }
    });
  }
}