MagicaSakura多主题框架

如何不重启APP切换多主题?
如何只写一份drawable或layout就可以自动适配各种多主题?
如何兼容低版本的Android系统?
如何减少开发人员的学习成本,能够快速适应多主题框架?
开源多主题框架 MagicaSakura 都可以帮你做到。
(备注:此处的多主题是指轻量级的多彩主题色,而非插件化形式的多主题皮肤)

不重启APP切换主题

MagicaSakura提供了全局方法Theme.refreshUI,直接调用即可无需重启App更换应用主题(当然必须得在主线程-,-),同时该方法提供了额外的回调参数,以便满足在主题切换过程中的各种自定义需求。

自适应多主题

  • Drawable XML
    使用预先定义的颜色值,只需编写一份drawable即可自动适配多主题样式,无需再为每一种主题都编写一份drawable或style。
    • selector,item , shape, layerlist,color 等常规xml标签都已支持,能满足应用基本开发需求。

    • 额外支持在xml中直接染色 (app : drawableTint , app : drawableTintMode) 以及在shape标签中配置颜色透明度(android : alpha)。如:

      • 直接染色
        <selector
            xmlns:android="http://schemas.android.com/apk/res/android"
            xmlns:app="http://schemas.android.com/apk/res-auto">
               <item android:drawable="@drawable/icon " android:state_pressed="true"
        

app:drawableTint=”@color/theme_color_primary” />
<item android:drawable=”@drawable/icon” app:drawableTint=”@color/gray_dark” />
</selector>
“`

 - 标签配置颜色透明度
```java
 <selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:state_enabled="true" android:state_pressed="true">
        <shape>
          <corners android:radius="4dp" />
          <solid android:color="@color/theme_color_primary_dark" />
        </shape>
    </item>
    <item android:state_enabled="true">
        <shape>
          <solid android:color="@color/theme_color_primary" />
          <corners android:radius="4dp" />
        </shape>
    </item>
    <item android:state_enabled="false">
        <shape>
          <solid android:alpha="0.3" android:color="@color/theme_color_primary" />
          <corners android:radius="4dp" />
    </shape>
    </item>
</selector>
```
  • Layout XML
    使用MagicaSakura中的提供的TintXXX控件可以在layout 中直接对其drawable属性进行染色,如:background, src, drawableLeft, button 等,并且包括文字颜色,超链接颜色在内都可以自动跟随多主题变化,非常快捷方便。

// TintTextView
//其中drawableRightTint中的selector_lock是一个ColorStateList
<com.bilibili.magicasakura.widgets.TintTextView
xmlns:app=”http://schemas.android.com/apk/res-auto
android:layout_width=”wrap_content”
android:layout_height=”wrap_content”
android:drawablePadding=”@dimen/padding_half”
android:drawableRight=”@drawable/selector_lock”
android:text=”@string/textview_title”
android:textColor=”@color/selector_text”
android:textSize=”19sp”
app:drawableRightTint=”@color/selector_lock”/>


- **代码中适配多主题**
  MagicaSakura支持在代码中直接适配多主题。
  - 对于MagicaSakura中的TintXXX控件
   在代码中可以直接对TintXXX控件的相关drawable进行染色,使用方法与Android原生控件基本一致,例子如下:
    
    ``` java
       //TextView的background是一个shape类型的selector,那么就可以直接调用setBackgroundResource()方法进行染色。
        tintTextView.setBackgroundResource(R.drawable.selector_shape_lock);

       //ImageView的src是一个包含png的selector,那么只需比Android原生控件多调用一个方法。
       tintImageView.setImageResource(R.drawable.selecor_png_lock);
       tintImageView.setImageTintList(R.color.selector_color_lock);
  • 对于一些特殊需求或一些自定义控件
    MagicaSakura中提供了ThemeUtils工具类,该工具类主要提供了drawable染色以及主题色自动转换的相关方法,其中主题色自动转换支持colorStateList和 color,可以非常方便的在代码中进行多主题适配。
    // R.color.selector_color.lock 通过 getThemeColorStateList转换,返回主题色相关的colorStateList。
    ThemeUtils.getThemeColorStateList(context, R.color.selector_color.lock);
    

兼容低版本的Android系统

MagicaSakura目前兼容的最低SDK版本为API 15,即Android 4.0.3版本,基本符合绝大多数APP开发中的最低API要求。

尽量减少学习成本

为减少学习成本,MagicaSakura基于Android原生控件封装了一套TintXXX控件,包含所有常用的控件类型,如:TextView,Button,EditText, ProgressDialog等,能基本满足常规应用开发需求。
TintXXX控件可自动适配多主题样式,支持在layout.xml,drawable.xml 和代码中配置。特别的在layout.xml中可以方便地与Android原生属性配合使用,如 app:drawableLeftTint可以直接染色android:drawableLeft,app: backgroundTint 直接染色android:background等。

关于夜间模式和多主题皮肤

MagicaSakura支持夜间模式平滑切换(即无需重启应用),只需在res中按需添加相关的xxx_night资源文件包。
特别得当app的support库版本低于23.2.0时,可以直接使用MagicaSakura内提供的ThemeUtils.updateNightMode()方法切换夜间模式,当support库版本大于等于23.2.0时可以使用support库提供的方法。其实Android是原生支持夜间模式的,更多介绍可以详见android多主题之坑这篇文章。

多主题皮肤和多彩主题是不完全相同的,支持多主题皮肤一般需要引入插件框架,而多彩主题则相对轻量一些。目前MagicaSakura暂不支持多主题皮肤,以后会考虑增加对其的支持。

开源

经过几周的筹备和优化,现正式将多主题框架MagicaSakura开源,希望能对你有所帮助。

  • 相关源码和详细文档都已在GitHub开源,欢迎大家来围观,指出不足之处,一起来完善MagicaSakura多主题框架。
    传送门地址:MagicaSakura

  • Demo下载地址: 点击直接下载

欢迎查看 个人博客.

    原文作者:_xyczero
    原文地址: https://www.jianshu.com/p/2a0d72275710
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞