Flutter集成到现有项目的几种方案 - iOS

$\color{red}{方案一. 使用 CocoaPods 依赖管理和已安装的 `Flutter SDK` 。（推荐） }$

1.优点，

1.执行方便，在xcode执行编译就可以自动运行脚本集成dart和plugin,

2.编译方便，修改flutter文件，可以在xcode工程中立马拿到最新代码快速迭代开发，而无需在 Xcode 以外执行额外的命令。

3.可联机动态更新flutter中的页面(hot reload)

2.缺点

1.项目中每个人都要配置对应的flutter和dart运行环境

2.项目配置都要修改flutter和dart的路径，每个人的配置路径还不同

3.git代码不好管理，每次提交都会把配置信息和路径信息一起上传，冲突太多

4.你的应用将不能在模拟器上运行 Release 模式，因为 Flutter 还不支持将 Dart 代码编译成 x86 ahead-of-time (AOT) 模式的二进制文件。你可以在模拟机和真机上运行 Debug 模式，在真机上运行 Release 模式。

3.集成步骤

1.创建Flutter module 命令行或者使用编译器创建,最好和你的xcode工程在同一级目录下,关于flutter创建项目的类型查看Flutter四种工程类型

cd 你的Xcode目录
flutter create --template module 项目名称 
#或者下面
flutter create --t module 项目名称

2.添加依赖包到flutter中，在pubspec.yaml文件中添加自己的依赖包括Flutter packages和plugins,目录中.ios/ 隐藏文件夹包含了一个 Xcode workspace，用于单独运行你的 Flutter module。它是一个独立启动 Flutter 代码的壳工程，并且包含了一个帮助脚本，用于编译 framewroks 或者使用 CocoaPods 将 Flutter module 集成到你的既有应用。
3.编辑Podfile文件，

#1.podfile文件中添加一下代码
flutter_application_path = '../my_flutter'
load File.join(flutter_application_path, '.ios', 'Flutter', 'podhelper.rb')

target 'xcode工程名' do
  …………
  install_all_flutter_pods(flutter_application_path)
end

4.运行 pod install
5.当你在 my_flutter/pubspec.yaml 改变了 Flutter plugin 依赖，需要在 Flutter module 目录运行 flutter pub get，来更新会被podhelper.rb 脚本用到的 plugin 列表，然后再次在你的应用目录 some/path/MyApp 运行 pod install.

podhelper.rb 脚本会把你的 plugins， Flutter.framework，和 App.framework 集成到你的项目中。
有关podhelper.rb文件的作用和说明， $\color{red}{详情参考}$

$\color{red}{方案二 . XCode引入flutter moudle的产物 }$

1.优点

1.native同学不需要关心Flutter模块，也不需要搭建Flutter环境，就可以开发，

2.Flutter模块的同学可以通过独立工程单独开发

2.缺点

1.每次flutter模块升级或者改造之后，都需要重新生成对应的.framework，替换之前的产物，重新开始运行

3.集成步骤

1.在flutter moudle目录下执行以下命令
flutter build ios-framework --output=some/path/MyApp/Flutter/
2.在自己定义的目录下面生成以下文件
some/path/MyApp/
└── Flutter/
    ├── Debug/
    │   ├── Flutter.framework
    │   ├── App.framework
    │   ├── FlutterPluginRegistrant.framework (only if you have plugins with iOS platform code)
    │   └── example_plugin.framework (each plugin is a separate framework)
    ├── Profile/
    │   ├── Flutter.framework
    │   ├── App.framework
    │   ├── FlutterPluginRegistrant.framework
    │   └── example_plugin.framework
    └── Release/
        ├── Flutter.framework
        ├── App.framework
        ├── FlutterPluginRegistrant.framework
        └── example_plugin.framework
$\color{red}{上面生成的三个目录中的文件不能混合使用}$ ，这样将会导致运行失败</font>，使用的时候统一使用相同目录下面的文件，debug、release或profile
3.将生成的framework集成到现有的应用中。将上面三个目录中对应的文件直接拖到你的xcode项目工程中，然后在项目中按着下面步骤进行操作 build settings > Build Phases > Link Binary With Libraries。在 target 的编译设置中的 Framework Search Paths (FRAMEWORK_SEARCH_PATHS) 增加 $(PROJECT_DIR)/Flutter/Release/。

frameworksetting.png

target_setting.png

小提示(暂时还没尝试过)
如果你想在 Debug 编译配置下使用 Debug 版本的 Flutter frameworks，在 Release 编译配置下使用 Release 版本的 Flutter frameworks，在 MyApp.xcodeproj/project.pbxproj 文件中，尝试在所有 Flutter 相关 frameworks 上使用 path = "Flutter/$(CONFIGURATION)/example.framework"; 替换 path = Flutter/Release/example.framework; （注意添加引号 "）。
你也必须在 Framework Search Paths (FRAMEWORK_SEARCH_PATHS) 编译设置中使用 $(PROJECT_DIR)/Flutter/$(CONFIGURATION)。

$\color{red}{方案三. 使用 CocoaPods 在 Xcode 和 Flutter 框架中内嵌应用和插件框架 }$

方案三的优缺点和方案二相同，只是集成步骤不同

1.在 Flutter 的 1.13.6 版本之后,可以使用-cocoapods 参数生成flutter产物，这样将 Flutter 框架作为一个 CocoaPods 的 podspec 文件分发。这将会生成一个 Flutter.podspec 文件而不再生成 Flutter.framework 引擎文件。
2.使用下面命令生成产物
flutter build ios-framework --cocoapods --output=some/path/MyApp/Flutter/
3.生成对应的产物目录
some/path/MyApp/
└── Flutter/
   ├── Debug/
   │   ├── Flutter.podspec
   │   ├── App.framework
   │   ├── FlutterPluginRegistrant.framework
   │   └── example_plugin.framework (each plugin with iOS platform code is a separate framework)
   ├── Profile/
   │   ├── Flutter.podspec
   │   ├── App.framework
   │   ├── FlutterPluginRegistrant.framework
   │   └── example_plugin.framework
  └── Release/
      ├── Flutter.podspec
       ├── App.framework
     ├── FlutterPluginRegistrant.framework
  └── example_plugin.framework
4.选择一种模式的文件复制到xcode工程中，在podfile文件中配置如下
pod 'Flutter', :podspec => '对应目录/Flutter/[Debug，Release或者Profile]/Flutter.podspec'
5.执行 pod install ，然后编译运行

$\color{red}{方案四. 使用 CocoaPods 在Xcode中引入flutter产物}$

优缺点同方案三

1.使用上面的产物，自己编写一个.podspec 文件，通过 podfile 引入

Pod::Spec.new do |s|

  s.name         = "FlutterModule"
  s.version      = "1.17.300" # 1.17.3
  s.summary      = "A short description of FlutterModule."

  s.description  = "FlutterModule"

  s.homepage     = "http://***********"

  s.license      = "MIT"
  s.author       = { "*****" => "*********" }

  s.source       = { :git => "", :tag => "#{s.version}" }

  #s.source_files = 'Classes','Classes/**/*.{h,m}'
  #重点是引入对应的包,debug和release中引入所有的framework
  s.vendored_frameworks = ['Module/App.framework','Module/Flutter.framework','Module/FlutterPluginRegistrant.framework']
  s.resource = ['Module/flutter_assets']

end

2.修改podfile文件

pod "FlutterModule", :path => "../framework目录"

以上就是这几种集成方式，有不正确之处，敬请指出。