一个低侵入，可配置的 Android 库，用于将 layout xml 文件转换为 Java 代码以提高性能。
- 使用注解处理器生成View类，使用时需要在类中添加注解，并替换setContentView方法，侵入性较强；
- 对于布局属性的支持不够完美，在生成的类中容易报错；
- 自定义属性的拓展不够方便；
- 对多layout type、View Compat、LayoutInflate Factory等等的支持不够全面。
- 使用transform生成View类，生成View的规则通过添加注解类实现，可以做到规则与代码的边界分离，无需改动原有代码即可接入；
- 对布局属性支持较好，目标是完全的UI一致性；
- 自定义属性可实现复杂的逻辑，拓展方便实现；
- 支持多layout type、View Compat、LayoutInflate Factory等等特性，可实现换肤，拓展View等功能。
与 inflate 比较可减少 40%+加载时间，随布局复杂度提高而提高，详见 demo 性能测试。
Gradle 3.5.0 以上
| 组件 | 支持属性 | 组件 | 支持属性 | 组件 | 支持属性 |
|---|---|---|---|---|---|
| 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 | ||||
| include | almost | merge | almost | DataBinding | almost |
| custom style | almost | system style | none | layout multi type | almost |
| 组件 | 支持属性 | 组件 | 支持属性 | 组件 | 支持属性 |
|---|---|---|---|---|---|
| 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 | almost |
| 组件 | 支持属性 | 组件 | 支持属性 | 组件 | 支持属性 |
|---|---|---|---|---|---|
| Lottie | almost |
最新版本为 1.0.3，查看 Releases 获取最新版本信息
buildscript {
...
ext.qxml_version = "1.0.3"
repositories {
...
mavenCentral()
}
...
dependencies {
...
classpath "io.github.duduhuang88:gradle-plugin:$qxml_version"
...
}
}
// 于 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"
...
}
aaptOptions使用固定资源ID可提高缓存使用
android {
......
sourceSets {
main {
......
resources.srcDirs += "build/qxml/tempRes"
......
}
}
//可选设置，保持资源id不变可以优化缓存使用
aaptOptions {
File publicTxtFile = new File(buildDir, "qxml/public.txt")
if (publicTxtFile.exists()) {
additionalParameters "--stable-ids", "${publicTxtFile.absolutePath}"
}
}
}
qxml {
enable true //是否开启
useFactory false //是否使用layoutInflater的factory，开启时性能有损耗
viewDebug false //是否在转换的View上显示标志
logEnable true //是否开启log
compatMode com.qxml.CompatMode.AUTO //compat模式
acceptReferenceStyle true //是否接受style引用，仅支持很少部分引用
useCreateViewListener true //使用createViewListener
//以上为默认设置
buildType {
debug { //单独配置debug，没有设置的值会使用默认设置
viewDebug true
}
release {
viewDebug false
}
}
}在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中的配置
构建结束后，在 build\qxml\report.html 中有简单的结果图表
暂无需要
Copyright 2021 duduhuang88
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.