Android 夜间模式 换肤

本文为原创,转载请注明出处。
文章标题为夜间模式,其实我这里想说的不是什么夜间模式,而是Skin库,有了Skin库,分分钟实现换肤那是小Case,并且也能分分钟实现换肤功能。当然还是那句话,说的那么屌,没图谈个几把,所以还是上个图说话:

简单介绍下图片内容:我在apk中内置了普通模式和夜间模式两套值,并且外置皮肤中也内置了普通模式和夜间模式。

ezgif-3-d97abc2e86.gif

本文为发布在Github上Skin库的Wiki,实现了Android开发中换肤的功能,欢迎各位Star。以下为Wiki内容:

说在前面的

Skin的快速使用这篇文章介绍了如何快速使用本库达到换肤,基本满足了日常的换肤需求。本篇文章着重介绍Skin库的特点。

换肤要求

不管你是准备在新工程中还是在已有工程中使用换肤功能,唯一的要求都需要你对需要换肤的资源进行规范的管理,这个规范的管理指资源的命名/分类。命名指资源的名字具有一定的规范而不是随意的命名,分类指你能够清除的知道哪些资源你是需要用于换肤的。
不管你使用何种换肤方式即使不适用Skin,这个规范都是极其重要的,切记。

Skin详细介绍

1. 属性解析工厂SkinAttrFactory

属性解析工厂描述了如何以什么规则去解析目标属性,也就是什么属性才认为是需要进行换肤的属性。Skin提供了两个属性解析工厂的实现:前缀属性解析和标记属性解析。属性解析工厂是整个Skin中的主要组件之一。目前属性解析工厂支持解析style(eg: style="@style/xxx")和引用属性(eg: android:background="@drawable/xxx",不支持值类型(eg: android:background="#ffffff")的属性。

前缀属性解析工厂PrefixSkinAttrFactory

PrefixSkinAttrFactory解析属性的规则是将包含有特定前缀的属性解析出来,eg:skin_login_bg.jpgPrefixSkinAttrFactory会依次解析布局文件中的每一个View的属性。

  • 前提:要求将工程中需要进行换肤的属性都以固定的前缀开始命名,用户可以设置任意的前缀,Skin默认以skin作为前缀。
  • 优点:因为是以前缀为规则区别换肤的属性,因此这种方式对已具规模的工程要实现换肤功能来说用处大的多,因为可以做到只修改资源名字而不用去修改引用资源的地方(比如布局文件)就可以实现资源的整理,修改资源名字的时候记得一并修改引用。
  • 缺点:由于解析的时候会自动解析每一个布局文件中的元素,因此效率上不如接下来要讲的标记属性解析工厂。

标记属性解析工厂NamespaceSkinAttrFactory

NamespaceSkinAttrFactory解析属性的规则是将布局文件中添加了http://schemas.android.com/android/skin命名空间并且增加了标记的控件属性解析出来。
eg:

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout 
    ...
    xmlns:skin="http://schemas.android.com/android/skin"
...>
    <TextView
        ...
        skin:enable="true"
        ...
    />
</FrameLayout>
  • 前提:需要对进行换肤的控件增加标记。
  • 优点:由于只会解析包含了标记的控件,因此解析效率上会更高,对新工程来说采用这种方式会更好。
  • 缺点:由于需要打标记,因此对已具规模的工程带来的劳力活会多一些。

可以扩展自己的属性解析方式,只需继承SkinAttrFactory即可。Skin默认配置标记属性解析工厂,可以通过SkinManager改变配置。

相关Api

  • 创建前缀属性解析工厂:SkinAttrFactory.createPrefixFactory(@Nullable String prefix)
  • 创建标记属性解析工厂:SkinAttrFactory.createNamespaceFactory()
  • 更改属性解析配置:SkinManager.setSkinAttrFactory(SkinAttrFactory factory)

2. 换肤属性SkinAttr

SkinAttr定义了Skin支持的属性描述。Skin默认实现了background,textColor,src三个属性,通常这三个属性已经满足了大部分的控件属性需求。
SkinAttrSupport用于管理SkinAttr,也就是说只有SkinAttrSupport中注册了的属性才会被属性解析工厂关注,而不会去处理其它额外的属性,默认注册了SkinAttr的三个默认实现。

扩展自定义属性支持

  1. 实现SkinAttr子类
    实现SkinAttr.apply(View)抽象方法,用于描述view如何使用属性。
  2. 配置子类
    调用SkinAttrSupport.addSupportAttr(String attrName, SkinAttr skinAttr)方法即可添加自定义属性。
    同样SkinAttrSupport.removeSupport(String attrName)即可移除支持的属性。

3. 换肤管理器SkinManager

SkinManager为整个换肤库的管理器,主要处理皮肤的加载,更新以及通知监听者刷新等。SkinManager需要在使用之前进行初始化,建议是在Application.onCreate()方法中进行初始化。
相关Api:

  • public void init(Context context)初始化
  • public boolean isUseSkin() 当前是否切换了皮肤
  • public void changeSkin(String suffix)通过后缀切换皮肤。
  • public void loadSkin(String skinPath, final SkinLoadListener listener)加载指定路径的皮肤插件文件更换皮肤。
  • public void loadSkin(String skinPath, @Nullable final String suffix, final SkinLoadListener listener)加载指定路径的皮肤插件文件更换皮肤,并指定文件中的皮肤属性后缀。
  • public void addSkinChangedListener(SkinChangedListener listener)添加皮肤变化监听
  • public void removeSkinChangedListener(SkinChangedListener listener)移除皮肤变化监听
  • public void notifySkinChangedListeners()通知皮肤更新
  • public void setIgnoreWhenAttrNotFound(boolean ignore)设置资源未找到时是否忽略设置,默认为true
  • public void setSkinAttrFactory(SkinAttrFactory factory)设置属性解析工厂,默认使用标记属性解析工厂。

4. 界面换肤委托SkinDelegate

SkinDelegate包含了界面实现换肤所需要的处理。其主要功能是描述了控件的加载方式,以及界面中需要进行换肤的控件管理,以及相应的界面刷新等处理。
相关Api:

  • public void beforeCallSuperOnCreate()Activity调用super.onCreate()之前调用。用于设置界面的布局加载器LayoutInflaterFactory
  • public void afterCallSuperOnCreate()Activity调用super.onCreate()之后调用。用于切换状态栏颜色等,建议使用我easy库中的透明状态栏实现。
  • public void onDestroy()ActivityonDestroy()方法中调用,用于移除界面刷新回调,以及资源回收等处理(暂无需要处理)。
  • public void setEnableSkinSwitchAnim(boolean mEnableSkinSwitchAnim)是否允许控件切换主题时使用动画(默认Fade in),默认开启。
  • public void setIsSkinSwitchAnimAlways(boolean mIsSkinSwitchAnimAlways)设置需要进行皮肤切换的view属性没有改变时是否也有动画切换,默认为false

如果不想管理SkinDelegate,则可以使用BaseSkinActivity作为程序中Activity的基类,其代管了SkinDelegate的实现。
对于已具规模的工程,可能已经有自己的BaseActivity,则可以仿照BaseSkinActivity管理一个SkinDelegate即可。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 135,324评论 19 139
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,902评论 18 399
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 47,052评论 6 342
  • 前言: 本文主要讲述如何在项目中,在不重启应用的情况下,实现动态换肤的效果。换肤这块做的比较好的,有网易云音乐,q...
    Yagami3zZ阅读 14,648评论 5 51
  • 1 在微博上有很多人给我发私信讲述自己的苦恼,诉说自己在学习、工作和感情中遇到的问题。 有时我会不太客气地说,收起...
    远近先生阅读 4,312评论 2 8