Android-Skin

Introduction: A dynamic skin framwork for Android
More: Author   ReportBugs   
Tags:

介绍

Android-Skin:极简单的 android 换肤框架,无缝支持第三方控件,一行代码即可换肤,集成成本极低, 提供丰富的 API 支持拓展,对业务代码几乎无入侵。

AndroidSkin.getInstance().saveSkinAndApply(skinFilePath, SkinLoader.ASSETS);

执行之后,app 即完成换肤,你将看到华丽的换肤效果;

Demo

Usage

1、在 app/buil.gradle 添加

compile 'com.meiyou:android-skin:1.0.9'

2、初始化

在 application oncreate 加入初始化代码

AndroidSkin.getInstance().init(this);

3、加载/恢复皮肤

加载皮肤

AndroidSkin.getInstance().saveSkinAndApply(apkFile, SkinLoader.ASSETS,null);

恢复默认皮肤

AndroidSkin.getInstance().clearSkinAndApply();

Know More

1、换肤控制粒度;

默认全 app 换肤,关闭换肤级别有:

关闭 activity 换肤

在 onCreate 加入
AndroidSkin.getInstance().registerIgnoreSkinActivity(this)
在 onDestory 加入
AndroidSkin.getInstance().unRegisterIgnoreSkinActivity(this)

关闭 view 换肤

AndroidSkin.getInstance().registerIgnoreSkinView(view)

关闭 view 的某个属性换肤

AndroidSkin.getInstance().registerIgnoreSkinView(view,"background","textColor”)

2、多种加载皮肤方式

 //从 Sd 卡保存皮肤信息,不应用
 AndroidSkin.getInstance().saveSkin(apkFile);
 AndroidSkin.getInstance().saveSkin(apkFile, SkinLoader.SDCARD);

 //从 Sd 卡保存皮肤信息并立刻应用
 AndroidSkin.getInstance().saveSkinAndApply(apkFile,listener);

 //从 assets 保存皮肤信息,不应用
 AndroidSkin.getInstance().saveSkin(apkFile, SkinLoader.ASSETS);

  //从 assets 保存皮肤信息并应用
 AndroidSkin.getInstance().saveSkinAndApply(apkFile,SkinLoader.ASSETS,listener);

 //从 sd 卡保存皮肤信息并应用
 AndroidSkin.getInstance().saveSkinAndApply(apkFile,listener);
 AndroidSkin.getInstance().saveSkinAndApply(apkFile,SkinLoader.SDCARD,listener);

3、动态设置

由于换肤原理采用的是 Hook LayoutInflater 的方式,所以对于用户自己 new 出来的 View 不具有动态换肤的效果 所以提供了一系列的 API 来满足这方面的需求;

获取相应的换肤资源,这里主要用于需要对 Color 或者 Drawable 进行操作的需求

AndroidSkin.getInstance().getSkinId();

AndroidSkin.getInstance().getSkinDrawable();

AndroidSkin.getInstance().getSkinColorDrawable()

AndroidSkin.getInstance().getSkinColorStateList();

AndroidSkin.getInstance().getSkinColor();

手动设置换肤

AndroidSkin.getInstance().setBackgroundDrawable();

AndroidSkin.getInstance().setImageDrawable();

AndroidSkin.getInstance().setTextColor();

自定义属性换肤

AndroidSkin.getInstance().addCustomAttrSupport(R.attr.tv_border_color,
            new ICustAttrApplyForColorListener<TestView>() {

                @Override
                public void applyColor(int attrId, TestView view, ColorStateList color) {
                    view.setBorderColor(color.getDefaultColor());
                }
            });

Fragment 换肤注意事项

fragment 的 onCrateView 用来 inflate 的对象必须是 AndroidSkin.getLayoutInflater();

4、打包皮肤包

和普通的打包 apk 包一样,将同名资源在对应的 res 文件夹下即可,具体请参考 project 的 skinone 和 skintwo; 比如:

主 app 里 TextView:android:textColor="R.color.white";其中

<color name="white">#ffffff</color>

则在换肤工程里 res 也加上 white 这个对应的换肤颜色即可

 <color name="white">#fffeee</color>

然后 gradle clean assembleRelease 生成 apk,放到主 app 的 assets 下或者放到 sd 卡, 使用 AndroidSkin 加载皮肤即可生效

License MIT

Apps
About Me
GitHub: Trinea
Facebook: Dev Tools