Axe

Axe is all the reinforcement this army needs.

快速了解 ：

• demo-app
• 组件开发管理平台 Demo
• 文档 (待填坑。。。)

Axe 框架

Axe是一个iOS的业务组件化框架，通过三大基础组件，来规定所有业务组件之间的交互方式， 三大基础组件为 ：

• Router : 路由模块，根据URL获取界面或者进行跳转
• Event : 事件通知， 是业务组件之间的主要交互方式
• Data : 公共数据，以及业务组件之前传递数据的媒介

相对于一般的组件化方案，我们多了一个Event和Data, 这两个组件的出现，使跨语言的统一业务开发模式的统一成为了可能 ，即当我们规定好三种路由、事件和数据后，h5的模块和react-native的模块可以和原生模块一样通过Axe框架与其他业务模块进行交互。

示例

详细示例可以参考Demo项目 , 这里简单介绍一下常用方法：

// 路由
// 路由跳转
[self jumpTo:@"axes://login/register"];
// 视图路由
UIViewController *controller = [[AXERouter sharedRouter] viewForURL:item.viewRoute
	 withParams:data finishBlock:nil];
// 带参数， 带回调
AXEData *data = [AXEData dataForTransmission];
[data setData:@"12345678" forKey:@"account"];
[self jumpTo:@"axes://login/login" withParams:data finishBlock:^(AXEData *payload) {
    id<LoginUserInfo> userInfo = [payload modelForKey:@"userInfo"];
    NSLog(@"%@",userInfo.account);
}];
    
//数据共享
// 设置数据
UIImage *image = [info objectForKey:UIImagePickerControllerOriginalImage];
[[AXEData sharedData] setData:image forKey:@"image"];
// 读取数据
 UIImage *image = [[AXEData sharedData] imageForKey:@"image"];
 
// 事件通知
// 注册
[wself registerUIEvent:@"LoginStatusChange" withHandler:^(AXEData *payload) {
	BOOL login = [payload boolForKey:@"login"];
	if (!login) {
		[wself toastMessage:@"退出登录 ！！！"];
	} else {
		id<LoginUserInfo> userInfo = [payload modelForKey:@"userInfo"];
		NSLog(@"%@",userInfo.account);
	}
}];
// 发送通知
[[AXEData sharedData] removeDataForKey:@"userInfo"];
AXEData *data = [AXEData dataForTransmission];
[data setBool:NO forKey:@"login"];
[AXEEvent postEventName:@"LoginStatusChange" withPayload:data];

Axe框架结构

核心功能：

• Router ： 路由， 根据一个URL返回一次页面跳转或者一个界面
• Event ： 事件通知
• Data ： 数据， 既可以作为 路由跳转和事件通知的数据传递媒介，也可以做公共数据的共享

扩展功能：

• TabbarController ： TabbarController 管理的简单实现
• JavascriptSupport : 三大基础组件为支持js调用，所做的简单封装，动态性支持。
• Html ：提供webview支持，动态性支持。
• React ： 提供react-native支持，动态性支持。
• OfflineHtml ： h5离线包支持，动态性支持。
• OfflineReact : react-native 离线包支持，动态性支持。
• DynamicRouter ： 动态路由，实现完全脱离实现细节的 路由控制。，动态性支持。

Axe系统

Axe框架是一个组件化的框架，而Axe系统是基于Axe框架搭建起来的完整的业务模块化管理开发系统。 所以 从Axe框架 到系统，分为以下三个层次 ：

• 组件化： 实现业务组件化拆分，实现代码隔离的单独编译
• 动态化： 接入html 和react-native支持， 同时模块可替换。
• 平台化： 为APP上的业务模块开发提供一个管理平台，管理开发流程。

Axe的动态化

动态化指 尽可能地提高APP的动态性能力。 已知目前在iOS上能用的动态化方案，有两种, H5和react-native （忽略weex等），则动态化要做到的内容是 ： 支持h5和react-native模块， 使两种模块表现与原生模块相同， 最后做到能够动态切换。

接入h5和react-native

我们为axe提供了两个接口 ：

• axe-js ： h5使用的axe接口
• axe-react ： react-native使用的axe接口

通过这两个接口，使js开发的业务模块也纳入了 组件化的体系中，保持与原生业务模块的一致性， 即一个原生开发的模块，与js开发的模块，几乎没有区别。

同时，我们为js开发的模块提供了离线包功能， 以优化其更新下载过程 ：

• offline-pack-server ： 离线包管理平台
• offline-pack-ios ： 离线包的iOS 实现。

在axe框架的扩展中，JavascriptSupport ,Html, React,OfflineHtml,OfflineReact ,都是为js模块服务的。

可替换性与动态切换

如上所述， 我们说js开发的模块接入了组件化体系， 通过提供接口（路由、事件、通知） 供其他模块调用，以及通过接口调用其他模块。 所以在我们Axe的组件化下， js模块与原生模块表现一致，可以互相替换。

动态切换：指当前APP上如果有一个业务模块的多个实现时， 我们可以控制模块选取具体的实现。

一个模块的多个实现，其接口中， 事件和通知都是相同，不同的是路由 。 所以我们提出了声明路由和实现路由的概念：

当APP需要这种动态化能力时， 我们开发模块时会隐藏实现路由 ，而暴露声明路由 ， 再通过一个下发路由映射规则的服务 ：

dynamic-router-server

做到线上模块动态切换。

Axe的平台化

平台化指通过一个平台，来规范模块化APP的开发、构建、测试、接入、发布流程，优化跨小组、团队、部门的协作开发。平台化关注以下问题：

• 代码管理的规范： 确定git-flow， 确定代码检视规则，确定代码提交权限 等等。
• 项目管理的规范： 确定项目时间， 明确测试与发布时间，约定需求接收模式，明确职责划分 等等
• 协作开发的规范： 模块相关信息与接口API的展示，模块版本变更记录， 协作开发时处理模块间的依赖 等等。
• 版本管理的规范： APP的版本规则， 模块版本的规则， 版本如何发布，模块如何接入到APP中 等等。
• 持续集成的规范： 确定构建工具，搭建持续集成平台，管理模块和APP的打包 等等。
• 自动化测试： 确定自动化测试的工具与方式，完成自动化测试系统的搭建， 确保每个模块都进行自动化测试。

Axe系统提供一个平台化的解决方案 axe-admin , 提供demo以查看效果。

生态系统

Project	Description
axe-react	为React Native提供的Axe接口
axe-js	为H5页面提供的Axe接口
offline-pack-server	离线包服务
offline-pack-ios	离线包的iOS 实现
dynamic-router-server	动态路由服务
axe-admin-server	组件化管理平台的后端
axe-admin-web	组件化管理平台的前端
axe-admin-docker	使用docker镜像进行发布
fastlane	组件化管理的辅助脚本

License

Axe is licensed under The MIT License.