iOS原生和flutter混编环境配置踩坑

准备工作：

环境及设备：

1. macOS Mojave 10.14.5

1. Xcode 11.1

3. Android Studio 3.5 / VSCode

4. iterm2+Zsh（非必须）

5. iPhone/模拟器

这里推荐 Xcode + Android Studio的方式，因为Flutter和Android Studio都出自Google团队，彼此之间兼容性很好，坑也会比较少，功能也很强大完善，所以选择使用Android Studio作为Flutter开发的IDE，VScode是一个相对比较轻量的高效的开源的开发工具，有兴趣的同学可以也可以尝试。

1.MacOS环境下搭建Flutter环境注意点：

[https://flutterchina.club/setup-macos/](https://flutterchina.club/setup-macos/)

这里是macOS下搭建flutter环境的官方指导，下面简单说下要点和需要注意的点。

1.1 国内访问Flutter有时候会有限制，和安装cocoaPods一样都需要设置镜像

在bash_profile文件添加一下两句：

export PUB_HOSTED_URL=https://pub.flutter-io.cn 
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

注： 这是临时镜像，不一定总是可用，具体可以参考链接Using Flutter in China，或者搜索：flutter镜像，有很多方案可供选择。

1.2 下载fluter sdk时需注意不能直接下载SDK包解压安装

手动下载Flutter SDK，解压到某个文件夹运行 flutter doctor，它会提示你该文件夹不是一个Github的clone项目

1. 可以直接终端 git clone https://github.com/CocoaPods/Specs.git

2. github上搜索flutter，然后把sdk克隆到本地，这里建议跟踪flutter的stable分支，这是Flutter稳定分支，还有master和beta分支等，如果你想要查看flutter框架最新的变化，你可以跟踪master分支，但注意这是开发分支，所以稳定性比较低。

3. 要查看当前使用的分支，运行flutter channel查看。

要切换分支，使用 flutter channel beta 或 flutter channel master

2 下载Android Studio配置注意点（安装Flutter和Dart插件）：

安装成功后需要重启android studio

后续只需按照 flutter doctor 错误提示一个个修改即可

3.Flutter环境更新

如果你之前安装了flutter环境，现在想更新Flutter SDK和你的依赖包，在你的应用程序根目录（包含pubspec.yaml文件的目录）中运行flutter upgrade 命令：（Flutter项目根目录下的pubspec.yaml文件是Flutter的配置文件，里面包含着一些依赖库，图片素材，字体等）

4.在原有iOS项目中添加Flutter Module

在集成混编前需要做到：

• git clone下来的 Flutter SDK

• 一个iOS原生项目

• 一个Flutter项目

• Flutter Module运行开发环境（Andriod Studio）

4.1 将Flutter集成到原生项目

官方推荐：https://flutter.dev/docs/development/add-to-app/ios/project-setup

注：推荐使用官方推荐的两种方式，不要随便网上找些博客就用

有两种方式：

1. cocoaPods依赖管理 + Flutter SDK （推荐）

2.把 Flutter engine 、你的 dart 代码和所有 Flutter plugin 编译成 framework 。然后用 Xcode 手动集成到你的应用中，并更新编译设置。

第二种方法：每次修改Flutter module.代码后，需要

run flutter build ios-framework 

注：模拟器不能运行Release和Profile模式，可以在模拟器和真机上运行Debug模式，真机上运行Release或Profile模式。（这里的Release、Debug模式指的是Flutter中的构建模式，不同模式有不同特点，例如Debug模式下的app的体积较大，性能较差，但是可以在热重载时快速响应变化；Profile模式用于在测试时分析性能等）

这里假设iOS原生项目、Flutter Module、安卓原生项目都在同一文件目录下，在podfile文件加入：

flutter_application_path = '../flutter_module/'

load File.join(flutter_application_path, '.ios', 'Flutter', 'podhelper.rb')

（podhelper.rb是个脚本，它会把你的plugins，Flutter.framework和App.framework集成到你原生项目中，Flutter.framework是Flutter engine的框架，App.framework是Dart代码编译产物）

并在target中集成这句代码：

install_all_flutter_pods(flutter_application_path)

然后运行pod install