简介
Android使用XML描述View结构，在运行时进行解析显示的方式，无法避免反射与IO的耗时。QXML提供一种低侵入、可拓展、代码配置的形式将layout文件转换为Java代码，以提高View构建效率。
GitHub地址：Qxml
与X2C的对比
X2C：
使用注解处理器生成View类，使用时需要在类中添加注解，并替换setContentView方法，侵入性较强；
对于布局属性的支持不够完美，在生成的类中容易报错；
自定义属性的拓展不够方便；
对多layout type、View Compat、LayoutInflate Factory等等的支持不够全面。
Qxml：
使用transform生成View类，生成View的规则通过添加注解类实现，可以做到规则与代码的边界分离，无需改动原有代码即可接入；
对布局属性支持较好，目标是完全的UI一致性；
自定义属性可实现复杂的逻辑，拓展方便实现；
支持多layout type、View Compat、LayoutInflate Factory等等特性，可实现换肤，拓展View等功能。
性能表现
与 inflate 比较可减少 40%+加载时间，随布局复杂度提高而提高，详见 demo 性能测试。
要求
Gradle 3.5.0 以上
目前支持的组件
Base
| 组件 | 支持属性 | 组件 | 支持属性 | 组件 | 支持属性 |
|---|---|---|---|---|---|
| View | almost | TextView | almost | EditText | almost |
| Button | almost | ImageView | almost | Button | almost |
| CheckBox | almost | ImageButton | almost | ImageView | almost |
| SeekBar | almost | RatingBar | almost | Spinner | almost |
| Switch | almost | tableLayout | almost | TableRow | almost |
| ViewStub | almost | ScrollView | almost | HorizontalScrollView | almost |
| ProgressBar | almost | SurfaceView | almost | RadioGroup | almost |
| RadioButton | almost | LinearLayout | almost | RelativeLayout | almost |
| FrameLayout | almost | TextureView | almost | WebView | almost |
| ListView | almost | GridLayout | almost | ExpandableListView | almost |
| ViewFlipper | almost | ViewSwitcher | almost | TextSwitcher | almost |
| VideoView | almost | ToggleButton | almost | Space | almost |
| include | almost | merge | almost | DataBinding | almost |
| custom style | almost | system style | none | layout multi type | almost |
Support & Androidx
| 组件 | 支持属性 | 组件 | 支持属性 | 组件 | 支持属性 |
|---|---|---|---|---|---|
| AppBarLayout | almost | CardView | almost | CollapsingToolbarLayout | almost |
| ConstraintLayout | almost | Group | almost | Guideline | almost |
| Placeholder | almost | Barrier | almost | MotionLayout | almost |
| CoordinatorLayout | almost | DrawerLayout | almost | RecyclerView | almost |
| NestedScrollView | almost | TabLayout | almost | TabItem | almost |
| Toolbar | almost | ViewPager | almost | Fragment | androidx not support |
| SwipeRefreshLayout | all | TextInputLayout | almost |
Third Part
| 组件 | 支持属性 | 组件 | 支持属性 | 组件 | 支持属性 |
|---|---|---|---|---|---|
| Lottie | almost | fresco | almost |
基础使用
1. 在 Project build.gradle 中添加依赖
buildscript {
...
ext.qxml_version = "3.0.0"
repositories {
...
mavenCentral()
}
...
dependencies {
...
classpath "io.github.duduhuang88:gradle-plugin:$qxml_version"
...
}
}
2. 在 module build.gradle 中添加依赖
// 于 apply plugin: 'com.android.application' or 'com.android.library' 之后
apply plugin: 'com.qxml.code.plugin'
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
dependencies {
...
kapt "io.github.duduhuang88:qxml-processor:$qxml_version"
or
annotationProcessor "io.github.duduhuang88:qxml-processor:$qxml_version"
//support
implementation "io.github.duduhuang88:qxml-support:$qxml_version"
//androidx
implementation "io.github.duduhuang88:qxml-androidx:$qxml_version"
...
}
3. 配置
android {
......
sourceSets {
main {
......
resources.srcDirs += "build/qxml/tempRes"
......
}
}
}
qxml {
enable true //是否开启，默认true
useFactory false //是否使用layoutInflater的factory，开启时性能有损耗，默认false
viewDebug false //是否在转换的View上显示标志，默认false
logEnable false //是否开启log，默认false
debugEnable false //是否开启debug，默认false，开启时会输出一些调试信息和文件
compatMode com.qxml.CompatMode.AUTO //compat模式，默认AUTO
acceptReferenceStyle true //是否接受style引用，仅支持很少部分引用，默认true
ignoreUnImplementAttr true //是否忽略未实现的属性，默认true
useCreateViewListener false //使用createViewListener，默认false
checkMethod false //是否检查View属性配置变化进行重新生成，设置false可提高transform速度，默认false，如果修改/自定义View属性时设置为false需删除缓存（build/qxml或clean）
//以上为默认设置
buildType {
debug { //单独配置debug，没有设置的值会使用默认设置
viewDebug false
}
release {
viewDebug false
}
}
}
4. gradle.properties可选配置
QXML_VALID_CODE = *** : 自定义View时使用，用于本地验签
QXML_LOG_ENABLE = true/false : 是否开启annotationProcesser的log
QXML_USING_STABLE_ID = true/false : 是否使用固定资源Id 已废弃
5. layout可选配置
在layout.xml根节点中可使用：
app:qxml : genIgnore(忽略) genWithUnImplementAttr(生成) genWithoutUnImplementAttr(当没有未实现的属性时才生成)
app:qxml_use_factory： 使用 Layoutinflater factory
app:qxml_debug：是否显示view的debug标志
app:qxml_compat：never(不使用compat) auto(自动选择) force(强制使用)
注：配置对根节点下的全部View都生效，且优先级高于gradle中的配置
6. 简单的构建结果的图表显示
构建结束后，在 build\qxml\report.html 中有简单的结果图表
7. 混淆
暂无需要
