Skip to content

Skin:详细介绍

Jump to bottom
SupLuo edited this page Apr 5, 2017 · 3 revisions

说在前面的

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.jpg。PrefixSkinAttrFactory会依次解析布局文件中的每一个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()在Activity的onDestroy()方法中调用，用于移除界面刷新回调，以及资源回收等处理（暂无需要处理）。
  • public void setEnableSkinSwitchAnim(boolean mEnableSkinSwitchAnim)是否允许控件切换主题时使用动画（默认Fade in）,默认开启。
  • public void setIsSkinSwitchAnimAlways(boolean mIsSkinSwitchAnimAlways)设置需要进行皮肤切换的view属性没有改变时是否也有动画切换，默认为false

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

Clone this wiki locally