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,需要将这些文件配置在下面的位置,并且按照不同环境配置不同的文件。

Project -> Info -> Development Target -> Configurations

系统设置

有些比较大的工程中已经在Configurations中设置了xcconfig文件,由于每个Target的一种环境只能配置一个xcconfig文件,所以可以在已有的xcconfig文件中import引入Generated.xcconfig文件,并且不需要区分环境。

脚本文件


xcode_backend.sh脚本文件用来构建和导出Flutter产物,这是Flutter开发包为我们默认提供的。需要在工程Target的Build Phases加入一个Run Script文件,并将下面的脚本代码粘贴进去。需要注意的是,不要忘记前面的/bin/sh操作,否则会导致权限错误。

/bin/sh “$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh” build

/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代码了,下面是详细步骤。

将AppDelegate的集成改为FlutterAppDelegate,并且需要遵循FlutterAppLifeCycleProvider代理。

#import <Flutter/Flutter.h>

#import <UIKit/UIKit.h>

@interface AppDelegate : FlutterAppDelegate

@end

创建一个FlutterPluginAppLifeCycleDelegate的实例对象,这个对象负责管理Flutter的生命周期,并从Platform侧接收AppDelegate的事件。我直接将其声明为一个属性,在AppDelegate中的各个方法中,调用其方法进行中转操作。

  • (BOOL)application:(UIApplication *)application willFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

[self.lifeCycleDelegate application:application willFinishLaunchingWithOptions:launchOptions];

return YES;

}

  • (void)applicationWillResignActive:(UIApplication *)application {

[self.lifeCycleDelegate applicationWillResignActive:application];

}

  • (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {

[self.lifeCycleDelegate application:application openURL:url sourceApplication:sourceApplication annotation:annotation];

return YES;

}

随后即可加入Flutter代码,加入的方式也很简单,直接实例化一个FlutterViewController控制器即可,也不需要传其他参数进去(这里先不考虑多实例的问题)。

FlutterViewController *flutterViewController = [[FlutterViewController alloc] init];

Flutter将其看做是一个画布,实例化一个画布上去之后,任何操作其实都是在当前页面完成的。

常见错误


到这个步骤集成操作就已经完成,但是很多人在集成过程中会遇到一些错误,下面是一些常见错误。

路径错误,读取不到xcode_backend.sh文件等。这是因为环境变量FLUTTER_ROOT没有获取到,FLUTTER_ROOT配置在Generated.xcconfig中,可以看一下这个文件是不是配置的有问题。

lipo info *** arm64类似这样的错误,一般都是因为xcode_backend.sh脚本导致的,可以检查一下FLUTTER_ROOT环境变量是否正确。

下面这种问题一般都是因为权限导致的,可以查看Build Phases的脚本写的是不是有问题。

***/flutter_tools/bin/xcode_backend.sh: Permission denied

混合开发


在进行混编过程中,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侧,交互完成。

import ‘package:flutter/services.dart’;

Future playVideo() async{

var methodChannel = MethodChannel(‘flutterChannelName’);

Map params = {‘playID’ : ‘302998298’, ‘duration’ : ‘2520’, ‘name’ : ‘三生三世十里桃花’};

String result;

result = await methodChannel.invokeMethod(‘PlayAlbumVideo’, params);

String playID = params[‘playID’];

String duration = params[‘duration’];

String name = params[‘name’];

showCupertinoDialog(context: context, builder: (BuildContext context){

return CupertinoAlertDialog(

title: Text(result),

content: Text(‘name: n a m e p l a y I D : name playID: nameplayID:playID duration:$duration’),

actions: [

FlatButton(

child: Text(‘确定’),

onPressed: (){

Navigator.pop(context);

},

)

],

);

});

}

NSString *channelName = @“flutterChannelName”;

FlutterMethodChannel *methodChannel = [FlutterMethodChannel methodChannelWithName:channelName binaryMessenger:flutterVC];

[methodChannel setMethodCallHandler:^(FlutterMethodCall * _Nonnull call, FlutterResult _Nonnull result) {

if ([call.method isEqualToString:@“PlayAlbumVideo”]) {

NSDictionary *params = call.arguments;

VideoPlayerModel *model = [[VideoPlayerModel alloc] init];

model.playID = [params stringForKey:@“playID”];

model.duration = [params stringForKey:@“duration”];

model.name = [params stringForKey:@“name”];

NSString *playStatus = [SVHistoryPlayUtil playVideoWithModel:model

showPlayerVC:self.flutterVC];

result([NSString stringWithFormat:@“播放状态 %@”, playStatus]);

}

}];

Native to Flutter

Native调用Flutter的代码和Flutter调用Native的基本类似,只是调用和设置回调的角色不同。同样的,Flutter由于要接收Native的消息回调,所以需要注册一个回调,由Native发起对Flutter的调用并传入参数。

Native和Flutter的相互调用都需要设置一个名字,每一个名字对应一个MethodChannel对象,每一个对象可以发起多次调用,不同调用以invokeMethod做区分。

import ‘package:flutter/services.dart’;

@override

void initState() {

super.initState();

MethodChannel methodChannel = MethodChannel(‘nativeChannelName’);

methodChannel.setMethodCallHandler(callbackHandler);

}

Future callbackHandler(MethodCall call) {

if(call.method == ‘requestHomeData’) {

String title = call.arguments[‘title’];

String content = call.arguments[‘content’];

showCupertinoDialog(context: context, builder: (BuildContext context){

return CupertinoAlertDialog(

title: Text(title),

content: Text(content),

actions: [

FlatButton(

child: Text(‘确定’),

onPressed: (){

Navigator.pop(context);

},

)

],

);

});

}

}

NSString *channelName = @“nativeChannelName”;

FlutterMethodChannel *methodChannel = [FlutterMethodChannel methodChannelWithName:channelName binaryMessenger:flutterVC];

[RequestManager requestWithURL:url success:^(NSDictionary *result) {

[methodChannel invokeMethod:@“requestHomeData” arguments:result];

}];

调试工具集


在iOS和Android开发中,各自的编译器都提供了很好的调试工具集,方便进行内存、性能、视图等调试。Flutter也提供了调试工具和命令,下面基于VSCode编译器来讲一下Flutter调试,相对而言Android Studio提供的调试功能可能会更多一些。

性能调试


VSCode支持一些简单的命令行调试指令,在程序运行过程中,在Command Palette命令行面板中输入performance,并选择Toggle Performance Overlay命令即可。此命令有一个要求就是需要App在运行状态。

性能调试

随后会在界面上出现一个性能面板,这个页面分为两部分,GPU线程和UI线程的帧率。每个部分分为三个横线,代表着不同的卡顿层级。如果是绿色则表示不会影响界面渲染,如果是红色则有可能会影响界面的流畅性。如果出现红色线条,则表示当前执行的代码需要优化。

Dart DevTools

VSCode为Flutter提供了一套调试工具集-Dart DevTools,这套工具集功能非常全,包含性能、UI、热更新、热重载、log日志等很多功能。

安装Dart DevTools后,在App运行状态下,可以在VSCode的右下角启动这个工具,工具会以网页的形式展现,并且可以控制App。

主界面

下面是Dart DevTools的主界面,我运行的是一个界面类似于微信的App。从Inspector中可以看到页面的视图结构,Android Studio也有类似的功能。页面整体是一个树形结构,并且选中某一个控件后,会在右侧展示出控件的变量值,例如frame、color等,这个功能非常实用。

Dart DevTools

我运行的设备是Xcode模拟器,如果想切换Android的Material Design,点击上面的iOS按钮即可直接切换设备。刚才上面说到的查看内存的性能面板,点击iOS按钮旁边的Performance Overlay即可出现。

Select Widget

如果想知道在Dart DevTools中选择的节点,具体对应哪个控件,可以选择Select Widget Mode使屏幕上被选中的控件高亮。

Select Widget Mode

Debug Paint

点击Debug Paint可以让每个控件都高亮,通过这个模式可以看到ListView的滑动方向,以及每个控件的大小及控件之间的距离。

Android高级架构师

由于篇幅问题,我呢也将自己当前所在技术领域的各项知识点、工具、框架等汇总成一份技术路线图,还有一些架构进阶视频、全套学习PDF文件、面试文档、源码笔记。

  • 330页PDF Android学习核心笔记(内含上面8大板块)

  • Android学习的系统对应视频

  • Android进阶的系统对应学习资料

  • Android BAT部分大厂面试题(有解析)

好了,以上便是今天的分享,希望为各位朋友后续的学习提供方便。觉得内容不错,也欢迎多多分享给身边的朋友哈。
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》点击传送门,即可获取!
记。

  • 330页PDF Android学习核心笔记(内含上面8大板块)

[外链图片转存中…(img-iImNmwc9-1714745019203)]

[外链图片转存中…(img-CBCvb5X6-1714745019207)]

  • Android学习的系统对应视频

  • Android进阶的系统对应学习资料

[外链图片转存中…(img-HAOyYWx9-1714745019208)]

  • Android BAT部分大厂面试题(有解析)

[外链图片转存中…(img-517urnH1-1714745019211)]

好了,以上便是今天的分享,希望为各位朋友后续的学习提供方便。觉得内容不错,也欢迎多多分享给身边的朋友哈。
《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》点击传送门,即可获取!

  • 28
    点赞
  • 26
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值