Axe is all the reinforcement this army needs.
快速了解 ：
- demo-app
- 组件开发管理平台 Demo
- 文档 (待填坑。。。)
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];
核心功能：
- Router ： 路由， 根据一个
URL返回一次页面跳转或者一个界面 - Event ： 事件通知
- Data ： 数据， 既可以作为 路由跳转和事件通知的数据传递媒介，也可以做公共数据的共享
扩展功能：
- TabbarController ： TabbarController 管理的简单实现
- JavascriptSupport : 三大基础组件为支持js调用，所做的简单封装，动态性支持。
- Html ：提供webview支持，动态性支持。
- React ： 提供react-native支持，动态性支持。
- OfflineHtml ： h5离线包支持，动态性支持。
- OfflineReact : react-native 离线包支持，动态性支持。
- DynamicRouter ： 动态路由，实现完全脱离实现细节的 路由控制。，动态性支持。
Axe框架是一个组件化的框架，而Axe系统是基于Axe框架搭建起来的完整的业务模块化管理开发系统。 所以 从Axe框架 到系统，分为以下三个层次 ：
- 组件化： 实现业务组件化拆分，实现代码隔离的单独编译
- 动态化： 接入
html和react-native支持， 同时模块可替换。 - 平台化： 为APP上的业务模块开发提供一个管理平台，管理开发流程。
动态化指 尽可能地提高APP的动态性能力。 已知目前在iOS上能用的动态化方案，有两种, H5和react-native （忽略weex等），则动态化要做到的内容是 ： 支持h5和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需要这种动态化能力时， 我们开发模块时会隐藏实现路由 ，而暴露声明路由 ， 再通过一个下发路由映射规则的服务 ：
做到线上模块动态切换。
平台化指通过一个平台，来规范模块化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 | 组件化管理的辅助脚本 |
Axe is licensed under The MIT License.