ChangeSkin
基于插件式的 Android 换肤框架,支持 app 内和或者外部插件式提供资源的换肤方案,无需重启 Activity。
致谢
- Android 换肤技术总结
- github.com/fengjundev/Android-Skin-Loader
- App Development: How to Get the Right LayoutInflater
- LayoutInflater Factories
- Optimizing CustomViews
- https://github.com/bboyfeiyu/Colorful
支持
- 插件的方式提供资源
- 应用内直接提供资源
- 一个插件包提供一套或者多套皮肤
- 应用内直接提供一套或者多套皮肤
Demo 运行
目前的 demo,已经包含上述功能的测试。
下载night_plugin.apk里面包含资源文件,放到手机或者模拟器 SdCard 的根目录。
然后 import project,运行 app。
运行效果图:
无需重启 Activity,无缝换肤,资源均来自插件 apk 中。
使用
下载changeskin,作为 module 依赖至主项目,例如:
dependencies {
compile project(':changeskin')
}
或者直接添加依赖:
dependencies {
compile 'com.zhy:changeskin:3.0.0'
}
(1)初始化
1、Application 中初始化
在你的 Application 中,去初始化 SkinManager,例如:
public class MyApplication extends Application
{
@Override
public void onCreate()
{
super.onCreate();
SkinManager.getInstance().init(this);
}
}
别忘了注册。
2、继承 BaseSkinActivity
让所有的需要换肤的界面的 Activity,继承自com.zhy.changeskin.base.BaseSkinActivity
。
3、对于需要换肤的资源命名使用 skin 开头
比如你的某个控件的背景需要换肤:
<android.support.v4.widget.DrawerLayout
android:background="@drawable/skin_main_bg"
...
/>
字体颜色:
<TextView android:id="@+id/id_tv_title"
android:textColor="@color/skin_item_text_color"
/>
其他的类似。
接下来,针对插件式或者应用内准备皮肤资源即可。
(2)插件式换肤
1、准备资源 apk
只需要按规则定义下资源名称,然后几行代码就完成了换肤。
然后,单独准备一份插件 apk,其实就是普通的项目,仅仅准备需要包含用到的资源即可。
例如:
搞成 apk 就不用说了吧。
2、调用 API
准备完成资源后,调用:
SkinManager.getInstance().changeSkin(
mSkinPkgPath,
"com.zhy.plugin",
new ISkinChangingCallback()
{
@Override
public void onStart()
{
}
@Override
public void onError(Exception e)
{
Toast.makeText(MainActivity.this, "换肤失败", Toast.LENGTH_SHORT).show();
}
@Override
public void onComplete()
{
Toast.makeText(MainActivity.this, "换肤成功", Toast.LENGTH_SHORT).show();
}
});
即可完成换肤。第一个参数为插件 apk 的路径,第二个参数为插件 apk 的 packageName.
记得设置读取存储卡权限。
当然你也可以调用
SkinManager.getInstance().removeAnySkin();
重置为初始状态。
(3)应用内换肤
1、准备资源 apk
这个就简单了,因为应用内换肤那么你肯定有多套资源,比如有一个背景图叫做:
skin_main_bg
那么你可以准备一套皮肤资源,命名为:
skin_main_bg_ 后缀
这二个后缀你自己决定,例如:
上图,我准备了两套应用内的皮肤。
2、调用换肤 API
SkinManager.getInstance().changeSkin("red");
参数传入你的后缀名即可。
详情参考 demo.
声明
感谢:drakeet的提醒.
恩,看来得说明下,首先对于换肤,从 Simple 发布的 Colorful 项目开始关注,搜索了大量的资料,因为希望是可以支持插件式,一直寻找合适的资源替换方案,后来搜索到这篇博文Android 换肤技术总结,里面提到了一些方案。很开心的是,发现了这个库:https://github.com/fengjundev/Android-Skin-Loader有极大的参考价值。该库通过为 LayoutInfalter 去设置自定义 Factory,对加载的 View 进行分析和提取,方案还是不错的。
该库也就成为本库的一个资源替换原理的一个核心的突破点。
当然,后来对于 LayoutInflater.Factory 又做了一些的分析,感觉侵入性有点大,主要担心对于 AppCompat 一些 support 的影响。
于是选择,直接重写 Activity 的 onCreateView 等方法。(由于 v7 23.0.1 的变动,onCreateView 只能作为 private factory 参与创建 View 了,时机太晚,该库方案也改为 setFactory)
因为本库的预期准备支持 app 内和或者外部插件式提供资源的换肤方案,为了方便变采用了资源名称的约束,所以修改幅度较大,也就没准备针对 Android-Skin-Loader 库提交 PR。
后面会编写博客叙述该库的原理等。