FIDL：Flutter与原生通讯的新姿势，不局限于基础数据类型

2301_82241775

704人浏览 · 2024-04-30 22:06:16

2301_82241775 · 2024-04-30 22:06:16 发布

首先是Java类：

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

Android侧

1、定义FIDL接口

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

2、执行命令./gradlew assembleDebug，生成IUserServiceStub类和fidl.json文件

3、打开通道，向Flutter公开方法

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

Flutter侧

1、拷贝fidl.json文件到fidl目录，执行命令flutter packages pub run fidl_model，生成Dart接口类

2、绑定Android侧的IUserServiceStub通道

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

3、调用公开方法

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方法，你可以这样做：

Android侧

1、定义一个接口，添加注解@FIDL。这个注解将告知annotationProcessor生成一些接口和类的描述文件。

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

接口方法的限制如下：

由于dart不支持方法重载，所以接口中不能出现同名方法
参数只支持实体类，不支持回调
由于JSON解码的限制，Java需要有无参构造函数

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

限制：只能生成有强引用关系的FIDL文件，被FIDL接口强引用的类的子类如果没有被FIDL接口强引用，则不会生成相应的描述文件。

3、在合适的地方打开通道，向Flutter公开方法

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

4、如有需要，可以在合适的地方关闭通道

FidlChannel.closeChannel(userService);

关闭的消息将通知到Flutter侧。