Android-skin-support: 一款用心去做的Android 换肤框架

Android-skin-support: 一款用心去做的Android 换肤框架

Android-skin-support

中文 | In English

介绍功能TODO目录结构 Demo框架用法导入使用初始化皮肤开关加载插件皮肤库自定义view换肤 应用内换肤插件式换肤新建皮肤工程添加皮肤资源生成皮肤插件加载皮肤插件 自定义加载策略自定义sdcard路径zip包中加载资源 动态设置资源动态设置颜色动态设置图片 获取当前使用皮肤 AlertDialog换肤更新日志skin-support 更新日志skin-support-design 更新日志skin-support-cardview 更新日志skin-support-constraint-layout 更新日志 第三方控件适配库hdodenhof/CircleImageViewH07000223/FlycoTabLayout 缺点谁在使用FAQ技术交流LICENSE

介绍

Android-skin-support: 一款 Android 换肤框架, 极低的学习成本, 极好的用户体验.

只需要一行代码, 就可以实现换肤, 你值得拥有!!!

SkinCompatManager.withoutActivity(this).loadSkin();

就这么简单, 你的APK已经拥有了强大的换肤功能, 当然现在是拥有了换肤功能, 别忘了制作皮肤包.

功能

支持布局中用到的资源换肤。 支持代码中设置的资源换肤。 默认支持大部分基础控件，Material Design换肤。 支持动态设置主题颜色值，支持选择sdcard上的图片作为drawable换肤资源。 支持多种加载策略(应用内/插件式/自定义sdcard路径/zip等资源等)。 资源加载优先级: 动态设置资源-加载策略中的资源-插件式换肤/应用内换肤-应用资源。 支持定制化，选择需要的模块加载。 支持矢量图(vector/svg)换肤。 skin-support 4.0.0以上支持AndroidX，4.0.0以下支持support库

详细内容, 请查看更新日志，那里有所有功能提交记录

TODO

解耦androidx 支持原生组件换肤 支持多语言。 支持多字体。 支持Preference。 skin-mobile 实现: 动态修改主题颜色值 控件使用案例 关于页面 Wiki

目录结构

demo // 换肤demo 集合

skin-sample(skin-app) // demo app

skin-night // 夜间模式皮肤工程

androidx // Android 原生控件

skin-support // 换肤框架

skin-support-appcompat // 换肤框架, 基础控件支持

skin-support-cardview // 换肤框架, CardView 支持

skin-support-design // 换肤框架, Material Design 支持

skin-support-constraint-layout // 换肤框架, ConstraintLayout 支持

third-part-support // 第三方控件换肤支持

Demo

用法

最新版本选择, 请查看更新日志

导入:

support library

如果项目中还在使用support库，添加以下依赖

implementation 'skin.support:skin-support:3.1.4'       // skin-support 基础控件支持implementation 'skin.support:skin-support-design:3.1.4' // skin-support-design material design 控件支持[可选]implementation 'skin.support:skin-support-cardview:3.1.4' // skin-support-cardview CardView 控件支持[可选]implementation 'skin.support:skin-support-constraint-layout:3.1.4' // skin-support-constraint-layout ConstraintLayout 控件支持[可选]

在Application的onCreate中初始化

@Overridepublic 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();}

如果项目中使用的Activity继承自AppCompatActivity，需要重载getDelegate()方法

@NonNull@Overridepublic AppCompatDelegate getDelegate() { return SkinAppCompatDelegateImpl.get(this, this);}

AndroidX support:

如果项目中使用了AndroidX, 添加以下依赖

implementation 'skin.support:skin-support:4.0.5'       // skin-supportimplementation 'skin.support:skin-support-appcompat:4.0.5'     // skin-support 基础控件支持implementation 'skin.support:skin-support-design:4.0.5' // skin-support-design material design 控件支持[可选]implementation 'skin.support:skin-support-cardview:4.0.5' // skin-support-cardview CardView 控件支持[可选]implementation 'skin.support:skin-support-constraint-layout:4.0.5' // skin-support-constraint-layout ConstraintLayout 控件支持[可选]

⚠️ 从3.x.x迁移至4.0.5+, 解耦了换肤库对appcompat包的依赖，需要新增以下代码

implementation 'skin.support:skin-support-appcompat:4.0.5'     // skin-support 基础控件支持

在Application的onCreate中初始化

@Overridepublic void onCreate() { super.onCreate(); SkinCompatManager.withoutActivity(this) .addInflater(new SkinAppCompatViewInflater()) // 基础控件换肤初始化 .addInflater(new SkinMaterialViewInflater()) // material design 控件换肤初始化[可选] .addInflater(new SkinConstraintViewInflater()) // ConstraintLayout 控件换肤初始化[可选] .addInflater(new SkinCardViewInflater()) // CardView v7 控件换肤初始化[可选] .setSkinStatusBarColorEnable(false) // 关闭状态栏换肤，默认打开[可选] .setSkinWindowBackgroundEnable(false) // 关闭windowBackground换肤，默认打开[可选] .loadSkin();}

如果项目中使用的Activity继承自AppCompatActivity，需要重载getDelegate()方法

@NonNull@Overridepublic AppCompatDelegate getDelegate() { return SkinAppCompatDelegateImpl.get(this, this);}

使用:

皮肤开关

如果项目中有特殊需求。例如, 股票控件: 控件颜色始终为红色或绿色, 不需要随着模式切换而换肤

那么可以使用类似的方法, 直接设置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();

自定义View换肤

要点:

实现SkinCompatSupportable接口 applySkin方法中实现换肤操作 在构造方法中解析出需要换肤的resId

自定义View可以直接继承自SkinCompatView, SkinCompatLinearLayout等已有控件 eg: CustomTextView 不想继承自已有控件 eg: CustomTextView2 需要换肤自定义属性 // 需要换肤AutoCompleteTextView的R.attr.popupBackground属性 eg: SkinCompatAutoCompleteTextView 需要使用第三方库控件怎么办 // 需要使用https://github.com/hdodenhof/CircleImageView 控件, 并且要支持换肤 eg: SkinCompatCircleImageView

应用内换肤:

应用内换肤，皮肤名为: 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']}}

插件式换肤:

新建Android application工程

皮肤工程包名不能和宿主应用包名相同.

例如:

宿主包名: com.ximsfei.skindemo夜间模式: com.ximsfei.skindemo.night

将需要换肤的资源放到res目录下(同名资源)

例如 APK中窗口背景颜色为

colors.xml

#ffffff

那么夜间模式你可以在skin-night工程中设置

colors.xml

#000000

打包生成apk, 即为皮肤包

将打包生成的apk文件, 重命名为'xxx.skin', 防止apk结尾的文件造成混淆.

加载皮肤插件

加载插件式皮肤, 将皮肤包放到assets/skins目录下

SkinCompatManager.getInstance().loadSkin("night.skin", SkinCompatManager.SKIN_LOADER_STRATEGY_ASSETS);

自定义加载策略:

自定义sdcard路径

继承自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);

zip包中加载资源

继承自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();

资源加载优先级: 用户自定义颜色值-加载策略中的资源-皮肤包资源-应用资源。

获取当前使用皮肤

https://github.com/ximsfei/Android-skin-support/blob/master/androidx/skin-support/src/main/java/skin/support/utils/SkinPreference.java

缺点

同一个LayoutInflater只能设置一次Factory，容易和同类库产生冲突

谁在使用

如果你想提交作品，欢迎提出 PR 或联系作者。

技术交流

License MIT

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。