HiJesse/Gaea

Gaea

Gaea是一个基于Atlas实现Android项目组件化和插件化的脚手架. 可以根据此脚手架快速开发一款具有插件化特性的App, 也可以提供参考和帮助现有项目实现插件化.

项目模块

模块命名规约

目录名	描述
app	宿主模块, 负责启动应用和启动页.
lib_*	插件和宿主都依赖的中间件, 打包进宿主中.
plugin_*	插件模块, 会在编译阶段编译成so打包进apk.
plugin__lib_	插件依赖库, 会打包进插件中.
remote_*	远程插件模块, 编译成so不打包进apk.
remote__lib_	远程插件依赖库, 会打包进远程插件中.

Gaea 项目结构

目录名	描述
app	宿主模块, 启动application和启动页.
lib_base	所有模块都需要依赖的工具类, UI组件等(不包含业务).
lib_common	所有模块都需要依赖的公共业务资源等(只包含业务).
lib_network	网络组件, 提供网络接口相关操作.
lib_accessibility	android 辅助组件, 提供系统辅助操作.
plugin_main	main插件, 提供App主页等.
plugin_user	user插件, 提供用户中心登录等.
remote_scanner	scanner远程插件, 动态提供图形扫描功能.

插件间交互

插件间交互主要涉及两个组件. 由于common组件是跟业务相关的基础中间件, 所有组件都可见. 所以插件间交互需要用到的常量都下沉到common组件中. base组件则提供交互相关的工具.

相关类	所属组件	职责
RemoteRouterDef	common组件	各大插件之前交互需要用到的常量汇总
ActivityRouter	base组件	工具, 负责插件间页面跳转activity路由
AtlasRemoteUtil	base组件	工具, 负责插件间获取fragment, view和方法调用

APK构建

执行./gradlew clean assembleDebug publish. 根据项目规约会将组件app和lib.*直接打进apk, 组件plugin.*编译成so文件打进apk的lib目录下. 最终生成debug apk包, 并将ap基准包以app版本号为单位部署到localmaven中, 方便生成TPatch.

TPatch构建和加载

TPatch是用来修改或升级宿主和非远程插件的方式. 操作流程以App 1.0.0版本为例.

在master分支执行./gradlew clean assembleDebug publish. 打出v1.0.0版本apk包, 并归档基准包.
切换到patch_user分支, 该分支相对master修改了User模块的UserFragment. 在版本号文案前面增加(patch_user)字符串. 并修改插件gradle中的unit tag(Atlas根据unitTag的版本来标识修改记录的)
执行./gradlew clean assembleDebug -DapVersion=1.0.0. 传入apVersion后gradle会根据版本号找到第一步归档的基准包, 并生成TPatch. 输出产物在build/output/tpatch.
将包含update信息的json文件和TPatch文件部署在后端或者放在静态云上.
请求/gaea/update/checkUpdate接口获取TPatch信息.
下载TPatch文件, 并通过Common组件的AtlasUpdateUtil.loadTPatch方法校验和安装patch.
安装成功后重启App进程使patch生效.

远程插件相关

构建, 加载和卸载

确保根目录config.gradle文件中computeRemoteBundles()方法配置插件为远程插件.
执行./gradlew clean assembleDebug. 远程bundle的编译产物输出在build/output/remote-bundles中.
将SO插件部署在后端或者放在静态云上.
请求/gaea/update/checkUpdate接口获取插件信息.
通过Common组件的AtlasUpdateUtil.classNotFoundInterceptorCallback下载校验和安装插件.
AtlasUpdateUtil.uninstallBundle 卸载远程插件.

迭代

由于插件在编译时会将当前插件的manifest文件合并到宿主的manifest中, 并且在APP运行期间需要用到例如四大组件权限声明之类的也是通过宿主的manifest获取. 所以远程插件的迭代根据是否修改了manifest文件分为两种不同的流程.

未修改manifest文件, 走远程插件构建, 加载和卸载的流程. 根据远程插件的版本号, 下载新版本插件 -> 卸载老版本插件 -> 安装新版本插件.
修改了manifest文件, 走TPatch构建和加载流程. 如果APP已经安装过远程插件TPatch加载之后会合并修改. 如果没安装则下载最新的远程插件.

HiJesse / Gaea