Kotlin/Native 用KMM寫Flutter插件

2021 年 10 月 28 日
筆記
Android, KMM

一、用KMM寫Flutter插件

Google官方有一個寫Flutter例子How to write a Flutter plugin，這裡把Google plugin_codelab 例子改成用KMM寫Flutter插件。

二、如何運行

Github項目地址：kmm-flutter-plugin

Android: run shared/plugin_codelab/example/android

iOS:

1、build shared.framework

use ./gradlew releaseIOSFramework
or use new version Android Studio sync

2、run shared/plugin_codelab/example/ios

Tips: before run，shared/build/cocoapods/framework/shared.framework should be generated. The shared.h header file shared/build/cocoapods/framework/shared.framework/Headers/shared.h is generated.

三、設計思路

Android/iOS插件PluginCodelabPlugin只需要實現KMM Module的接口，不寫任何邏輯，把邏輯通過接口放在KMM Module中。

1、定義接口中間層用於轉發數據

如參考Flutter插件的MethodCall、MethodChannel，定義CommonMethodCall數據類、CommonMethodChannel.Result接口。

data class CommonMethodCall(
    val method: String,
    val arguments: Any?,
)

class CommonMethodChannel {
    interface Result {
        fun success(result: Any?)

        fun error(errorCode: String?, errorMessage: String?, errorDetails: Any?)

        fun notImplemented()
    }
}

2、在KMM中的commonMain實現CommonCodelabPlugin插件的公共邏輯

CommonCodelabPlugin需要初始化並啟動synth?.start()，處理getPlatformVersion、onKeyDown、onKeyUp邏輯。

class CommonCodelabPlugin {

    private val synth = Synth()

    init {
        synth?.start()
    }

    fun onMethodCall(call: CommonMethodCall, result: CommonMethodChannel.Result) {
        when (call.method) {
            "getPlatformVersion" -> {
                result.success(Platform().platform)
            }
            "onKeyDown" -> {
                try {
                    val arguments = call.arguments as List<*>
                    val numKeysDown = synth?.keyDown((arguments[0] as Int))
                    result.success(numKeysDown)
                } catch (ex: Exception) {
                    result.error("1", ex.message, ex.cause)
                }
            }
            "onKeyUp" -> {
                try {
                    val arguments = call.arguments as List<*>
                    val numKeysDown = synth?.keyUp((arguments[0] as Int))
                    result.success(numKeysDown)
                } catch (ex: Exception) {
                    result.error("1", ex.message, ex.cause)
                }
            }
            else -> {
                result.notImplemented()
            }
        }
    }
}

還有包括插件名稱也屬於公共邏輯

// 插件Channel名稱
const val PLUGIN_CODE_LAB_CHANNEL = "plugin_codelab"

3、實現平台差異特性

這裡只列出expect接口，具體實現平台差異特性類請查看源碼

expect class Synth() {
    fun start()

    fun keyDown(key: Int): Int

    fun keyUp(key: Int): Int
}

expect class Platform() {
    val platform: String
}

4、Android Flutter實現插件KMM接口

Android Flutter實現插件KMM接口，注意這裡只實現接口用於中轉Flutter與Android/iOS 數據，不能有任何業務邏輯

class PluginCodelabPlugin : FlutterPlugin, MethodCallHandler {
    private var channel: MethodChannel? = null
    private var commonCodelabPlugin: CommonCodelabPlugin? = null

    override fun onAttachedToEngine(flutterPluginBinding: FlutterPlugin.FlutterPluginBinding) {
        setup(this, flutterPluginBinding.binaryMessenger)
    }

    override fun onMethodCall(call: MethodCall, result: MethodChannel.Result) {
        commonCodelabPlugin?.onMethodCall(
            call = CommonMethodCall(call.method, call.arguments),
            result = object : CommonMethodChannel.Result {
                override fun success(successResult: Any?) {
                    result.success(successResult)
                }

                override fun error(errorCode: String?, errorMessage: String?, errorDetails: Any?) {
                    result.error(errorCode, errorMessage, errorDetails)
                }

                override fun notImplemented() {
                    result.notImplemented()
                }
            })
    }

    override fun onDetachedFromEngine(binding: FlutterPlugin.FlutterPluginBinding) {
        channel?.setMethodCallHandler(null)
    }

    companion object {
        private fun setup(plugin: PluginCodelabPlugin, binaryMessenger: BinaryMessenger) {
            plugin.channel = MethodChannel(binaryMessenger, PLUGIN_CODE_LAB_CHANNEL)
            plugin.channel?.setMethodCallHandler(plugin)
            plugin.commonCodelabPlugin = CommonCodelabPlugin()
        }
    }
}

5、iOS Flutter實現插件KMM接口

Android Flutter實現插件KMM接口，注意這裡只實現接口用於中轉Flutter與Android/iOS 數據，不能有任何業務邏輯

#import "PluginCodelabPlugin.h"

@implementation PluginCodelabPlugin{
  int _numKeysDown;
  FlutterResult _flutterResult;
  SharedCommonCodelabPlugin* _codelabPlugin;
}

- (instancetype)init {
  self = [super init];
  if (self) {
    // create music
    _codelabPlugin = [[SharedCommonCodelabPlugin alloc] init];
  }
  return self;
}

- (void)dealloc {
    // destroy music
}

+ (void)registerWithRegistrar:(NSObject<FlutterPluginRegistrar>*)registrar {
  FlutterMethodChannel* channel = [FlutterMethodChannel
      methodChannelWithName: SharedPluginCodeLabKt.PLUGIN_CODE_LAB_CHANNEL
            binaryMessenger:[registrar messenger]];
  PluginCodelabPlugin* instance = [[PluginCodelabPlugin alloc] init];
  [registrar addMethodCallDelegate:instance channel:channel];
}

- (void)handleMethodCall:(FlutterMethodCall *)call
                  result:(FlutterResult)result {
    SharedCommonMethodCall *methodCall = [[SharedCommonMethodCall alloc] initWithMethod:call.method arguments:call.arguments];
    _flutterResult = result;
    [_codelabPlugin onMethodCallCall:methodCall result:self ];
}

- (void)errorErrorCode:(NSString * _Nullable)errorCode errorMessage:(NSString * _Nullable)errorMessage errorDetails:(id _Nullable)errorDetails {
    NSError *error = [NSError errorWithDomain:NSCocoaErrorDomain code:errorCode.intValue userInfo:@{@"errorMessage":errorMessage, @"errorDetails":errorDetails}];
    if (_flutterResult) {
        _flutterResult(error);
    }
}

- (void)notImplemented {
    if (_flutterResult) {
        _flutterResult(FlutterMethodNotImplemented);
    }
}

- (void)successResult:(id _Nullable)result {
    if (_flutterResult) {
        _flutterResult(result);
    }
}

@end

到這裡，已經完成了使用KMM開發一個Flutter插件。使用KMM開發插件的好處是公共邏輯都使用kotlin寫，一般公共邏輯比較簡單適合使用kotlin寫，便於維護。而且，實現了KMM寫插件，Flutter寫UI。

四、參考鏈接

本文地址：//www.cnblogs.com/liqw/p/15477079.html
Github項目地址：kmm-flutter-plugin

Tags: Android KMM