component 👏👏👏👏👏👏👏👏

简介

中小型公司或个人项目快速开发的良好脚手架，经过实际项目检验，目前持续维护更新中

考虑到有的朋友可能只是想看部分模块，近期准备把各个模块拆分出来，方便大家使用拆分进度

模块	进度	新地址
bus	已完成	ElegantBus

优点

模版模式，自动生成大部分重复代码，提供大部分业务情景Base类
简单明了的 M-V-VM 模式
底层逻辑（出错、loading显示、初始化页面、刷新、加载更多等）统一处理，只需要处理业务逻辑和画子布局
不依赖后段开发进度可以直接测试前段代码显示逻辑
模块化编程，需要的模块直接引用就可以
创建本地仓库和远端仓库，提高编译效率
清晰明了的架构和底层依赖图，方便合理组合选用
良好的UI反馈机制，尽量做到每一个点击都能给用户很好的反馈
其他

使用技术

技术	说明
M-V-VM	Model和View通过VM进行绑定的设计模式
dataBinding	数据绑定实现M-V-VM设计模式
APT	Android注解处理工具进行代码生成
LiveData	生命周期绑定的数据对象
Room	数据库
PageList & Paging	数据分页
Retrofit	网络请求
channel	多渠道打包
multi module	多模块依赖、模块化
version ext	统一变量进行版本管理
glide	图片加载通过bindingAdapter统一处理
easy permissions	权限问题统一处理
lazy loading	Fragment懒加载
Swipe Back	侧滑返回
...	其他第三方依赖处理常规问题

包含模块

模块	说明	详细说明
app-demo	模块使用示例	详细说明
app-core	利用dataBinding实现M-V-VM底层BASE模块沉浸式体验布局侧滑返回懒加载等	详细说明
marquee-core	滚动广告布局	详细说明
update-core	应用升级更新套件	详细说明
blues-core	crash捕获，内部集成bugly	详细说明
banner-core	滚动播放广告组件	详细说明
cat-core	网络数据监听，快速定位bug原因	详细说明
hybrid-core	利用拦截onJsPrompt实现的混合交互方案	详细说明
image-core	图片浏览，扫码，身份证，营业执照拍摄等照片相关	详细说明
http-core	对retrofit封装	详细说明
http-compiler	通过APT实现模版代码自动生成，减少重复工作量	详细说明
bus-core	利用LiveData实现的event-bus	详细说明
bus-compiler	定义事件后，通过APT实现模版代码自动生成，减少重复工作量	详细说明
...	其他底层工具类和UI组件	详细说明

项目结构图

说明：每个模块都可以单独依赖，根据下图结构，上层自动会将底层依赖进来。例如： dependencies { implementation 'com.github.codyer.component:app-core:1.0.72' } 可以直接依赖app-core

项目结构

仓库说明

本地仓库自己开发时，可以使用本地仓库离线开发，提高编译效率
远程仓库团队合作时，可以使用远程仓库

本地和远程仓库通过分支或者tag进行自动区分

通过分支名来实现不同的依赖方式，免去了总是切换参数的麻烦，直接使用不同分支实现

通过包含指定名字（local）的tag或者branch 实现推送到本地仓库
通过包含指定名字（remote）的tag或者branch 实现依赖远程仓库
通过包含指定名字（component）的tag或者branch 实现排除 compiler 打出一个总组件的依赖包
通过包含指定名字（compiler）的tag或者branch 实现排除 component 打出一个总注解处理器的包

调试APT代码

APT会用到调试，调试步骤如下

打开gradle.properties 里面的两行代码注释 org.gradle.jvmargs=-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5033 -Dorg.gradle.debug=true
在Android Studio建立通过 edit configurations 创建 Remote Debugger。
在Android Studio Terminal控制台中输入gradlew --daemon来启动守护线程。切换到新建的debugger
在Android Studio Terminal控制台中输入gradlew clean assembleDebug

接入说明

单模块依赖请查看各个模块说明文件
整体component依赖说明如下

1）在项目根目录的build.gradle中添加jitpack依赖

allprojects {
    repositories {
        maven { url "https://jitpack.io" }  // <===添加这行
        google()
        jcenter()
    }
}

2）在应用的build.gradle中开启dataBinding并且添加依赖

android {
  .
  .
  .
  dataBinding.enabled = true
  .
  .
  .
}

依赖所有模块方式

dependencies {
  .
  .
  .
  implementation 'com.github.codyer.component:core:1.0.66'
  annotationProcessor 'com.github.codyer.component:compiler:1.0.66'
  .
  .
  .
}

3） Application继承BaseApplication并在Application中初始化

                .
                .
                .
 ImagePicker.init();
        HttpCore.init(this)
                .withLog(true)
                .withHttpCat(HttpCat.create(this))
                .withHttpHeader(new HeaderParameterInterceptor())
                .done();
                .
                .
                .