FIDL:Flutter與原生通訊的新姿勢,不局限於基礎數據類型


大家好!今天給大家安利一個自認為比較重磅的Flutter開源項目。

Flutter的產品定義是一個高性能的跨平台的移動UI框架,能夠用一套代碼同時構建出Android/iOS/Web/MacOS應用。作為一套UI框架,它不具備一些系統的接口,自然還是避免不了跟原生打交道。於是乎,它提出了名為platform channel的東西,用於flutter和原生靈活的交換數據。以下為了描述方便,用Android代指原生。

 

燃鵝,燃鵝,燃鵝,它只支持一些基礎的數據類型和數據結構的傳輸,例如bool/int/long/byte/char/String/byte[]/List/Map等。

因此,當你想傳輸復雜點的數據,你只能包裝成Map,類似這樣:

await _channel.invokeMethod('initUser', {'name': 'Oscar', 'age': 16, 'gender': 'MALE', 'country': 'China'}); 

然后再在Android層hard code,解析出不同的key對應的不同數據。如果你是一個純fluter項目,且以后也沒有和原生打交道的打算,或者只是需要進行簡單的交互,那這種做法也無可厚非。而當你的項目已經有很大的一部分原生代碼或者你需要使用第三方不支持flutter的lib庫的時候,就意味着你需要編寫大量向上面那樣的模板代碼。可見效率低下,且可維護性差。這時,你會想,能傳輸對象就好了!

而當你想傳輸對象時:

 

抱歉,沒門,只能給你一個尷尬又不是禮貌的危笑。當然,也不是不可以,我們可以在原生上層把對象序列化成json對象,然后在flutter層再把json轉成flutter的對象,同樣效率很差。

FIDL是什么

學過Android的應該都知道AIDL(Android Interface Defination Language),即Android接口定義語言。Android中有一種高級的跨進程通信方式——Binder,但是想要使用Binder需要了解一些Binder的機制和API,需要編寫大量的模板代碼。Android為了解決這個問題,嘗試把使用Binder的方法做的小白一點。於是定義了AIDL,告訴開發者,你的接口文件必須按照我規定的來寫,你要跨進程傳輸的對象必須實現Parcelable接口。然后,Android給你生成了一個Service.Stub類,偷偷的在背后把對象的序列化、反序列化的工作都給做了。開發者使用這個Stub類就能輕松上手Binder這種高級的跨進程通訊方法。(😋😋😋我編的,差不多啦)

FIDL(Flutter Interface Defination Language)即Flutter接口定義語言,它的使命和AIDL很類似,悄悄把對象的序列化、反序列化、自動生成代碼這種“臟活累活”給做了。開發者在原生代碼中看到的類,能通過@FIDL注解標記,自動在Dart側生成和原生代碼中一樣的類。FIDL是一面鏡子,把各種原生平台的類影射到Dart中,把Dart中的類影射到各個原生平台。

少啰嗦,先看東西

 

1、首先是Java類:

public class User { String name; int age; String country; Gender gender; } enum Gender { MALE, FEMALE } 

2、定義FIDL接口

@FIDL public interface IUserService { void initUser(User user); } 

3、執行幾個命令

4、Android側在合適的地方打開IUserServiceStub通道(IUserServiceStub是IUserService的實現類,自動生成的)

FidlChannel.openChannel(getFlutterEngine().getDartExecutor(), new IUserServiceStub() { @Override void initUser(User user){ System.out.println(user.name + " is " + user.age + "years old!"); } } 

5、Flutter側使用IUserService 通道

// 綁定通道(IUserService類是自動生產的哦) await Fidl.bindChannel(IUserService.CHANNEL_NAME, _channelConnection); // 使用User類(`User類`以及它使用的`Gender枚舉`是自動生成的哦) User user = User(); user.name = 'Oscar'; user.age = 18; user.gender = Gender.MALE; user.country = 'China'; // 調用通道方法 await IUserService.initUser(user); 

編譯,運行,你將能在Logcat中看到Oscar is 18 years old!

FIDL使用詳解

這一部分是對少啰嗦,先看東西部分的補充解釋,觀眾姥爺們可以自行跳過。

上面的例子中的Map,一般來說,在Java中會對應一個類:

public class User { String name; int age; String country; Gender gender; } enum Gender { MALE, FEMALE } 

如果想讓flutter傳輸這個對象而不用在flutter層手動去編寫User這個類,以及編寫fromJson/toJson方法,你可以這樣做:

1、定義一個接口,添加注解@FIDL。這個注解將告知annotationProcessor生成一些接口和類的描述文件。

@FIDL public interface IUserService { void initUser(User user); } 

2、Android Studio點擊sync,或者執行:

./gradlew assembleDebug

然后就會產生一堆json文件,如下:

 

這些json文件就是FIDL和類的描述文件。沒錯,也會同時生成User引用的Gender類的描述文件。

同時,還會生成IUserService的實現IUserServiceStub。即:

  • com.infiniteloop.fidl_example.IUserService.fidl.json
  • com.infiniteloop.fidl_example.User.json
  • com.infiniteloop.fidl_example.Gender.json
  • com.infiniteloop.fidl_example.IUserServiceStub.java

3、進入到你的flutter項目,在lib目錄下創建fidl目錄,把上面的json文件拷貝到這個目錄,然后執行:

flutter packages pub run fidl_model 

然后就能在fidl目錄下自動生成相關的dart類:

 

即:

  • User.dart
  • Gender.dart
  • IUserService.dart

4、使用

a. Android側在合適的地方打開IUserServiceStub通道

FidlChannel.openChannel(getFlutterEngine().getDartExecutor(), new IUserServiceStub() { @Override void initUser(User user){} } 

b. Flutter側綁定IUserService通道

await Fidl.bindChannel(IUserService.CHANNEL_NAME, _channelConnection); 

c、Flutter調用通道方法

await IUserService.initUser(User()); 

d、Flutter可以在合適的時候接觸綁定

await Fidl.unbindChannel(IUserService.CHANNEL_NAME, _channelConnection); 

e、Android側可以在合適的時候關閉通道

FidlChannel.closeChannel(userServiceStub); 

當然,FIDL的功能不止於此

1、多個參數的FIDL接口

void init(String name, Integer age, Gender gender, Conversation conversation); 

2、帶返回值的FIDL接口

UserInfo getUserInfo(); 

3、支持泛型類的生成

public class User<T> { T country; } public class AUser<String>{} 

FIDL接口:

void initUser(AUser user); 

將能在dart側生成AUser和User類,且能保持繼承關系。

4、傳遞枚舉

void initEnum0(EmptyEnum e); String initEnum1(MessageStatus status); 

5、傳遞集合、Map

void initList0(List<String> ids); void initList1(Collection<String> ids); void initList7(Stack<String> ids); void initList10(BlockingQueue ids); 

6、傳遞復雜對象。繼承、抽象、泛型、枚舉和混合類,來一個打一個。

當然,FIDL能做的不止於此

現在,FIDL項目只實現了從Dart側調用Android側的方法。還有以下工作要做:

  • Android側調用Dart側的方法
  • 其它平台和Flutter方法的互相調用
  • EventChannel,EventChannel本質上是可以通過MethodChannel實現的,問題不大

搞定了對象傳輸,這些問題,都是小case啦。

對於對象的序列化和反序列化

為了能滿足大佬們的定制化需求,我分別在Java側和Flutter側定義了序列化/反序列化的接口類。

Java:

public interface ObjectCodec { List<byte[]> encode(Object... objects); <T> T decode(byte[] input, TypeLiteral<T> type); } 

Dart:

abstract class ObjectCodec { dynamic decode(Uint8List input); List<Uint8List> encode(List objects); } 

目前使用的是JsonObjectCodec,經過JSON的編解碼,性能會稍差。后面還希望和小伙伴們一起努力,實現更高效的編解碼。

項目進度

上述提到的功能,只要是從Flutter側調用Java側的方法相關的,大部分都已經實現了。

我做了一個Demo,模擬了一個在Android側依賴了IM(即時通訊)SDK,需要在Flutter側聊天、獲取消息、發消息的場景。以下是Demo的截圖:

1、首頁,點擊按鈕調用Android側方法,開啟聊天服務

 

2、聊天頁面

 

3、發一條消息給Lucy並獲取和Lucy的聊天記錄

 

4、調用Android側方法發送N條消息給Wilson並獲取聊天記錄

 

作者:小玩童
鏈接:https://juejin.im/post/5e6f23eef265da574f355950
來源:掘金


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM