开头
在大厂，写得一手好文档是一个非常吃香的技能。这可不只是一个锦上添花的东西，而是很多工程师晋升，打造自己话语权的武器。 我这两年在组内的深刻体会就是，大部分厉害的高级工程师（不包括那些纯混日子靠资历晋升的人），写文档的能力一点也不含糊，很能抓住上级和项目的G点。
可能有人会觉得，我技术牛逼就行了，为啥还要提高写文档的能力，有这功夫我还不如多看看源码分析？这是一些初级或者刚入门的工程师的普遍的困惑。这是因为大部分刚刚入行的朋友有一个很深的误区，就是他们以为做软件工程是一个和计算机打交道的工作，其实不然。软件工程不只是和代码打交道，更重要的是和人打交道，是一份社会性质很强的工作。在大部分公司里面，尤其是大厂，牵涉到的人，组，都是非常非常多的。在小厂，人与人之间交流意见和设计可以口口相传，心领神会，但是一旦人开始多了，就只能靠文档了。除非你可以厉害到一个人把所有代码撸完，不然还是最好老老实实的夯实自己写文档的能力。
如果你有写技术博客的习惯，那么恭喜你，相信你已经对如何抓住文档受众的技巧有所了解了。这对你在大厂生存有很大的帮助。如果没有也不要伤心，这篇文章就是为你精心设计的。
在这篇文章里，我会大致的把一份安卓的项目设计文档的骨架，和一些我工作中实际遇到的正反例都列出来，方便大家以后在工作中实践。
实现方案
直接依赖
这种方式实现简单，但是耦合太严重，不方便维护与开发，当工程逐渐增大模块逐渐增多，依赖关系会非常复杂，不推荐这种方式。
事件或广播通信
EventBus： 我们非常熟悉的事件总线型的通信框架，非常灵活，采用注解方式实现，但是难以追溯事件。广播： 安卓的四大组件之一，在一个模块中发送广播设置数据，在另一个模块中注册广播接收数据，使用广播进行数据传递方式广播相对于其他的方式而言消耗资源较多。
总结： BroadcastReceiver、EventBus，非常灵活，模块之间没有任何的耦合，但是代码的可读性差，难以追溯事件，不是很推荐。
路由通信
模块与模块之间不存在依赖关系，而是各自运作，简单的来说就是映射关系的路由通信，也是目前比较主流的一种方案，比较常用的开源框架是阿里的ARouter。
ARouter典型应用
从外部URL映射到内部页面，以及参数传递与解析跨模块页面跳转，模块间解耦拦截跳转过程处理登陆、埋点等逻辑跨模块API调用，通过控制反转来做组件解耦。
面向接口通信
以上几种方式只是简单的介绍，下面就具体说下通过接口解耦通信的方式，首先先看几个问题。
什么是面向接口编程？
接口大家都很熟悉，这里所说的面向接口编程，并不只是所谓的 java 中的 interface，而是指超类型，可以是接口也可以是抽象类。
面向接口比面向对象编程是更先进一步编程思想，而是附属于面向对象编程的体系，属于其中一部分，它是面向对象编程体系中的思想精髓之一。面向接口编程它的核心思想是将抽象与实现分离，从组件的级别来设计代码，达到高内聚低耦合的目的。面向接口编程方法是，先定义底层接口模块，也就是 通信的协议与功能约定 ，是提供方实现对应的功能与能力。在架构中层次分明，不需要关注具体实现，开发中可以通过接口快速制定协议，与提供能力api，对于上层通过接口显露能力，对于下层只需要依赖接口层相当于依赖api。
面向接口编程的好处？
灵活性高没有依赖具体的实体，实现层可以任意的更改与切换。在模块化中可以相互依赖service(接口层)或依赖多个。
在模块化中的使用下面对于接口（interface）或api层统称为service，其含义为服务提供者。
对于，每一个 module 都一个独立的工程结构，每个 module 都有自己的 Service ,来统一暴露当前 module 所拥有能力与向外提供的服务。
对于 module 是在同一个工程里的项目结构，service 可以放到统一的一个 Module 下，我们统称为 Mediator，这样做的目的是为了减少 Module 创建与维护。假设你的工程有20个业务 Module 如果都同时增加一个 service 层就会造成 Module 数量翻一倍。由于这里存入的都一些接口类，也是每个业务 Module 向外提供的服务其体量不会太大，这里并只是一个建议并没有标准的做法。
当然也有更复杂的设计，一个 Module 又分不同的 service 实现如图，这里不在展开细说。
实际工程中使用与设计
在实际项目中有很多项目都同时开发两版本Pad与Phone，有的是两独立的工程，有的是在同一个工程内用 flavor 切换不同的工程，下面我就以通过 flavor 切换的工程结构举例。先看下工程的包的结构图：
可以看到 module 结构是分为三个部分，common, pad, phone, 如果每个service 都独立将增加3倍的 Module 数量。
使用一个 Mediator Module 统一管理这这些 service 就很好控制了 module 数量。
Service 创建
在 module_mediator 业务 module 下 common，pad、pone 下分别创建ICommonService, IService(pad), IService(phone)。ICommonService：公共服务。IService(pad)：pad服务并继承CommonService。IService(phone)：phone服务并继承CommonService。
注：这里为什么不用，PadService与PhoneService，是因为pad与phone版本同时只会存在一个，使用方只需要关心你提供的Service不用在区分版本，而且这里是一个继承关系也可以获取到共用的部分。
Service 实现
依赖 Mediator :
在业务 common\pad\phone module 下分别实现，ICommonService, Service(pad), IService(phone) ，在 common module 创建 CommonServiceImpl 实现 ICommonService，在 pad、phone module 分别创建 ServiceImpl 对应实现 IService 并继承与 CommonServiceImpl。
Service 注册
注册的方式有一般是通过代码用去注册，或通过注解进行注册。可以在 Application 注册也可以在业务 Module 下自己注册，如果使用注解则可以自动注册，具体要看项目怎样实现。例：
解释下 MediatorServiceFacator，它只是一个服务工厂也是一个接口类，作用是负责管理各业务方的 Service 主要功能是注册与获取 Service。上面的代码就是往里注册了一个会员的 Service。
可以看出这个函数只有两个参数，一个是接口class一个是实现类class，第一个参数cls：它会作为 key 来使用，第二个参数implClass：它会作为 value 来使用。
Service 使用
通过 MediatorServiceFacator 懒加载获取service对象，如果业务方没有注册则获取一个空的对象。
注册有 service 没有使用时是不会创建的，如果使用过则会缓存下来，下次调用则直接返回。（第一次是通过反射创建）例：
- 在 mediator 模块下会员 CommonService 中 定义了一个模糊查询会员的方法。
- 在会员模块下 common 中实现了该功能。
- 在会员模块下 pad 中继承了这个实现。
- 在其他模块 pad 下使用这个功能。
可以看到获取 Service 只要传对应接口就即可，对于使用方是不用关心实现方，在开发过程中只要先定义好接口，合作的同学就可以进入正常开发了。细心的同学可以看出，返回的数据类型也是一个接口类，为什么不直接返回一个普通 java 类呢？主要原因是通过接口方法达到双方 api 约定，例如 getName() :String 方法是通过方法名返回值达到约定效果，这样不依赖具体实现。
从上面的例子可以看出主要分为三个部分：1、定义接口。2、提供方实现接口。3、使用方都通过服务工厂获取服务使用。对于使用者来是很简单的，不需要关心实现，通过接口可以直接获取到实现，并且获取到结果可以直接使用，不需要做序列化处理。
有了路由通信我们为什么还使用面向接口编程？
路由模式虽然很好的解决了耦合的问题，但他的方法调用都是静态的，对于传参与返回值只能是基本类型，如果是对象需要做序列化与反序列化处理，对性能有一定影响。类似在调后台接口一样，同时降低了代码的可读性， 对于 app 而言所有 Module 都是在同一个应用下，没有必要做这些序列化操作。
对于复杂业务不好处理，例如一个业务需要多次通信，路由模式则不好处理，而通过接口通信则可以容易解决。例如：一个读卡的操作，业务方需要对它有开启、关闭、暂停等多个状态的操作。通过接口则可以直接返回一个读卡的 service 控制器， 这样可以直接进行相应的控制操作。
从上面代码中可以看出，上层回调结果的同时并回调了一个控制接口，这样就提供使用方一个反向操作的能力。
最后
针对Android程序员，我这边给大家整理了一些资料，包括不限于高级UI、性能优化、架构师课程、NDK、混合式开发（ReactNative+Weex）微信小程序、Flutter等全方面的Android进阶实践技术；希望能帮助到大家，也节省大家在网上搜索资料的时间来学习，也可以分享动态给身边好友一起学习！
资料领取：点击免费获取Android IOC架构设计
领取获取往期Android高级架构资料、源码、笔记、视频。高级UI、性能优化、架构师课程、混合式开发（ReactNative+Weex）全方面的Android进阶实践技术，群内还有技术大牛一起讨论交流解决问题。
领取获取往期Android高级架构资料、源码、笔记、视频。高级UI、性能优化、架构师课程、混合式开发（ReactNative+Weex）全方面的Android进阶实践技术，群内还有技术大牛一起讨论交流解决问题。
[外链图片转存中…(img-3qQ2aMlo-1621432104816)]
