uni_flutter_plugin 是一个用于在 Flutter 项目中集成 UniApp 功能的插件。它允许开发者在 Flutter 应用中使用 UniApp 提供的一些原生功能，比如调用原生模块、使用原生 UI 组件等。以下是使用 uni_flutter_plugin 的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 uni_flutter_plugin 的依赖：

dependencies:
  flutter:
    sdk: flutter
  uni_flutter_plugin: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来获取依赖。

2. 初始化插件

在 Flutter 项目的 main.dart 文件中初始化 uni_flutter_plugin：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await UniFlutterPlugin.init(); // 初始化插件
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Uni Flutter Plugin Example'),
        ),
        body: Center(
          child: Text('Hello, Uni Flutter Plugin!'),
        ),
      ),
    );
  }
}

3. 使用插件功能

uni_flutter_plugin 提供了多种功能，你可以根据需要在项目中使用。以下是一些常见的使用示例：

3.1 调用原生方法

你可以使用 UniFlutterPlugin.callNativeMethod 来调用原生方法：

Future<void> callNativeMethod() async {
  try {
    var result = await UniFlutterPlugin.callNativeMethod('methodName', {'param1': 'value1'});
    print('Native method result: $result');
  } catch (e) {
    print('Error calling native method: $e');
  }
}

3.2 使用原生 UI 组件

你可以使用 UniFlutterPlugin.createNativeView 来创建原生 UI 组件：

Widget createNativeView() {
  return UniFlutterPlugin.createNativeView(
    viewType: 'nativeViewType',
    creationParams: {'param1': 'value1'},
    creationParamsCodec: StandardMessageCodec(),
  );
}

3.3 监听原生事件

你可以使用 UniFlutterPlugin.onEvent 来监听原生事件：

StreamSubscription<dynamic>? _eventSubscription;

void listenToNativeEvents() {
  _eventSubscription = UniFlutterPlugin.onEvent.listen((event) {
    print('Received event from native: $event');
  });
}

@override
void dispose() {
  _eventSubscription?.cancel();
  super.dispose();
}

4. 处理原生代码

在 Android 和 iOS 平台上，你需要编写原生代码来处理 Flutter 端的调用。以下是一个简单的示例：

4.1 Android

在 MainActivity.java 中注册方法通道：

import io.flutter.embedding.android.FlutterActivity;
import io.flutter.embedding.engine.FlutterEngine;
import io.flutter.plugin.common.MethodChannel;

public class MainActivity extends FlutterActivity {
    private static final String CHANNEL = "com.example.uni_flutter_plugin/native";

    @Override
    public void configureFlutterEngine(FlutterEngine flutterEngine) {
        super.configureFlutterEngine(flutterEngine);
        new MethodChannel(flutterEngine.getDartExecutor().getBinaryMessenger(), CHANNEL)
            .setMethodCallHandler(
                (call, result) -> {
                    if (call.method.equals("methodName")) {
                        // 处理原生方法
                        result.success("Response from native");
                    } else {
                        result.notImplemented();
                    }
                }
            );
    }
}

4.2 iOS

在 AppDelegate.swift 中注册方法通道：

import UIKit
import Flutter

[@UIApplicationMain](/user/UIApplicationMain)
[@objc](/user/objc) class AppDelegate: FlutterAppDelegate {
    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        let controller = window?.rootViewController as! FlutterViewController
        let channel = FlutterMethodChannel(name: "com.example.uni_flutter_plugin/native",
                                           binaryMessenger: controller.binaryMessenger)
        channel.setMethodCallHandler({
            (call: FlutterMethodCall, result: @escaping FlutterResult) -> Void in
            if call.method == "methodName" {
                // 处理原生方法
                result("Response from native")
            } else {
                result(FlutterMethodNotImplemented)
            }
        })
        GeneratedPluginRegistrant.register(with: self)
        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
}