Flutter 开发 （1）iOS 下超详细集成 Flutter

iOS 客户端接入 Flutter 实践

官方混编文档

https://github.com/flutter/flutter/wiki/Add-Flutter-to-existing-apps#ios

目录

• 介绍
• 搭建 Flutter-iOS 开发环境
• iOS现有项目接入flutter
• 改造iOS工程
• 运行进行测试
• 相关文档

背景

• 本篇文章是系列文章，会涉及到Flutter初步了解，Flutter组件化混编方案，Flutter实战开发，Flutter Native 交互等系列文章。
• 本篇 主要是 整理了目前如何集成Flutter的步骤和实践，还属于很初级的阶段，让大家了解下什么是Flutter，Flutter是如何集成的。

一、介绍

Flutter是一款移动应用程序SDK，一份代码可以同时生成iOS和Android两个高性能、高保真的应用程序。

Flutter目标是使开发人员能够交付在不同平台上都感觉自然流畅的高性能应用程序。

目前使用Flutter的APP并不算很多，相关资料并不丰富，介绍现有工程引入Flutter的相关文章也比较少。

Flutter架构

二、搭建 Flutter-iOS 开发环境

1. 获取 Flutter 工程

• 克隆 Flutter 到本地

sudo git clone -b beta https://github.com/flutter/flutter.git $HOME/flutter

2. 配置 Flutter 环境变量

（1）说明

• 由于在国内访问Flutter有时可能会受到限制，Flutter官方为中国开发者搭建了临时镜像，可以把镜像地址添加到环境变量中。
• 为了方便后续使用，需要将项目根目录下bin路径加入环境变量PATH中，打开~/.bash_profile文件，修改环境变量即可。

（2）添加环境变量（确保路径指向没问题）

• 执行命令 open ~/.bash_profile 在底部添加环境变量。

• 然后生效环境变量，终端 执行 source ~/.bash_profile

（3）注意

• 如果你使用的是zsh，终端启动时 ~/.bash_profile 将不会被加载，解决办法就是修改 ~/.zshrc ，在其中添加：source ~/.bash_profile，执行命令 open ～/.zshrc，底部添加如下：

3. 配置基本环境依赖

4. flutter doctor 检测本机环境

1. 说明

• 因为flutter依赖的东西比较多，如果我们想要保证flutter环境没问题，需要执行 flutter doctor 检测确保当前环境。
• 在终端中执行 flutter doctor 命令，如下图：

2. flutter doctor 检查失败原因

• flutter doctor 检测失败的原因会有很多，例如以下

没有安装 Android Studio。 Android Studio 配置有问题。 Android Studio 没有安装Flutter插件。 没有安装Xcode，或Xcode版本过低。 没有安装CocoaPods 没有安装 libimobiledevice 没有安装 ideviceinstaller 没有安装 ios-deploy

• 一步一步按照提示进行修复问题

安装或修改需要的地方，直到 flutter doctor 没有错误提示为止。

3. 安卓SDK相关环境变量设置

• 这是作者本机的环境变量，如果遇到问题，可对比一下区别。

三、iOS现有项目接入flutter

（1）说明

• Flutter的工程结构比较特殊，由Flutter目录再分别包含Native工程的目录（即 iOS 和Android 两个目录）组成。
• 默认情况下，引入了 Flutter 的 Native 工程无法脱离父目录进行独立构建和运行，因为它会反向依赖于 Flutter 相关的库和资源。
• 如果已经现有工程，那么我们需要在同级目录创建flutter模块。

（2）创建Flutter模块

• 假设当前工程是 Flutter_iOS ，那么 cd到项目同级目录，执行flutter命令创建。

（3）创建iOS项目的 Config 文件

• Config文件（管理Xcode工程的配置衔接文件） 里面包含分别创建 Flutter.xcconfig、Debug.xcconfig、Release.xcconfig 三个配置文件。
• 其中Flutter.xcconfig是指向外目录flutter module的Generated.xcconfig文件路径引用文件，其他两个代表Xcode的环境配置文件。

（4）Config 文件 内容

• Flutter.xcconfig 内容

• Debug.xcconfig 内容 （对应的名字换成自己）

• Release.xcconfig 内容（对应的名字换成自己）

（4）项目中指定使用 config

• 指定 config 文件，Debug 对应 Debug，Release 对应 Release

（5）设置 Flutter 的脚本

• 在 Run Script 中增加：

（6）修改Flutter脚本

• 默认自己的Xcode Run Script编译好的framework并不在项目中，而在你创建flutter module文件夹下。
• 代码中有判断，进行生成的目录，需要注释代码让其生成在当前项目目录。
• 终端执行命令

open $FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh

• 注释代码

• 配置好，Cmd+B，Build工程编译后，会生成Flutter 编译产物在项目目录下。

（7）引入Flutter编译产物

• 把编译产物，拖入项目中

• 注意：flutter_assets 并不能使用 Create groups 的方式添加，只能使用 Creat folder references的方式添加进Xcode项目内，否则跳转flutter会页面渲染失败（页面空白）。需要先删除引用。

• 然后 文件夹再Add Files to 'xxx'，选择Creat folder references

• 最终如下图

• 然后还需要添加文件夹下的两个framework添加到Embeded Binaries里。

四、改造iOS工程

（1）AppDelegate.h 改造

• 使其继承 FlutterAppDelegate 。
• 删除 @property (strong, nonatomic) UIWindow *window; ，因为集成的delegate里面已经有了。

（2）AppDelegate.m 改造

• 改造AppDelegate.m，转发代理消息。
• 把使用到的代理，都改为以下方式，使用_lifeCycleDelegate调用传递一次。

（3）主工程调用Flutter 进行测试

四、运行进行测试

（1）使用 Android Studio 打开 Flutter 模块

• 选择main.dart，flutter代码主文件，在终端中进行 flutter attact 等待连接。

（2）运行iOS工程。

• flutter attact后，改变flutter代码，然后输入R 可进行刷新重载。

Demo 地址：https://github.com/bigsen/Flutter_iOS

注意

• 如果编译不过，可以先cd到 flutter_library 下 执行 flutter build ios