iOS 项目嵌入Flutter 运行

本文介绍了如何使用命令行创建Flutter模块,然后通过pod在iOS项目中集成该模块。Flutter模块的创建包括`fluttercreate--templatemodulemy_flutter`命令,接着在iOS项目中通过配置podfile并执行`podinstall`来引入。在AppDelegate中启动FlutterEngine,并在ViewController中展示Flutter页面,通过FlutterViewController实现Flutter页面的加载。

一  创建Flutter 模块

命令行

flutter create --template module my_flutter

创建完成后,该模块和普通的Flutter项目一直,可以通过Android Studio或VSCode打开、开发、运行;

  • 和之前项目不同的iOS和Android项目是一个隐藏文件,并且我们通常不会单独打开它们再来运行;

  • 它们的作用是将Flutter Module进行编译,之后继承到现有的项目中

my_flutter/
├── .ios/
├── .android/
├── lib/
│   └── main.dart
├── test/
└── pubspec.yaml

二 嵌入到iOS 项目

主要是通过pod 进行设置,之后pod install

注意my_flutter 的路径对不对

platform :ios, '12.0'
# 添加模块所在路径
flutter_application_path = '../my_flutter'
load File.join(flutter_application_path, '.ios', 'Flutter', 'podhelper.rb')

target 'FlutterHybridDemo' do
  # Comment the next line if you don't want to use dynamic frameworks
  use_frameworks!
  
  # 安装Flutter模块
  install_all_flutter_pods(flutter_application_path)
  
  # Pods for FlutterHybridDemo

end

post_install do |installer|
  flutter_post_install(installer) if defined?(flutter_post_install)

end

三  iOS 项目中调用

为了在既有的iOS应用中展示Flutter页面,需要启动 Flutter Engine和 FlutterViewController

AppDelegate 中设置代码

import UIKit
import FlutterPluginRegistrant
@main
class AppDelegate: UIResponder, UIApplicationDelegate {

    // 1.创建一个FlutterEngine对象
    lazy var flutterEngine = FlutterEngine(name:"my flutter engine")

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // Override point for customization after application launch.
        // 2 启动
        flutterEngine.run()
        
        return true
    }

在ViewControlelr 设置的代码


import UIKit
import Flutter
class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        
        let btn = UIButton(type: UIButton.ButtonType.custom)
        btn.setTitle("加载flutter", for: UIControl.State.normal)
        btn.frame = CGRect(x: 50, y: 50, width: 200, height: 50)
        btn.backgroundColor = UIColor.blue
        btn.addTarget(self, action: #selector(showFlutter), for: UIControl.Event.touchUpInside)
        view.addSubview(btn)

        
    }
    
    @objc func showFlutter(){
        
        let flutterEngine = (UIApplication.shared.delegate as! AppDelegate).flutterEngine
        
        let flutterController = FlutterViewController(engine:flutterEngine, nibName: nil, bundle: nil)
        
        present(flutterController, animated: true)
        
        
    }


}


显示的结果  顺利加载出flutter 的页面

<think>根据用户的问题和提供的引用内容,用户希望了解如何将Flutter SDK接入现有的iOS项目。结合引用中的信息,以下是详细的步骤指南: ### 1. **安装Flutter SDK** 首先确保开发环境中已安装Flutter SDK。从Flutter官网下载适合的版本并安装。安装完成后,在终端运行以下命令验证安装: ```bash flutter doctor ``` 确保所有依赖项都正确配置,特别是iOS开发环境(如Xcode)[^1]。 ### 2. **创建Flutter模块** 在现有iOS项目的**同级目录**下,创建Flutter模块(而非独立Flutter应用): ```bash flutter create --template module my_flutter_module ``` 其中`my_flutter_module`为模块名称。此命令会生成一个包含iOS和Android子目录的Flutter模块[^1]。 ### 3. **通过CocoaPods集成Flutter模块** 在现有iOS项目的`Podfile`中添加以下代码,将Flutter模块作为依赖: ```ruby flutter_application_path = '../my_flutter_module' load File.join(flutter_application_path, '.ios', 'Flutter', 'podhelper.rb') target 'Your_iOS_App_Target' do install_all_flutter_pods(flutter_application_path) end ``` 运行`pod install`完成集成[^1][^4]。 ### 4. **配置iOS工程** - **关闭Bitcode**:在Xcode的`Build Settings`中,将`Enable Bitcode`设置为`NO`(Flutter暂不支持Bitcode)[^4]。 - **添加构建脚本**: 1. 在Xcode中选中iOS项目Target,进入`Build Phases`。 2. 点击左上角`+`,选择`New Run Script Phase`。 3. 将以下脚本粘贴到输入框中: ```bash "$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh" build "$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh" embed ``` 此脚本确保Flutter代码在编译时被正确构建和嵌入[^4]。 ### 5. **在iOS代码中调用Flutter** 在需要跳转至Flutter页面的地方,初始化`FlutterEngine`并加载视图: ```swift import Flutter import FlutterPluginRegistrant class FlutterManager { lazy var flutterEngine = FlutterEngine(name: "my_flutter_engine") func startFlutter() { flutterEngine.run() GeneratedPluginRegistrant.register(with: self.flutterEngine) } } // 在ViewController中使用 let flutterEngine = FlutterManager().flutterEngine let flutterViewController = FlutterViewController(engine: flutterEngine, nibName: nil, bundle: nil) present(flutterViewController, animated: true) ``` 此代码启动Flutter引擎并展示Flutter界面[^3][^4]。 ### 6. **处理第三方SDK(可选)** 若Flutter模块需使用第三方SDK(如支付、地图等),在Flutter模块的`pubspec.yaml`中添加依赖: ```yaml dependencies: flutter: sdk: flutter firebase_core: ^2.0.0 # 示例:Firebase SDK ``` 然后在iOS端的`Podfile`中同步更新原生SDK依赖[^2]。 ### 注意事项 - **混合开发调试**:使用`flutter attach`命令连接到运行中的iOS应用调试Flutter模块: ```bash flutter attach -d 'iPhone 14' ``` - **性能优化**:避免频繁启动`FlutterEngine`,建议全局共享引擎实例以减少开销[^4]。 通过以上步骤,可将Flutter SDK无缝集成到现有iOS项目中,实现原生与Flutter的混合开发。 §§相关问题§§ 1. 如何处理FlutteriOS原生之间的数据通信? 2. 集成Flutter后如何优化混合应用的启动性能? 3. 在混合开发中如何管理iOSFlutter的依赖冲突? </think>### 如何将Flutter SDK接入现有iOS项目(基于引用内容整理) #### 📦 核心步骤: 1. **环境准备** - 安装最新版Flutter SDK(通过官网下载并配置环境变量) - 验证安装:终端执行 `flutter doctor` 确保iOS工具链正常[^1] 2. **创建Flutter模块** ```bash # 在iOS项目同级目录执行 flutter create --template module my_flutter_module ``` - 注意:**不要使用独立Flutter工程**(引用[4]指出默认方案不适合现有工程)[^4] 3. **CocoaPods集成(推荐方案)** - 修改iOS项目的Podfile: ```ruby # 添加Flutter模块路径 flutter_application_path = '../my_flutter_module' load File.join(flutter_application_path, '.ios', 'Flutter', 'podhelper.rb') target 'Your_iOS_App' do install_all_flutter_pods(flutter_application_path) # 引用[1][4]关键方法[^1][^4] end ``` - 执行 `pod install` 4. **Xcode配置** - **关闭Bitcode**(Build Settings → Enable Bitcode → NO) - 添加构建脚本(Build Phases → New Run Script Phase): ```bash "$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh" build "$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh" embed ``` - 删除默认的`App.framework`引用(避免冲突)[^4] 5. **调用Flutter页面(Swift示例)** ```swift import Flutter func showFlutterScreen() { let flutterEngine = FlutterEngine(name: "io.flutter") flutterEngine.run() let controller = FlutterViewController(engine: flutterEngine, nibName: nil, bundle: nil) present(controller, animated: true) } ``` #### ⚠️ 关键注意事项: 1. **架构兼容性**:确保Flutter模块与iOS项目的架构版本一致(如iOS 11+) 2. **插件管理**: - 第三方SDK需同时配置iOS原生依赖和Flutter插件(引用[2])[^2] - 在Flutter模块的`pubspec.yaml`添加插件后,需在iOS端重新执行 `pod install` 3. **混合路由**:引用[3]建议使用`ios_sdk_flutter_plugin`等方案管理原生页面跳转[^3] #### 🔧 调试技巧: ```bash # 附加调试器到运行中的iOS应用 flutter attach -d 'iPhone' ``` > 通过CocoaPods集成的方案比直接嵌入框架更易维护,可避免引用[4]提到的默认方案问题[^4]。若遇到构建失败,检查`flutter doctor`输出的iOS工具链警告。
评论 1
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值