Flutter中运行小程序的插件mop的使用

FinClip 是什么?

FinClip 提供了一种在移动应用中运行小程序的能力。通过集成 FinClip SDK，开发者可以在自己的 APP 中运行已开发的小程序，且支持自定义接口和样式调整。这使得一次开发的小程序能够在不同的应用中复用。

Flutter 使用注意

尽管 FinClip 小程序技术主要通过 SDK 向应用程序提供运行小程序的功能，但需要注意的是，长期未更新的文件并不意味着“年久失修”。实际上，FinClip 保持了对 Flutter 环境中的 SDK 资源进行定期更新。如果在集成或使用过程中遇到任何问题，可以联系官方获取帮助。

Flutter 集成步骤

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

dependencies:
  mop: latest.version

确保替换 latest.version 为实际的最新版本号。

示例代码

下面是一个完整的示例，展示了如何初始化 SDK 并打开小程序：

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

void main() => runApp(MyApp());

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    init();
  }

  Future<void> init() async {
    // 初始化配置
    FinStoreConfig storeConfigA = FinStoreConfig(
      "your_sdk_key",
      "your_sdk_secret",
      "https://api.finclip.com",
      cryptType: "SM",
    );
    List<FinStoreConfig> storeConfigs = [storeConfigA];
    Config config = Config(storeConfigs);
    config.language = LanguageType.English;
    config.userId = "user12345";
    config.channel = "finclip";

    UIConfig uiConfig = UIConfig();
    uiConfig.isHideBackHome = true;

    final res = await Mop.instance.initSDK(config, uiConfig: uiConfig);
    if (!mounted) return;
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('FinClip 小程序 Demo')),
        body: Center(
          child: Column(
            children: <Widget>[
              FlatButton(
                onPressed: () {
                  Mop.instance.openApplet('your_applet_id');
                },
                child: Text('打开小程序'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

主要功能介绍

1. 初始化小程序

初始化 SDK 是使用所有其他 API 的前提条件。可以通过如下方式初始化：

final res = await Mop.instance.initSDK(config, uiConfig: uiConfig);

2. 打开小程序

可以使用以下方法来打开小程序：

Mop.instance.openApplet('your_applet_id', path: '/pages/index/index', query: 'key=value');

3. 获取当前正在使用的小程序信息

Map<String, dynamic> currentAppletInfo = await Mop.instance.currentApplet();

4. 注册拓展 API

允许注册自定义 API，以便于小程序内调用这些自定义服务：

Mop.instance.registerExtensionApi('customApiName', customApiHandler);