由于网上的资料参差不齐,导致本人搭建环境遇到了各种各样的问题,有心学习这个的人,一遇到这个环境文件估计就要打退堂鼓了。学习成本实在太高,所以本人就想写一篇文章来告诉各位小伙伴,详情到炸的环境搭建过程。好了废话不多说,立马上干货。
1.Mac 系统要求:
要安装并运行Flutter,您的开发环境必须满足以下最低要求:
操作系统: macOS (64-bit)
磁盘空间: 700 MB (不包括Xcode或Android Studio的磁盘空间).
注意:需要先看下Mac有没有下载过 brew,没有的话,需要先去下载一个,具体下载步骤由于跟本 案例没有太大关联,这里就不细说了。贴个网址给大家,看下怎么下载就可以了。
brew下载步骤
2.下载Flutter SDK:
SDK的选择直接去官方地址下载就可以了,具体下载稳定版本的最新就可以了。官方下载页
下载完成后,解压,并将解压的文件放到一个合适的地方(这个合适的地方就是要配置环境变量的,一般不要放在桌面,也不要放在Downloads文件夹里面)
我本人是放在了文稿(Documents)里面,如下面的截图。
3.配置环境变量:
(1) 打开终端
(2) 输入命令
sudo vim ~/.bash_profile
之后会让你输入电脑的开机密码(如果没有密码直接回车就可以了)
之后就会进去编辑页面,在键盘是英文模式的状态下,按键盘 i 就可以进去编辑状态,编辑完后按 键盘上的 esc,之后输入 :wq 就可以保存并退出。
你在编辑页面需要将3句话写进去
// 这一句路径是根据我上面的第2步操作而来决定路径怎么写的
// 我是将SDK放在了文稿里面,所以我的路径是这样的
// 如果你们是放在了其他地方,那么请修改前面的 /Users/xuening/Documents
export PATH=/Users/xuening/Documents/flutter/bin:$PATH
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
这三句话做的操作就是:配置下全局的环境,并且由于在国内访问Flutter有时可能会受到限制,Flutter官方为中国开发者搭建了临时镜像。
(3) 输入命令
// 重新加载下 电脑的环境配置,这样你就可以在终端使用 flutter 命令啦!
source ~/.bash_profile
(4) 输入命令
flutter -h
看看是否安装成功并正常。如果出现以下截图就是正常了。
4.检查开发环境
(1) 输入命令
flutter doctor
这个图的信息还是很重要的,一般第一次安装,其实都是会报错的。
之后根据他报错的内容,会让你去下载一些所需的配置,之前最开始讲到的 brew 就是在这里用的,配合区下载一些东西。(都是通过命令去安装)由于我们这个教程是 iOS的,所以我就只下载了iOS 模拟器跟 xcode的一些插件,所以你们看到的图书都是我下载好的,所以直接显示了成功。
下载好之后,再次运行这个命令,如果没有提示出问题,那么恭喜你,环境已经搭好,第一步已经初步成功。
接下来我们将进行将flutter集成到iOS中。
1.创建工程(先用新工程来演示)
我们先创建一个空的iOS项目来模拟已有的项目,取名叫flutterTest。
我们创建的flutter工程必须是跟APP工程在同一水平目录下(不用自己建文件夹,这个zxn_flutter是等下通过下面的命令创建的),比如下面的截图。
我们先在终端进入到 flutterTest这个目录中
cd flutterTest/
// 这句话后面的就是文件夹的名字 需要注意的是,名字要取有下划线的,不然会报错
flutter create -t module zxn_flutter
上面的命令会创建一个zxn_flutter的项目模块,在zxn_flutter文件夹中有一些隐藏文件夹,里面包裹了Cocoapods 和 Ruby 脚本。
** 这上面的命令一定不能少,不然等下在用 pod 命令时会报错。 **
运行这命令后,我的文件夹内容是这样的
之后就是在终端 cd 到 iOS工程的目录下。
将podfile 文件编辑下
在最后添加这2句话,来进行关联。
之后在 终端 中 用命令:
pod install
2.禁用bitcode,设置xcode变量
打开iOS项目,选中TARGET zxn项目的Build Phases选项,点击左上角+号按钮,选择New Run Script Phase,将下面的shell脚本添加到输入框中:
"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh" build
"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh" embed
找到你的target,Build Settings->Build Options->Enable Bitcode 设置为NO,另外在Preprocessor Macros添加FLUTTER_BUILD_MODE=Debug和FLUTTER_BUILD_MODE=Release,如果还有其他环境需要根据情况选择Debug或Release。
因为目前Flutter目前还不支持BitCode。
3.iOS代码部分
oc版
AppDelegate.h
#import <UIKit/UIKit.h>
#import <Flutter/Flutter.h>
@interface AppDelegate : FlutterAppDelegate
@end
AppDelegate.m
#import <FlutterPluginRegistrant/GeneratedPluginRegistrant.h> // Only if you have Flutter Plugins
#include "AppDelegate.h"
@implementation AppDelegate
// This override can be omitted if you do not have any Flutter Plugins.
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[GeneratedPluginRegistrant registerWithRegistry:self];
return [super application:application didFinishLaunchingWithOptions:launchOptions];
}
@end
swift 版
import UIKit
import Flutter
import FlutterPluginRegistrant // Only if you have Flutter Plugins.
@UIApplicationMain
class AppDelegate: FlutterAppDelegate {
// Only if you have Flutter plugins.
override func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
GeneratedPluginRegistrant.register(with: self);
return super.application(application, didFinishLaunchingWithOptions: launchOptions);
}
}
如果你的delegate已经是继承于别的类的时候,可以通过让你的delegate实现FlutterAppLifeCycleProvider协议
这部分代码太长了,就不写了,等下最后给你们一个连接去看。
在ViewController.m中添加测试代码:
oc版
#import <Flutter/Flutter.h>
#import "ViewController.h"
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
UIButton *button = [UIButton buttonWithType:UIButtonTypeCustom];
[button addTarget:self
action:@selector(handleButtonAction)
forControlEvents:UIControlEventTouchUpInside];
[button setTitle:@"Press me" forState:UIControlStateNormal];
[button setBackgroundColor:[UIColor blueColor]];
button.frame = CGRectMake(80.0, 210.0, 160.0, 40.0);
[self.view addSubview:button];
}
- (void)handleButtonAction {
FlutterViewController* flutterViewController = [[FlutterViewController alloc] init];
[self presentViewController:flutterViewController animated:false completion:nil];
}
@end
swift版
import UIKit
import Flutter
class ViewController: UIViewController {
override func viewDidLoad() {
super.viewDidLoad()
let button = UIButton(type:UIButtonType.custom)
button.addTarget(self, action: #selector(handleButtonAction), for: .touchUpInside)
button.setTitle("Press me", for: UIControlState.normal)
button.frame = CGRect(x: 80.0, y: 210.0, width: 160.0, height: 40.0)
button.backgroundColor = UIColor.blue
self.view.addSubview(button)
}
@objc func handleButtonAction() {
let flutterViewController = FlutterViewController()
self.present(flutterViewController, animated: false, completion: nil)
}
}
运行xcode 程序,点击按钮就能看到flutter提供的页面了。
写完Flutter页面,如果要跳转到指定页面使用Flutter的路由就可以了
oc版:
[flutterViewController setInitialRoute:@"route1"];
Swift版:
flutterViewController.setInitialRoute("route1")
4.最后部分
在终端 cd 到 zxn_flutter 文件夹中,
在终端执行命令:
flutter run
就可以进行看到可以进行热更新