Android-skin-support

简介:Android-skin-support: 一款用心去做的 Android 换肤框架, 极低的学习成本, 极好的用户体验. 只需要两行代码, 就可以实现换肤, 你值得拥有!!!
更多:作者   提 Bug   
标签:
换肤-

skin-support-v1.2.7 design-v1.2.4 cardview-v1.2.0

circleimageview-v2.2.0.2

介绍

Android-skin-support: 一款用心去做的 Android 换肤框架, 极低的学习成本, 极好的用户体验.

只需要两行代码, 就可以实现换肤, 你值得拥有!!!

第一行: 在 Application 的 onCreate 中初始化

SkinCompatManager.init(this).loadSkin();

第二行: 继承自 SkinCompatActivity

public class BaseActivity extends SkinCompatActivity {}

就这么简单, 你的 APK 已经拥有了强大的换肤功能.

skin-app // 换肤 demo app

skin-night // 换肤 demo 夜间模式

skin-support // 换肤框架, 基础控件支持

skin-support-design // 换肤框架, Material Design 支持

最佳实践

仿网易云音乐

仿网易云音乐皮肤切换

仿网易云音乐应用下载

red 1 red 2 red 3

white 1 white 2 white 3

night 1 night 2 night 3

用法

导入:

直接添加依赖, 最新版本选择, 请查看更新日志

compile 'skin.support:skin-support:1.2.7'          // skin-support 基础控件支持
compile 'skin.support:skin-support-design:1.2.4'   // skin-support-design material design 控件支持[可选]
compile 'skin.support:skin-support-cardview:1.2.0' // skin-support-cardview CardView 控件支持[可选]

使用:

在 Application 的 onCreate 中初始化

@Override
public void onCreate() {
    super.onCreate();
    SkinCompatManager.init(this)                          // 基础控件换肤初始化
            .addInflater(new SkinMaterialViewInflater())  // material design 控件换肤初始化[可选]
            .addInflater(new SkinCardViewInflater())      // CardView 控件换肤初始化[可选]
            .loadSkin();                                  // 加载当前皮肤库(保存在 SharedPreferences 中)
}

或者

@Override
public void onCreate() {
    super.onCreate();
    SkinMaterialManager.init(this);          // material design 控件换肤初始化[可选]
    SkinCardViewManager.init(this);          // CardView 控件换肤初始化[可选]
    SkinCompatManager.init(this).loadSkin(); // 基础控件换肤初始化并加载当前皮肤库(保存在 SharedPreferences 中)
}

继承 SkinCompatActivity

让所有需要换肤的 Activity 继承自skin.support.app.SkinCompatActivity.

public class BaseActivity extends SkinCompatActivity {}

皮肤开关

如果项目中有特殊需求。例如, 股票控件: 控件颜色始终为红色或绿色, 不需要随着模式切换而换肤

那么可以使用类似的方法, 直接设置 color 值

setTextColor(0xce3d3a) // 不支持换肤
textColor="#ce3d3a"

而不是使用 R.color.red

setTextColor(R.color.red)
textColor="@color/red"

加载插件皮肤库

// 指定皮肤插件
SkinCompatManager.getInstance().loadSkin("new.skin"[, SkinLoaderListener]);

// 恢复应用默认皮肤
SkinCompatManager.getInstance().restoreDefaultTheme();

自定义 View 换肤

要点:

  1. 实现 SkinCompatSupportable 接口

    1. applySkin 方法中实现换肤操作
  2. 在构造方法中解析出需要换肤的 resId

  3. 自定义 View 可以直接继承自 SkinCompatView, SkinCompatLinearLayout 等已有控件

    eg: CustomTextView

  4. 不想继承自已有控件

    eg: CustomTextView2

  5. 需要换肤自定义属性

    // 需要换肤 AutoCompleteTextView 的 R.attr.popupBackground 属性

    eg: SkinCompatAutoCompleteTextView

  6. 需要使用第三方库控件怎么办

    // 需要使用https://github.com/hdodenhof/CircleImageView 控件, 并且要支持换肤

    eg: SkinCompatCircleImageView

制作皮肤插件:

新建 Android application 工程

皮肤工程包名不能和宿主应用包名相同.

例如:

宿主包名: com.ximsfei.skindemo
夜间模式: com.ximsfei.skindemo.night

将需要换肤的资源放到 res 目录下(同名资源)

例如 APK 中窗口背景颜色为

colors.xml

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

那么夜间模式你可以在 skin-night 工程中设置

colors.xml

<color name="background">#000000</color>

打包生成 apk, 即为皮肤包

将打包生成的 apk 文件, 重命名为'xxx.skin', 防止 apk 结尾的文件造成混淆.

License MIT

Android 开发经验分享
Android 开发经验分享