☝点击上方蓝字,关注我们!
本文字数:3705字
预计阅读时间:28分钟
导 读
Flutter又双叒叕来了!本周推送是我们Flutter系列文章的最终篇!《Flutter移动端实战手册》回归实际应用场景,详细讲述Flutter在移动端的应用实践。话不多说,让我们一起来阅读这篇Flutter系列文章的收官之作吧~
Flutter系列文章一共分为三篇:
1.:详细介绍了Flutter整体架构及未来发展前景,并且对Flutter的特性和Dart语言进行了详细介绍。
2.
3.《Flutter移动端实战手册》:详细讲述Flutter跨平台实现方案,以及DevTools调试工具集。
iOS接入Flutter
在进行iOS
和Flutter
的混编时,iOS
比Android
的接入方式略复杂,但也还好。现在市面上有不少接入Flutter
的方案,但大多数都是千篇一律相互抄的,没什么意义。
进行Flutter
混编之前,有一些必要的文件:
xcode_backend.sh
文件,在配置flutter
环境的时候由Flutter
工具包提供;xcconfig
环境变量文件,在Flutter
工程中自动生成,每个工程都不一样。
xcconfig文件
xcconfig
是Xcode
的配置文件,Flutter
在里面配置了一些基本信息和路径,接入Flutter
前需要先将xcconfig
接入进来,否则一些路径和信息将会出错或找不到。
Flutter
的xcconfig
包含三个文件,Debug.xcconfig
、Release.xcconfig
、Generated.xcconfig
,需要将这些文件配置在下面的位置,并且按照不同环境配置不同的文件。
1Project -> Info -> Development Target -> Configurations
<<向左滑动查看完整代码>>
有些比较大的工程已经在Configurations
中设置了xcconfig
文件,由于每个Target
的一种环境只能配置一个xcconfig
文件,所以可以在已有的xcconfig
文件中import
引入Generated.xcconfig
文件,并且不需要区分环境。
脚本文件
脚本文件用来构建和导出Flutter
产物,这是Flutter
开发包为我们默认提供的,需要在工程Target
的Build Phases
加入一个Run Script
文件,并将下面的脚本代码粘贴进去。需要注意的是,不要忘记前面的/bin/sh
操作,否则会导致权限错误。
1/bin/sh "$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh" build
2/bin/sh "$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh" embed
<<向左滑动查看完整代码>>
在xcode_backend.sh
中有三个参数类型,build
、thin
、embed
,thin
没有太大意义,其他两个则负责构建和导出。
混合开发
随后可以对Xcode
工程进行编译,这时候肯定会报错的,但是不要慌张,报错后我们在工程主目录下会发现一个名为Flutter
的文件夹,其中会包含两个framework
,这个文件夹就是Flutter
的编译产物,我们将这个文件夹整体拖入项目中即可。
这时候就可以在iOS
工程中添加Flutter
代码了,下面是详细步骤:
1.将AppDelegate
的集成改为FlutterAppDelegate
,并且需要遵循FlutterAppLifeCycleProvider
代理;
1#import
2#import
3
4@interface AppDelegate : FlutterAppDelegate
5
6@end
<<向左滑动查看完整代码>>
2.创建一个FlutterPluginAppLifeCycleDelegate
的实例对象,这个对象负责管理Flutter
的生命周期,并从Platform
侧接收AppDelegate
的事件。我直接将其声明为一个属性,在AppDelegate
的各个方法中,调用其方法进行中转操作;
1- (BOOL)application:(UIApplication *)application willFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
2 [self.lifeCycleDelegate application:application willFinishLaunchingWithOptions:launchOptions];
3 return YES;
4}
5
6- (void)applicationWillResignActive:(UIApplication *)application {
7 [self.lifeCycleDelegate applicationWillResignActive:application];
8}
9
10 - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {
11 [self.lifeCycleDelegate application:application openURL:url sourceApplication:sourceApplication annotation:annotation];
12 return YES;
13}
<<向左滑动查看完整代码>>
3.随后即可加入Flutter
代码,加入的方式也很简单,直接实例化一个FlutterViewController
控制器即可,也不需要传其他参数进去(这里先不考虑多实例的问题);
1FlutterViewController *flutterViewController = [[FlutterViewController alloc] init];
<<向左滑动查看完整代码>>
Flutter
将其看做是一个画布,实例化一个画布上去之后,任何操作其实都是在当前页面完成的。
常见错误
到这个步骤集成操作就已经完成,但是很多人在集成过程中会遇到一些错误,下面是一些常见错误:
路径错误,读取不到
xcode_backend.sh
文件等。这是因为环境变量FLUTTER_ROOT
没有获取到,FLUTTER_ROOT
配置在Generated.xcconfig
中,可以看一下这个文件是不是配置地有问题;lipo info *** arm64
类似这样的错误,一般都是因为xcode_backend.sh
脚本导致的,可以检查一下FLUTTER_ROOT
环境变量是否正确;下面这种问题一般都是因为权限导致的,可以查看
Build Phases
的脚本写的是不是有问题。
1***/flutter_tools/bin/xcode_backend.sh: Permission denie
混合开发
在进行混编过程中,Flutter
有一个很大的优势,就是如果Flutter
代码出问题,不会导致原生应用的崩溃。当Flutter
代码出现崩溃时,会在屏幕上显示错误信息。
在开发过程中经常会涉及到网络请求和持久化的问题,如果混编的话可能会涉及到写两套逻辑,例如网络请求有一些公共参数,或返回数据的统一处理等,如果维护两套逻辑的话会容易出问题。所以,建议将网络请求和持久化操作都交给Platform
处理,Flutter
侧只负责向Platform
请求并拿来使用即可。
这个过程就涉及到两端数据交互的问题,Flutter
对于混编给出了两套方案,MethodChannel
和EventChannel
。从名字上来看,一个是方法调用,另一个是事件传递。但实际开发过程中,只需要使用MethodChannel
即可完成所有需求。
Flutter to Native
下面是Flutter
调用Native
的代码,在Native
中通过FlutterMethodChannel
设置指定的回调代码,并且接收参数并处理。由Flutter
通过MethodChannel
对Native
发起调用,并传入对应的参数。
代码中在Flutter
侧构建好数据模型,然后调用MethodChannel
的invokeMethod
,会触发Native
的回调。Native
拿到Flutter
传过来的数据,进行解析并执行播放操作,随后会把播放的状态码回调给Flutter
侧,交互完成。
1import 'package:flutter/services.dart';
2
3Future playVideo() async{
4 var methodChannel = MethodChannel('flutterChannelName');
5 Map params = {'playID' : '302998298', 'duration' : '2520', 'name' : '三生三世十里桃花'};
6 String result;
7 result = await methodChannel.invokeMethod('PlayAlbumVideo', params);
8
9 String playID = params['playID'];
10 String duration = params['duration'];
11 String name = params['name'];
12 showCupertinoDialog(context: context, builder: (BuildContext context){
13 return CupertinoAlertDialog(
14 title: Text(result),
15 content: Text('name:$name playID:$playID duration:$duration'),
16 actions: [
17 FlatButton(
18 child: Text('确定'),
19 onPressed: (){
20 Navigator.pop(context);
21 },
22 )
23 ],
24 );
25 });
26}
<<向左滑动查看完整代码>>
1NSString *channelName = @"flutterChannelName";
2FlutterMethodChannel *methodChannel = [FlutterMethodChannel methodChannelWithName:channelName binaryMessenger:flutterVC];
3[methodChannel setMethodCallHandler:^(FlutterMethodCall * _Nonnull call, FlutterResult _Nonnull result) {
4 if ([call.method isEqualToString:@"PlayAlbumVideo"]) {
5 NSDictionary *params = call.arguments;
6
7 VideoPlayerModel *model = [[VideoPlayerModel alloc] init];
8 model.playID = [params stringForKey:@"playID"];
9 model.duration = [params stringForKey:@"duration"];
10 model.name = [params stringForKey:@"name"];
11 NSString *playStatus = [SVHistoryPlayUtil playVideoWithModel:model
12 showPlayerVC:self.flutterVC];
13
14 result([NSString stringWithFormat:@"播放状态 %@", playStatus]);
15 }
16}];
<<向左滑动查看完整代码>>
Native to Flutter
Native
调用Flutter
的代码和Flutter
调用Native
的基本类似,只是调用和设置回调的角色不同。同样的,Flutter
由于要接收Native
的消息回调,所以需要注册一个回调,由Native
发起对Flutter
的调用并传入参数。
Native
和Flutter
的相互调用都需要设置一个名字,每一个名字对应一个MethodChannel
对象,每一个对象可以发起多次调用,不同调用以invokeMethod
做区分。
1import 'package:flutter/services.dart';
2
3@override
4void initState() {
5 super.initState();
6
7 MethodChannel methodChannel = MethodChannel('nativeChannelName');
8 methodChannel.setMethodCallHandler(callbackHandler);
9}
10
11Future callbackHandler(MethodCall call) {
12 if(call.method == 'requestHomeData') {
13 String title = call.arguments['title'];
14 String content = call.arguments['content'];
15 showCupertinoDialog(context: context, builder: (BuildContext context){
16 return CupertinoAlertDialog(
17 title: Text(title),
18 content: Text(content),
19 actions: [
20 FlatButton(
21 child: Text('确定'),
22 onPressed: (){
23 Navigator.pop(context);
24 },
25 )
26 ],
27 );
28 });
29 }
30}
<<向左滑动查看完整代码>>
1NSString *channelName = @"nativeChannelName";
2FlutterMethodChannel *methodChannel = [FlutterMethodChannel methodChannelWithName:channelName binaryMessenger:flutterVC];
3[RequestManager requestWithURL:url success:^(NSDictionary *result) {
4 [methodChannel invokeMethod:@"requestHomeData" arguments:result];
5}];
<<向左滑动查看完整代码>>
调试工具集
在iOS
和Android
开发中,各自的编译器都提供了很好的调试工具集,方便进行内存、性能、视图等调试。Flutter
也提供了调试工具和命令,下面基于VSCode
编译器来讲一下Flutter
调试,相对而言Android Studio
提供的调试功能可能会更多一些。
Dart DevTools
VSCode
为Flutter
提供了一套调试工具集-Dart DevTools
,这套工具集功能非常全,包含性能、UI、热更新、热重载、log日志等很多功能。
安装Dart DevTools
后,在App运行状态下,可以在VSCode
的右下角启动这个工具,工具会以网页的形式展现,并且可以控制App。
主界面
下面是Dart DevTools
的主界面,我运行的是一个界面类似于微信的App。从Inspector
中可以看到页面的视图结构,Android Studio
也有类似的功能。页面整体是一个树形结构,并且选中某一个控件后,会在右侧展示出控件的变量值,例如frame
、color
等,这个功能非常实用。
我运行的设备是Xcode
模拟器,如果想切换Android
的Material Design
,点击上面的iOS
按钮即可直接切换设备。刚才上面说到的查看内存的性能面板,点击iOS
按钮旁边的Performance Overlay
即可出现。
Memory
Dart DevTools
中提供的内存调试工具更加直观,可以实时显示内存使用情况。在刚开始运行时,我们发现一个内存峰值,把鼠标放上去可以看到具体的内存使用情况。内存会有具体分类:Used
、GC
等。
Dart DevTools
的内存工具还是不够完美,Xcode
可以选择某段内存,看到这块内存中涉及到主要堆栈调用,并且点击调用栈可以跳转到Xcode
对应的代码中,而Dart DevTools
还不具备这个功能,可能和Web
的展示形式有关系。
内存管理Flutter
使用的是GC
,回收速度可能不是很快,iOS
中的ARC
则是基于引用计数立即回收的。还有很多其他的功能,这里就不一一详细叙述了,各位同学可以自己探索。
多实例
项目中是通过实例化FlutterViewController
控制器来显示Flutter
界面的,整个Flutter
页面可以理解为一个画布,通过页面不断的变化,改变画布上的东西。所以,在单实例的情况下,Flutter
页面中间不能插入原生页面。
这时候如果我们想在多个地方展示Flutter
页面,而这些页面并不是Flutter -> Flutter
的连贯跳转形式,那怎么来实现这个场景呢?Google
的建议是创建Flutter
的多实例,并通过传入不同的参数实例化不同的页面,但这样会造成很严重的内存问题,所以并不能这么做。
Router
如果不能真正创建多个实例对象,那就需要通过其他方式来实现多实例。Flutter
页面显示其实并不是跟着FlutterVC
走的,而是跟着FlutterEngine
走的,所以在创建一次FlutterVC
之后,就将FlutterEngine
保存下来,在其他位置创建FlutterVC
时直接通过FlutterEngine
的方式创建,并且在创建后进行跳转操作。
在进行页面切换时,通过channelMethod
调用Flutter
侧的路由切换代码,并将切换后的新页面FlutterVC
添加到Native
上。这种实现方式,就是通过Flutter
的Router
的方式实现的,下面将会介绍Router
的两种表现形式,静态路由和动态路由。
静态路由
静态路由是MaterialApp
提供的一个API
,routes
本质上是一个Map
对象,其组成结构key
是调用页面唯一的标识符,value
就是对应页面的Widget
。
在定义静态路由时,可以在创建Widget
时传入参数,例如实例化ContactWidget
时就可以传入对应的参数过去。
1void main() {
2 runApp(
3 MaterialApp(
4 home: Page2(),
5 routes: {
6 'page1': (_) => Page1(),
7 'page2': (_) => Page2()
8 },
9 ),
10 );
11}
12
13class Page1 extends StatelessWidget {
14 @override
15 Widget build(BuildContext context) {
16 return ContactWidget();
17 }
18}
19
20class Page2 extends StatelessWidget {
21 @override
22 Widget build(BuildContext context) {
23 return HomeScreen();
24 }
25}
<<向左滑动查看完整代码>>
进行页面跳转时,通过Navigator
进行调用,每次调用都会重新创建对应的Widget
,进行调用时pushNamed
函数会传入一个参数,这个参数就是定义Map
时对应页面的key
。
1Navigator.of(context).pushNamed('page1');
<<向左滑动查看完整代码>>
动态路由
静态路由的方式并不是很灵活,相对而言动态路由更加灵活。动态路由不需要预先设定routes
,直接调用即可。和普通push
不同的是,动态路由在push
时通过PageRouteBuilder
来构建push
对象,在Builder
的构建方法中执行对应的页面跳转操作即可。
结合之前说的channelMethod
,就是在channelMethod
对应的Callback
回调中,执行Navigator
的push
函数,接收Native
传递过来的参数并构建对应的Widget
页面,将Widget
返回给Builder
即可完成页面跳转操作。所以说,动态路由的方式非常灵活。
无论是通过静态路由还是动态路由的方式创建,都可以通过then
函数接收新页面返回时的返回值。
1Navigator.of(context).push(PageRouteBuilder(
2 pageBuilder: (BuildContext context, Animation animation, Animation secondaryAnimation) {
3 return ContactWidget('next page value');
4 }
5 transitionsBuilder: (BuildContext context, Animation animation, Animation secondaryAnimation, Widget child) {
6 return FadeTransition(
7 child: child,
8 opacity: animation,
9 );
10 }
11)).then((onValue){
12 print('pop的返回值 $onValue');
13});
<<向左滑动查看完整代码>>
但动态路由的跳转方式也有一些问题,会导致动画失效,所以需要重写Builder
的transitionsBuilder
函数,来自定义转场动画。
无论是通过静态路由还是动态路由的方式创建,都会存在一些问题。由于每次都是新创建Widget
,所以在创建时会有黑屏的问题。而且每次创建的话,都会丢失当前页面上次的上下文状态,每次进来都是一个新页面。
了解了flutter之后,
也许你还想看看该作者的其他精彩文章
回复“加群”与大佬们一起交流学习~