中文 | In English
Android-skin-support: 一款用心去做的Android 换肤框架, 极低的学习成本, 极好的用户体验.
只需要一行代码, 就可以实现换肤, 你值得拥有!!!
SkinCompatManager.withoutActivity(this).loadSkin();就这么简单, 你的APK已经拥有了强大的换肤功能, 当然现在是拥有了换肤功能, 别忘了制作皮肤包.
- 支持布局中用到的资源换肤。
- 支持代码中设置的资源换肤。
- 默认支持大部分基础控件，Material Design换肤。
- 支持动态设置主题颜色值，支持选择sdcard上的图片作为drawable换肤资源。
- 支持多种加载策略(应用内/插件式/自定义sdcard路径/zip等资源等)。
- 资源加载优先级: 动态设置资源-加载策略中的资源-插件式换肤/应用内换肤-应用资源。
- 支持定制化，选择需要的模块加载。
- 支持矢量图(vector/svg)换肤。
详细内容, 请查看更新日志，那里有所有功能提交记录
- 解耦skin-support对appcompat-v7的依赖。
-
AppCompatDelegate.setCompatVectorFromResourcesEnabled(true);开关使用错误问题修正。 - 支持多语言。
- 支持多字体。
- 支持Preference。
- skin-sample 实现:
- 动态修改主题颜色值案例
- 控件使用案例
- 更新日志tab
- 关于页面
- Wiki
demo // 换肤demo 集合
skin-sample(skin-app) // demo app
skin-night // 夜间模式皮肤工程
android-support // Android 原生控件
skin-support // 换肤框架, 基础控件支持
skin-support-cardview // 换肤框架, CardView 支持
skin-support-design // 换肤框架, Material Design 支持
skin-support-constraint-layout // 换肤框架, ConstraintLayout 支持
third-part-support // 第三方控件换肤支持
直接添加依赖, 最新版本选择, 请查看更新日志
implementation 'skin.support:skin-support:3.1.0-beta1' // skin-support 基础控件支持
implementation 'skin.support:skin-support-design:3.1.0-beta1' // skin-support-design material design 控件支持[可选]
implementation 'skin.support:skin-support-cardview:3.1.0-beta1' // skin-support-cardview CardView 控件支持[可选]
implementation 'skin.support:skin-support-constraint-layout:3.1.0-beta1' // skin-support-constraint-layout ConstraintLayout 控件支持[可选]@Override
public void onCreate() {
super.onCreate();
SkinCompatManager.withoutActivity(this) // 基础控件换肤初始化
.addInflater(new SkinMaterialViewInflater()) // material design 控件换肤初始化[可选]
.addInflater(new SkinConstraintViewInflater()) // ConstraintLayout 控件换肤初始化[可选]
.addInflater(new SkinCardViewInflater()) // CardView v7 控件换肤初始化[可选]
.setSkinStatusBarColorEnable(false) // 关闭状态栏换肤，默认打开[可选]
.setSkinWindowBackgroundEnable(false) // 关闭windowBackground换肤，默认打开[可选]
.loadSkin();
}如果项目中有特殊需求。例如, 股票控件: 控件颜色始终为红色或绿色, 不需要随着模式切换而换肤
那么可以使用类似的方法, 直接设置drawable
setBackgroundDrawable(redDrawable) // 不支持换肤
background="#ce3d3a"而不是使用R.drawable.red
setBackgroundResource(R.drawable.red)
background="@drawable/red"// 指定皮肤插件
SkinCompatManager.getInstance().loadSkin("new.skin"[, SkinLoaderListener], int strategy);
// 恢复应用默认皮肤
SkinCompatManager.getInstance().restoreDefaultTheme();要点:
-
实现SkinCompatSupportable接口
-
applySkin方法中实现换肤操作
-
在构造方法中解析出需要换肤的resId
-
自定义View可以直接继承自SkinCompatView, SkinCompatLinearLayout等已有控件
eg: CustomTextView
-
不想继承自已有控件
eg: CustomTextView2
-
需要换肤自定义属性
// 需要换肤AutoCompleteTextView的R.attr.popupBackground属性
-
需要使用第三方库控件怎么办
// 需要使用https://github.com/hdodenhof/CircleImageView 控件, 并且要支持换肤
应用内换肤，皮肤名为: night; 新增需要换肤的资源添加后缀 night或者前缀 night。
需要换肤的资源为R.color.windowBackgroundColor, 添加对应资源R.color.windowBackgroundColor_night。
加载应用内皮肤:
SkinCompatManager.getInstance().loadSkin("night", SkinCompatManager.SKIN_LOADER_STRATEGY_BUILD_IN); // 后缀加载
SkinCompatManager.getInstance().loadSkin("night", SkinCompatManager.SKIN_LOADER_STRATEGY_PREFIX_BUILD_IN); // 前缀加载推荐将应用内换肤相关的皮肤资源放到单独的目录中
eg: res-night
注: 如果使用这种方式来增加换肤资源，记得在build.gradle 中配置一下这个资源目录 sourceSets {main {res.srcDirs = ['src/main/res', 'src/main/res-night']}}
皮肤工程包名不能和宿主应用包名相同.
例如:
宿主包名: com.ximsfei.skindemo
夜间模式: com.ximsfei.skindemo.night例如 APK中窗口背景颜色为
colors.xml
<color name="background">#ffffff</color>那么夜间模式你可以在skin-night工程中设置
colors.xml
<color name="background">#000000</color>将打包生成的apk文件, 重命名为'xxx.skin', 防止apk结尾的文件造成混淆.
加载插件式皮肤, 将皮肤包放到assets/skins目录下
SkinCompatManager.getInstance().loadSkin("night.skin", SkinCompatManager.SKIN_LOADER_STRATEGY_ASSETS);继承自SkinSDCardLoader，通过getSkinPath方法指定皮肤加载路径，通过getType方法指定加载器type。
public class CustomSDCardLoader extends SkinSDCardLoader {
public static final int SKIN_LOADER_STRATEGY_SDCARD = Integer.MAX_VALUE;
@Override
protected String getSkinPath(Context context, String skinName) {
return new File(SkinFileUtils.getSkinDir(context), skinName).getAbsolutePath();
}
@Override
public int getType() {
return SKIN_LOADER_STRATEGY_SDCARD;
}
}注: 自定义加载器type 值最好从整数最大值开始递减，框架的type值从小数开始递增，以免将来框架升级造成type 值冲突
在Application中，添加自定义加载策略:
SkinCompatManager.withoutActivity(this)
.addStrategy(new CustomSDCardLoader()); // 自定义加载策略，指定SDCard路径注: 自定义加载器必须在Application中注册，皮肤切换后，重启应用需要根据当前策略加载皮肤
使用自定义加载器加载皮肤:
SkinCompatManager.getInstance().loadSkin("night.skin", null, CustomSDCardLoader.SKIN_LOADER_STRATEGY_SDCARD);继承自SkinSDCardLoader，在loadSkinInBackground方法中解压资源，在getDrawable等方法中返回加压后的资源。
public class ZipSDCardLoader extends SkinSDCardLoader {
public static final int SKIN_LOADER_STRATEGY_ZIP = Integer.MAX_VALUE - 1;
@Override
public String loadSkinInBackground(Context context, String skinName) {
// TODO 解压zip包中的资源，同时可以根据skinName安装皮肤包(.skin)。
return super.loadSkinInBackground(context, skinName);
}
@Override
protected String getSkinPath(Context context, String skinName) {
// TODO 返回皮肤包路径，如果自需要使用zip包，则返回""
return new File(SkinFileUtils.getSkinDir(context), skinName).getAbsolutePath();
}
@Override
public Drawable getDrawable(Context context, String skinName, int resId) {
// TODO 根据resId来判断是否使用zip包中的资源。
return super.getDrawable(context, skinName, resId);
}
@Override
public int getType() {
return SKIN_LOADER_STRATEGY_ZIP;
}
}资源加载策略更灵活，不仅仅只有皮肤包，开发者可配置任意资源获取方式(Zip/Apk/Json...)。
在Application中，添加自定义加载策略:
SkinCompatManager.withoutActivity(this)
.addStrategy(new ZipSDCardLoader()); // 自定义加载策略，加载zip包中的资源SkinCompatUserThemeManager.get().addColorState(R.color.colorPrimary, #ffffffff);
SkinCompatUserThemeManager.get().addColorState(R.color.colorPrimary, new ColorState.ColorBuilder().addXxx().build());
// 清除所有已有颜色值。
SkinCompatUserThemeManager.get().clearColors();SkinCompatUserThemeManager.get().addDrawablePath(R.drawable.windowBackground, "／sdcard/DCIM/Camera/xxx.jpg");
// 要换肤的资源id，图片路径，图片旋转角度(默认为0)
SkinCompatUserThemeManager.get().addDrawablePath(R.drawable.windowBackground, "／sdcard/DCIM/Camera/xxx.jpg", 90);
// 清除所有已有图片路径。
SkinCompatUserThemeManager.get().clearDrawables();在设置完颜色及图片后，需要调用apply()方法来保存设置。
SkinCompatUserThemeManager.get().apply();资源加载优先级: 用户自定义颜色值-加载策略中的资源-皮肤包资源-应用资源。
 |
 |
 |
 |
| 搜狐新闻探索版 | 讯飞语记 | qoo app | 多维新闻 |
