更新时间:2022.07.05
FairWidget(
path: \'手机磁盘路径/xxx.fair.json\',
)
当 Fair 在运行期间,出现错误时,会有如下提示:
点击错误图标,可以显示错误日志:
使用方式:
Step1:定义模型数据:
import \'package:fair/src/render/base_model.dart\';
class Person implements BaseModel{}
需要实现 toJson
,添加一个 from
方法
Step2:注册模型
class TestGeneratedModule implements GeneratedModule
在其中注册模型
把定义的 GeneratedModule 传入到 FairApp 初始化的 generated:参数
Step3:模型使用,以 Sugar.mapEach 为例:
Sugar.mapEach([Person(name: “kk”,age: 18, wei: 99)], (index, Person item) {}
需要指定 item 的类型才能用 item.name 来使用其模型数据
支持直接调用或者将其在字符串中 Text(item.name),Text(“${item.age}”),
xiangwc |
WangYk |
gongpengyang |
qixu |
yangyang |
陈有余 |
SunWei |
动态化方案离不开热更新平台,我们规划在近期会推出以Flutter和Dart Server为主的热更新平台,实现开发者0成本接入Fair热更能力。
我们也将尝试使用low code
的形式,以在线化工具为基础,进行线上的Fair动态化编辑,提升整体开发效率。
Fair是为Flutter设计的动态化框架,通过Fair Compiler工具对原生Dart源文件的自动转化,使项目获得动态更新Widget Tree和State的能力。
创建Fair的目标是支持不发版(Android、iOS、Web)的情况下,通过业务bundle和JS下发实现更新,方式类似于React Native。与Flutter Fair集成后,您可以快速发布新的页面,而无需等待应用的下一个发布日期。Fair提供了标准的Widget,它可以被用作一个新的动态页面或作为现有Flutter页面的一部分,诸如运营位的排版/样式修改,整页面替换,局部替换等都可以使用。
Fair 架构由2部分组成,1为同Kraken和MXFlutter的App运行环境,2为Fair Compiler把Dart源文件编译成DSL和JS动态产物的工具。结构如下:
Fair 框架中Widget构建、数据绑定以及基本的逻辑(if、List Map…)处理都在Dart域完成,留给JS侧的只有基本数据类型、运算和方法调用处理。
推荐将 fair 下载到本地,通过 path 相对路径进行依赖。假设 fair 项目和您自己的项目位于同一个文件夹下面:
# add Fair dependency
dependencies:
fair: 2.6.0
# add compiler dependency
dev_dependencies:
build_runner: ^2.0.0
fair_compiler:
path: ../fair/compiler
# switch "fair_version" according to the local Flutter SDK version
dependency_overrides:
fair_version: 2.0.6+1
通过切换 flutter_version 版本进行版本兼容。例如,将本机切换为 flutter 2.0.6 后,Fair 需要同步切换
# switch to another stable flutter version
dependency_overrides:
fair_version:
path: ../fair/flutter_version/flutter_2_0_6
常见做法是作为 App 的根节点,如果不是全局采用也可以作为子页面的根节点
void main() {
WidgetsFlutterBinding.ensureInitialized();
FairApp.runApplication(
_getApp(),
plugins: {
},
);
}
dynamic _getApp() => FairApp(
modules: {
},
delegate: {
},
child: MaterialApp(
home: FairWidget(
name: \'DynamicWidget\',
path: \'assets/bundle/lib_src_page_dynamic_widget.fair.json\',
data: {"fairProps": json.encode({})}),
),
);
每一个动态组件由一个FairWidget
表示。
FairWidget(
name: \'DynamicWidget\',
path: \'assets/bundle/lib_src_page_dynamic_widget.fair.json\',
data: {"fairProps": json.encode({})}),
欢迎大家使用 Fair,也欢迎大家为我们点亮star
Github地址:https://fair.58.com
Fair官网:https://fair.58.com
通过Issue提交问题,贡献代码请提交Pull Request,管理员将对代码进行审核。
对Fair感兴趣的小伙伴,可以加入交流群。
微信 |
---|
微信入群:请先添加58技术小秘书为好友,备注fair,小秘书邀请进群。