**Skin集成文档**
此框架无需重新启动应用即可一键换肤(支持background,string ,color,dimen),使用简单只需4步搞定,暂时无其它副作用。
支持Android 原生view和自定义View,窗体(dialog , popouWindow,windowManager)等换肤。
第一步:
你需要打包一个APK的skin,把生成的XXX.Apk修改成XXX.skin
很简单就是需要新建一个Android工程,里面存放你需要换肤的资源(drawable ,color (attr),color文件)等。
注意:命名一定要与你的项目中的命名要一样,否则会找不到该资源。
再放到XXX.skin文件放到手机目录下就可以了(也可以支持在线换肤,从服务器下载xx.skin文件保存到本地)
第二步:
在application的onCreate()中去初始化框架:
SkinManager.getInstance().init(this).load();
或者 得到一个加载theme状态回调
SkinManager.getInstance().init(this).loadCallBack(callback)
也可以添加多个skin
当然如果你想打印skin log 可以 SkinManage.getInstance().isOpenLog(true);;
默认log是关闭的。
假如:你想你的应用换肤的时候发送广播或者共享换肤标识(一般用不到)
需要再application的onCreate中去初始化:
SkinManager.getInstance().initSDK(this);
则可以不用初始化:SkinManager.getInstance().init(this);
第三步:
有三个base继承,降低了继承的难度(当然只作为参考)
分别是:
BaseSkinActivity
BaseSkinFragmentActivity
BaseSkinFragment
如果你的base已经继承了第三方Base可以把框架的Base作为参考,复制到你的Base中即可.
第四步:
一键切换指定皮肤:(如果想更方便可以使用SkinSwitchManager,后面有介绍) File skin = new File(“skin文件路径”);
如果想恢复默认资源
调用SkinManager.getInstance().restoreDefaultTheme()
其中有三个load的方法区别:
第一次加载外部资源。得到一个skin后 (三个过程的回调都发生在主线程)
SkinManager.getInstance().load(skinPackagePath,callback):
如果你之前加载这个资源后,以后想再去加载直接调用这个即可
SkinManager.getInstance().loadCallBack(callback);
加载资源。不想得到一个应用的skin callback。传入skin路径即可
SkinManager.getInstance().loadPath(skinPath):
你也可以在代码中动态的添加SkinView(后面有说明)
如:
代码中常有给View动态的去设置BackgroundimageView.setBackground(R);
使用SkinManager.getInstance().getDrwable(R.drwable.XXX)获取Drawable
如:
imageView.setBackground(SkinManager.getInstance().getDrawable(R.drawable.XXX));
Color,dimen,string 同理
按照以上都是基本上可以完成大部分换肤需求
自定义View换肤
特别系列:
假如现在我们需要支持自定义View换肤该怎么办?
如:
<MyView
app:mytextColor = "@color/XXXX"
/>
在MyView类中需提供一个setAttr(…) 方法 供 SkinAttrHolder中去setskin
第一步:
写一个attrHolder 继承自 SkinAttrHolder
重写 apply() 方法:
如:
参照框架的SkinAttrHolder即可:
接下来就是把改属性注入到框架内(注意一定要在setContentView之前注册):
SkinManager.getInstance().registAttrHolder("mytextColor",newMyViewColorHolder());
attrName (mytextColor)建议不要重复命名,不要跟Android自带attribute一样
如果一样可以继承之前的attrHolder Override apply方法 super()不可注释掉
以上就是自定义View attr change skin 方式
假如你说怎么每次都需要得到一个skinManager的实例很麻烦?
没关系框架支持链试调用如
SkinManager.getInstance()
.registAttrHolder("mytextColor",new MyViewColorHolder()
.registAttrHolder("otherTextColor",new OtherViewColorHolder());
恩?还觉得不够优雅,也可以使用map的方式注入自定义属性
SkinManager.getInstance().registAttrHolderMap(attrMap)
突然需求更改了。某某个自定义属性不想支持attr了
没关系你可以选择任何时机去调用
SkinManager.getInstance().removeAttrHolder(attrName, skin)即可移除该属性。
特殊windowManager的支持
你现在又有新的疑惑那各种窗体如:(dialog , popouWindow,windowManager)
怎么办?
其实该框架直接是可以支持各种窗体的(activity中创建的window)
但是你又说,恩?在activity中创建Window是可以的,但是我现在需要在服务,广播中,甚至是另外一个应用以一个广播的形式启动服务(service)再创建 各种窗体呢?(简单的说Window不是在activity中创建的)
现在就需要用到另外一个类:
SkinSuffixWindowManager:
SkinSuffixWindowManager.getInstace().addWindowView(mView).applySkinForViews(true);
传入你的View,设置为true 就是ViewChild也支持换肤
或者你只想传入view resID
mView=SkinSuffixWindowManager.getInstace().addWindowViewRef(viewId, root).applySkinForViews(true);
Addviewm(View)
规范如:
tag = (view_color = 资源文件中的id,background = 设置background属性 ,color = color资源)
<RelativeLayout
android:id="@+id/popup_window"
android:layout_width="160dp"
android:layout_height="100dp"
android:orientation="vertical"
android:background="@color/view_color"
android:tag="skin:view_color:background:color">
</RelativeLayout>
如果你想支持更多属性:
配置规范 skin:xx|xx
<RelativeLayout
android:id="@+id/popup_window"
android:layout_width="160dp"
android:layout_height="100dp"
android:orientation="vertical"
android:background="@color/view_color"
<!--android:background="@color/other_view_color"-->
android:tag="skin:view_color:background:color|other_view_color:background:color">
</RelativeLayout>
如果想要更灵活的切换N种theme
只需要两步:
SkinSwitchManager
第一步:
SkinSwitchManager.getSkinSwitchManager().saveSkinTheme(1, "第一个skin路径")
.saveSkinTheme(2, "第二个skin路径");
第二步:
想要切换到第一个主题直接调用: SkinSwitchManager.getSkinSwitchManager().switchSkinTheme(1);
如果恢复到默认主题: SkinSwitchManager.getSkinSwitchManager().restoreDefaultTheme();