Rubik是一套解决Android平台组件化的综合方案，提供gradleproject之间的路由通讯能力，以及对gradleproject的组件定义、版本控制、maven发布、aar/jar与源码之间的切换以及组件的自由组合等能力。
EnglishReadme
Rubik由两部分组成：
RubikRouter：即Rubik的函数级路由能力，与一般的页面路由不同，RubikRouter允许把Uri及参数，导航到工程内部，任意的一个公开的JVM语言（Java/Kotlin）函数的执行上，以便于更灵活的进行gradleproject之间不基于代码调用的通讯。Rubik工具链：提供组件上下文的定义、版本控制、maven发布、aar/jar与源码之间的切换等能力，包括4个gradleplugin:rubik：提供全局定义组件的能力，并根据全局定义自动启用rubik-context、rubik-root等插件rubik-context：提供task，自动生成镜像函数等中间代码，并把中间代码打包成context.jar,按版本号发布到maven提供task，把业务代码按flavor、版本号编译成aar(包括代码、资源、内置SDK)发布到maven通过全局定义的组件，为组件所在子工程自动添加其他context.jar的依赖rubik-root：给壳工程提供筛选组件等能力，根据flavor、版本号筛选要打包进apk的业务组件提供组件的源码工程和aar切换的能力rubik-test:给工程提供单元测试环境快速开始1.工程创建和组件声明：(1)创建或使用已有的一个或多个androidlibrarymodule，作为"组件工程"（如demo代码中的demo_component_detail、demo_component_home等），用于开发真正的业务逻辑。
(2)在最外层工程（gradlerootproject)的build.gradle或gradle.properties文件中配置Rubik版本号等初始化参数，并在最外层工程中启用rubik插件：
ext{rubik_kapt_version="com.rubik:kapt:1.9.1.1-K1_5"rubik_router_version="com.rubik:router:1.9.1.1-K1_5"rubik_plugins_version="com.rubik:plugins:1.9.1.1-AGBT4-K1_5"}applyplugin:'rubik'//启用rubik插件(3)在最外层工程的build.gradle文件或同级目录下的rubik-*.gradle文件中，配置组件信息：
rubik{component{//第一个组件uri"app://com.myapp.home"//组件的Uridependencies{//组件需要依赖的其他组件uri("app://com.myapp.detail"){version"0.1.1"//依赖其他组件的版本}uri(…)}source{//定义默认来源，如不需切换源码和aar，可以只声明project或mavenproject(":demo_component_home")}}component{…}//继续配置第二个组件}2.让组件之间互相通信：(1).在接口提供者工程内，通过注解定义路由路径，作为组件暴露给其他组件的通信接口：
通过RFunction注解声明函数路由:
@RFunction(path="account/user")fungetUser(id:Int,name:String):User?{…}通过RPage注解声明页面路由:
@RPage(path="page/main")classHomeActivity:AppCompatActivity(){…}(2).执行接口提供者工程对应的"publishRubikXxxRContextLib"任务，发布组件上下文到云端或本地maven仓库。
(3).执行接口提供者工程对应的"publishRubikXxxRComponent"任务，发布组件aar到云端或本地maven仓库。
(4).在接口调用者工程内，调用上述接口提供者所提供的接口，可以选择两种方式：
通过KotlinDSL：
navigate{uri="app://com.myapp.detail/account/user"//请求的uriquery{//请求的参数"id"with400"name"with"CuiVincent"}result<User?>{user->//通过泛型指定接收数据类型，多次异步返回时，可以用多个result接收…}}通过自动生成的镜像函数：
DetailContext.Account.user(400,"CuiVincent"){user->…//自动生成的镜像函数的参数类型、返回值类型都是明确的，比DSL方式更具有约束力}3.筛选要打包的组件(1).创建或使用已有的androidapplicationproject，作为"壳工程"（如demo代码中的demo_root_app），用于把组件组装并编译成Apk。
(2).在"壳工程"的的build.gradle文件或同级目录下的rubik-*.gradle文件中，指定"壳工程"最终要将哪些组件，以哪种方式引入，并打包到最终的编译产物之中：
rubik{packing{projectMode{//projectMode，通过源码工程的方式引入组件uri("app://com.myapp.home")uri("app://com.myapp.*")//支持通过*匹配任意字符}mavenMode{//mavenMode，通过maven上的aar的方式引入组件uri("app://com.myapp.detail"){version"0.2.0"}}}}测试通过rubik-test插件，给当前工程的androidTestvariant添加全部可pick组件的context.jar依赖，便于写测试用例。@RunWith(AndroidJUnit4::class)classRouterTestCase{@Beforefuninit(){Rubik.init()}//初始化Rubik@TestfunusePerview(){PerviewContext.preViewVideo(path){success->log("preViewVideosuccess:${success}")}//测试用例}…//继续写测试用例}
评论