手把手教你写Android项目文档，专题解析
去年无疑是 Flutter 技术如火如荼发展的一年。
每一个移动开发者都在为 Flutter 带来的“快速开发、富有表现力和灵活的 UI、原生性能”的特色和理念而痴狂，从超级 App 到独立应用，从纯 Flutter 到混合栈，开发者们在不同的场景下乐此不疲的探索和应用着 Flutter 技术，也在面临着各种各样不同的挑战。
Alibaba集团内也有越来越多的业务和团队开始尝试 Flutter 技术栈，从闲鱼的一支独秀引领潮流，到如今淘宝特价版、盒马、优酷、飞猪等BU业务相继入局，Flutter的业务应用在集团内也已经逐渐形成趋势。
有幸从一位朋友那里得到Alibaba内部出品强推的“Flutter进阶学习笔记”，秉承好东西的当然要共享的原则，今天就来秀一把，试试这“Flutter进阶学习笔记”是否也能让你事半功倍！
实现方案
直接依赖
这种方式实现简单，但是耦合太严重，不方便维护与开发，当工程逐渐增大模块逐渐增多，依赖关系会非常复杂，不推荐这种方式。
事件或广播通信
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工程师而言，想要提升技能，往往是自己摸索成长，不成体系的学习效果低效漫长且无助。 整理的这些架构技术希望对Android开发的朋友们有所参考以及少走弯路，本文的重点是你有没有收获与成长，其余的都不重要，希望读者们能谨记这一点。
最后想要拿高薪实现技术提升薪水得到质的飞跃。最快捷的方式，就是有人可以带着你一起分析，这样学习起来最为高效，所以为了大家能够顺利进阶中高级、架构师，我特地为大家准备了一套高手学习的源码和框架视频等精品Android架构师教程，保证你学了以后保证薪资上升一个台阶。
当你有了学习线路，学习哪些内容，也知道以后的路怎么走了，理论看多了总要实践的。
以上进阶BATJ大厂学习资料可以免费分享给大家，需要完整版的朋友，点这里可以看到全部内容。
进阶学习视频
附上：我们之前因为秋招收集的二十套一二线互联网公司Android面试真题 （含BAT、小米、华为、美团、滴滴）和我自己整理Android复习笔记（包含Android基础知识点、Android扩展知识点、Android源码解析、设计模式汇总、Gradle知识点、常见算法题汇总。）
504113184)]
附上：我们之前因为秋招收集的二十套一二线互联网公司Android面试真题 （含BAT、小米、华为、美团、滴滴）和我自己整理Android复习笔记（包含Android基础知识点、Android扩展知识点、Android源码解析、设计模式汇总、Gradle知识点、常见算法题汇总。）
