moduleName

Axe框架是一个开源的 iOS 业务组件化框架。本文介绍Axe框架的业务组件化思路并介绍基于Axe框架实现的组件动态化与开发管理平台化。

一、使用 Axe 框架实现业务组件化

业务组件化是近几年非常火的 APP 架构思路 究其原因随着业务发展APP 的规模也逐渐膨胀代码管理与协作开发变得困难编译耗时也屡创新高应用功能的拆分与研发团队的拆分也不可避免。 这些发展需要 APP 架构的变更以支持大型 APP 的开发支持跨团队的协作。而解决方案就是将各个业务拆分成独立组件从主工程中脱离进行单独开发、编译、测试不与其他业务组件相互耦合。

组件化方案需要解决三个问题：

代码隔离 ： 最基本的要求使组件可以单独开发。

单独编译 ： 组件单独构建编译以提高 APP 编译速度并为单独测试提供基础。

组件交互 ： 满足组件之间交互的合理需求。

代码隔离

代码隔离比较容易实现代码解耦然后分离建仓最后通过Cocoapods来管理引用。

单独编译

组件单独编译构建成Framework静态库。

组件同时需要有源码版本以进行调试。

组件的编译接入持续集成系统一般会使用管理平台来管理组件的构建下文中会提及。

组件交互

业务组件之间的沟通协调是组件化中最关键的技术点 一般的组件化方案强调通过一种协议机制或者target-action的方式来实现。 而Axe中的组件交互分为三个部分：

数据

我们将数据抽离出来作为组件交互的重要一环 组件间的数据交互分为两种：

数据共享 ： 共享的是所有组件都可以获取的数据。

数据传递 ： 数据也可以附着在路由和事件中传递。

单独的数据组件是为了解决特殊类型数据的问题。 我们支持特殊数据类型如 图片、二进制数据、Model类型等。

路由

界面逻辑的处理交给路由。

根据路由的表现我们定义两种路由：

跳转路由 ： 进行页面跳转如使用UINavigationController的push以打开一个新页面。

视图路由 ： 返回一个界面元素 即返回一个UIViewController 以满足嵌套页面的需求 如 侧边栏、Tab 栏等页面。

路由的表现形式是一个URL 如同大多数的路由方案一样。默认支持的路由是Axe路由结构为：

axe://{moduleName}/{pageName}

如果URL附带参数会自动转换为数据类型。路由支持回调处理。

Axe的路由支持协议扩展以实现自定义的路由处理。

事件

使用事件监听机制以实现更加灵活方便的跨组件交互。

在事件实现中我们提供了方便好用的接口 ：Axe中的事件支持 同步、异步、优先级设定。 并且实现了两个特殊的功能：

1. 组件初始化： 基于事件通知实现组件自注册。 通过事件中的优先级和同异步设定来进行组件初始化的排序与管理。

进行登录组件的初始化该部分代码放在登录组件内部。当接入登录组件时就会在启动时自动初始化以注册路由。

2. 界面监听 ： 提供一种适用于界面展示的监听接口该监听会保留回调直到页面回到前台才执行；且同名的通知不会出现重复处理只会使用最新的数据执行一次。

事件中可以附带数据。

总结

通过 路由 、 事件、 监听 我们为组件之间的交互提供了完善的支持。且实现了组件之间的代码完全无依赖。 组件交互时只需要知道 调用的路由地址 事件的名称以及数据的键值与类型 （与Model数据的结构） 只需要知道这些 声明 即可 （通过字符串的形式）。 一个声明文件的示例：

这也为后续支持其他容器的组件提供了基础。

二、基于 Axe 实现组件动态化

在 APP 动态化的需求下使用H5和React Native成为很多APP的选择。 而我们也在Axe框架的基础上再做优化以更好的适应动态性的需求。

扩展容器

Axe不仅要支持iOS原生页面也要支持WebView容器和React Native容器使这两类业务组件也能够像原生一样通过Axe接入组件化系统。

首先通过协议扩展在Axe上注册协议路由 ： https 和 reacts 使其他组件可以通过路由调用这些页面。扩展后我们可以使用路由跳转到H5页面：

[self jumpTo:@"https://demo.axe-org.cn/login-h5/#/"];

然后做Native与容器之间的桥接 ：在WebView上使用WebViewJavascriptBridge作为JavaScript的桥接在React Native通过添加Native Module来做桥接 , 调用Axe来处理路由跳转、事件通知和数据请求。 路由与通知比较简单 重点是数据 我们通过特殊处理（标明类型和自动转换）以支持特殊类型的数据如NSDate、NSData、UIImage、Model等特殊类型能在原生和JavaScript之间传递：

左侧是原生组件中的OC代码右侧是扩展容器的JavaScript代码Axe能够做到跨容器传递数据甚至特殊类型如图片、Model等。

通过桥接处理目前我们使WebView和React Native容器接入了组件化可以通过Axe调用其他组件也可以通过Axe被其他组件调用 使这两个容器在使用和表现上与原生组件 完全一样！

离线包支持

为了更好地使用JavaScript的容器Axe提供了一套简单的离线包方案。 离线包指 ： 将资源打包整合统一管理下发以使 APP 可以在离线的情况下使用本地资源加载页面。

使用离线包可以节约用户流量提高页面加载速度提高用户体验。 当前实现的简单离线包使用bsdiff进行差分支持上传到oss 支持跟随APP打包且拥有一个有趣的签名机制。

我们进行协议扩展 ：

ophttp: 基于离线包的H5容器路由 URL 形式是op 组件 / 页面

oprn : 基于离线包的React-Native容器路由 URL 格式是 oprn:// 组件 / 页面

组件等同性

Axe中强调组件等同性 , 即 如果两个组件实现了同样的 声明 , 拥有相同的业务逻辑 （被其他组件调用表现一致）那这两个组件在Axe组件化体系中就可以视为 相同的组件 就可以互相替换。

所以在Axe组件化下我们不关注组件的实现只关注组件的业务逻辑 只关注组件的声明文件只关注组件提供的页面、事件和数据。组件等同性使组件可以互相替换。在Axe组件化下替换组件的实现不会影响其他业务组件的运行。

组件等同性使我们可以为业务组件开发多个版本使不同的用户使用不同的版本以实现基于组件化方案的组件灰度测试。

动态路由

组件等同性 要求相同的路由但是我们知道传统的路由只能对应一个具体页面。

所以为了使用组件等同性Axe提出一个声明路由的概念 声明路由是对实现路由的包装。使用动态路由后组件的声明文件中标明的是声明路由 。所有业务组件通过声明路由来访问其他组件而实际跳转时再根据路由配置转换为实现路由。

Axe提供了一个简单的动态路由服务 通过这个服务管理和下发路由映射配置使应用拥有线上动态切换组件实现的能力。

三、对组件开发进行平台化管理

基于Axe框架我们实现了业务组件化 组件动态化 然后我们还要再进一步实现组件管理平台化。

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

APP 架构

在Axe组件化下我们推荐将公共业务和基础组件合成一个组件称之为Ground, 地基组件用于管理公共业务和公共的基础组件。

这样做的原因 ：

统一管理基础内容的版本：业务组件开发时只需要依赖Ground组件而不需要过度关注具体基础组件的版本。

将零散琐碎的基础组件统一起来编译成一个整体减少了组件数量 一定程度上优化 APP 的整体架构。

能够很好的处理基础组件中的.a和.framework静态库。

Axe通过脚本自动处理Ground项目中包含的子组件的头文件使业务组件可以通过正常的头文件引入方式来使用基础组件。

代码管理

使用gitlab 。

对于版本建立版本分支如version/0.0.1设置权限确保所有提交都经过代码检视。

使用git-lfs管理 二进制文件。

项目管理

对于组件和 APP 的版本我们要明确并记录项目的时间节点严格按照计划执行项目。

控制组件版本的接入 ：组件的版本必须经过 APP 管理人员的审核才能接入 APP 中。

协作开发

组件的接口与更新日志要妥善的归档记录。

多组件协作开发时需要提前设计好接口以并发开发。设定好开发计划以确保组件都能按时完成。最后合并在一起接入到 APP 中。

版本管理

组件版本号的管理遵循语义化版本号即使用 主版本号. 次版本号. 修订号 。然后在使用Cocoapods进行组件版本的管理时我们的处理方式是：

指定 具体组件版本。

只保留Podfile , 不上传Podfile.lock

在开发测试阶段我们加入一个beta版本 ：通过先行版本做开发版本的自动提升以解决开发阶段的版本频繁变更的问题。 在完成开发测试后构建release版本进行最终发布与封版：

图片4

需要注意的是 pod依赖的编写是使用工具自动处理所以不用担心对开发阶段造成困惑。

业务开发者只需要知道在没有打release版本之前可以随意的构建beta版本而其他人使用时也会自动的接入到最新的beta版本。

持续集成

使用fastlane和Jenkins做持续集成fastlane编写脚本处理组件的管理、接入与打包。

自动化测试

由于Axe组件化中一个组件最重要的是其声明。 所以自动化测试的内容就是按照声明调用接口 然后检测返回值是否正确。

在测试过程中一些重要节点进行截图以快速检测 UI 问题。

自动化测试在 0.1.0 的Axe中并未实现。

组件开发管理平台

以上是Axe的解决方案的大致介绍。 同时Axe 提供了一个简单的组件化开发管理平台。该用来管理 ：

组件的开发计划

组件的文档

组件的构建

APP 的开发计划

组件的接入和升级管理

当前Demo网址为 demo.axe-org.cn 。接下来我们简单介绍一下这套系统中的有趣或重要的地方：

时间线

在APP版本或者组件版本开始前先制定一个时间计划指明 APP 版本或组件版本的重要时间节点 ：

APP 版本概览

右侧是APP的依赖图通过脚本自动绘制。

组件概览

组件版本概览

右侧记录版本的更新日志。

组件 API 文档

API文档也就是上述的声明文件 用于声明其支持的路由暴露的数据和发送的通知。

组件依赖情况

依赖图是脚本自动绘制的。

连线括号内是声明的版本限制而圆圈括号内是具体使用的版本号。

组件构建

对接 jenkins调用组件构建任务自动打包并提交版本。

接入管理

当一个业务组件开发完成后需要提交接入 APP 的申请由APP管理员查看并确认才能接入该版本。

总结

基于Axe框架我们实现 iOS 应用的业务组件化并在此基础上进行动态化的扩展最后更进一步实现平台化的管理。目前项目开源在 github地址为 https://github.com/axe-org/axe 。

我们会持续维护与更新欢迎大家来体验、抓虫与吐槽。

标签： iOS业务组件化框架Axe详解