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:



    

  • 前提:需要对进行换肤的控件增加标记。
  • 优点:由于只会解析包含了标记的控件,因此解析效率上会更高,对新工程来说采用这种方式会更好。
  • 缺点:由于需要打标记,因此对已具规模的工程带来的劳力活会多一些。

可以扩展自己的属性解析方式,只需继承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即可。

你可能感兴趣的:(Android 夜间模式 换肤)