log Faraday English

Features

使用g_faraday的APP

Show Cases

Example App

设计原则

更新策略

Requirements

版本对应关系

快速开始

添加依赖

dependencies:
 g_faraday: ^0.7.0

Flutter 端集成

// 0x00 定义 route
final route = faraday.wrapper((settings) {
 switch (settings.name) {
 case 'first_page':
 return CupertinoPageRoute(builder: (context) => Text('First Page'));
 case 'second_page':
 return CupertinoPageRoute(builder: (context) => Text('Second Page'));
 }
 return CupertinoPageRoute(builder: (context) => Text(settings.name));
});
// 0x01 将 route 赋给你的app widget
CupertinoApp(onGenerateRoute: (_) => route);
// 0x02 flutter 侧集成完毕,接下来你可以选择 集成iOS/Android

iOS 集成

// 0x00 实现 `FaradayNavigationDelegate`
extension AppDelegate: FaradayNavigationDelegate {
 func push(_ name: String, arguments: Any?, options: [String : Any]?, callback token: CallbackToken) {
 let isFlutter = options?["flutter"] as? Bool ?? false
 let isPresent = options?["present"] as? Bool ?? false
 let vc = isFlutter ? FaradayFlutterViewController(name, arguments: arguments) : FirstViewController(name, arguments: arguments)
 let topMost = UIViewController.fa.topMost
 if (isPresent) {
 // 此处注意
 // vc.modalPresentationStyle 不能是`pageSheet`
 // 如果的确需要这种UI效果,可以配合透明背景,在Flutter侧实现
 topMost?.present(vc, animated: true, completion: nil)
 } else {
 topMost?.navigationController?.pushViewController(vc, animated: true)
 }
 // 非常重要
 // 如果此处不调用 `enableCallback` 那么flutter侧`await Navigator`则永远不会返回
 vc.fa.enableCallback(with: token)
 }
}
// 0x01 在 `application: didFinishLaunchingWithOptions`中启动flutter engine
Faraday.default.startFlutterEngine(navigatorDelegate: self)
// 0x02 打开一个flutter 页面
let vc = FaradayFlutterViewController("first_page", arguments: nil)
navigationController?.pushViewController(vc, animated: true)
// 0x03 集成完毕

Android 集成

// 0x00 实现 navigator
class SimpleFlutterNavigator : FaradayNavigator {
 companion object {
 const val KEY_ARGS = "_args"
 }
 override fun create(name: String, arguments: Serializable?, options: HashMap<String, *>?): Intent? {
 val context = Faraday.getCurrentActivity() ?: return null
 val isFlutterRoute = options?.get("flutter") == true
 if (isFlutterRoute) {
 // singleTask 模式
 val builder = FaradayActivity.builder(name, arguments)
 // 你看到的绿色的闪屏就是这个
 builder.backgroundColor = Color.WHITE
 builder.activityClass = SingleTaskFlutterActivity::class.java
 return builder.build(context);
 }
 when (name) {
 "flutter2native" -> {
 return Intent(context, FlutterToNativeActivity::class.java)
 }
 "native2flutter" -> {
 return Intent(context, Native2FlutterActivity::class.java)
 }
 "tabContainer" -> {
 return Intent(context, TabContainerActivity::class.java)
 }
 else -> {
 val intent = Intent(Intent.ACTION_VIEW)
 intent.data = Uri.parse(name)
 intent.putExtra(KEY_ARGS, arguments)
 return intent
 }
 }
 }
 override fun pop(result: Serializable?) {
 val activity = Faraday.getCurrentActivity() ?: return
 if (result != null) {
 activity.setResult(Activity.RESULT_OK, Intent().apply { putExtra(KEY_ARGS, result) })
 }
 activity.finish()
 }
 override fun enableSwipeBack(enable: Boolean) {
 }
}
// 0x01 在 Application 的onCreate方法中启动FlutterEngine
if (!Faraday.startFlutterEngine(this, SimpleFlutterNavigator())) {
 GeneratedPluginRegistrant.registerWith(Faraday.engine)
}
// 0x02 打开一个Flutter页面
val intent = FaradayActivity.build(context, routeName, params)
context.startActivity(intent)

faraday 全家桶 (推荐)

FAQ

是否支持使用第三方路由框架?

是否支持使用url配置路由?

打包时提示 failed to load module 'g_faraday'

Communication

Contributing

License