AndroidResourceTools
因为模块化开发时,android 的资源名称(除id外)是不能重名的,如果手动修改,很繁琐; 本插件的目的:重命名Android 资源名称与资源文件名;方便模块化开发;
效果展示
使用说明
- 在项目的根目录
build.gradle
,添加依赖如下
dependencies {
...
classpath 'com.github.better.restools:ResTools:1.0.1'
}
- 在对应的 module 下
build.gradle
下,apply 插件,如下:
apply plugin: 'com.android.application'
apply plugin: 'plugin.resTools' // 资源重命名插件
// 配置插件dsl
resConfig {
new_prefix = 'better_' // 资源前缀
old_prefix = '' // 老前缀,可为''空字符串
// === below use default
// resFolderPath 资源目录
// srcFolderPath 源代码目录
// manifestFilePath 清单文件目录
}
- clean 工程后,可以发现,在对应的 module 下,可发现
resourcetools
task 组,展开,点击「replaceResName」 执行;
特别说明(特别重要)
- 因是直接替换文件,千万不要在主分支,主开发分支使用,建议使用新分支,测试ok后,合并;
- 目前插件没有加入文件事务处理,即:不能实现要么全部成功,要么全部失败;
1.0.1
版本支持的资源如下:
通过分析Android工程,分析得出Android App 工程的资源分为2大类:
- 文件夹类型;
- values类型(目前values类型,尚不支持 attrs 与 styles);
资源类型 | 源代码中 | xml引用中 | 备注 |
---|---|---|---|
layout | R.layout.XXX import kotlinx.android.synthetic.main.xxx.* |
@layout/XXX | 布局文件 kotlin导入布局时,重名支持 |
drawable | R.drawable.XXX | @drawable/XXX | |
anim | R.anim.XXX | @anim/XXX | |
color | R.color.XXX | @color/XXX | |
mipmap | R.mipmap.XXX | @mipmap.XXX | |
menu | R.menu.XXX | Xml 暂无引用 | |
raw | R.raw.XXX | Xml 暂无引用 | |
xml | R.xml.XXX | Xml 暂无引用 | |
string | R.string.XXX | @string/XXX | |
color | R.color.XXX | @color/XXX | |
dimens | R.dimen.XXX | @dimen/XXX | |
arrays | R.array.XXX | @array/XXX | |
style | R.style.XXX | @style/XXX | 需要考虑到parent,比较复杂 |
attr | R.attr.XXX | 需要特殊处理,主要在自定义属性上 |
TODO
- 文件的事务操作有待支持;
- Attrs 有待支持;
- style有待支持;
- 其他资源类型有待支持;
- 如果资源名称与Android自带资源名重复时,会发生替换问题,此问题,有待修正;