该文章是基于apkplug V1.6.8 进行说明的
我们提供了一个demo做为参考,项目下载地址为:http://git.oschina.net/plug/IMThemeDemo
该 IMThemeDemo 实现了简单的聊天泡泡切换功能,同时主题包(插件)是托管在apkplug的云服务器上的。所以要阅读项目的完整代码可以先看插件托管服务开发系列文章 <插件托管服务开发指南>
demo运行效果图:
一,apkplug的主题说明
apkplug主题解决方案摒弃了以往以图片替换的形式切换效果的方式,转而使用android原生资源和素材来切换UI样式和效果。所以从体验效果上是一次极大的提升。
二,apkplug主题(皮肤)切换适用范围
apkplug主题解决方案适用安卓界面的整个层次。其包括通用主题样式,和自定义控件样式切换两个层面
1.通用主题样式
与系统主题相似(Activity.setTheme()) 我们在系统与app(插件)之间可新增一层主题,三层主题已叠加的形式形成最终结果
2.自定义控件样式
大部分情况下我们的app都会自己设计主题,或者针对某写控件设计自己的样式,在这种模式下以上的通用主题便缺少
其存在的意义了。因此apkplug也提供一种简单有效的方案,允许开发者根据自己的需求定义自定义UI控件样式的替换规则
在不失通用性兼容性简洁性的情况下达到最好的体验。
三,主题(皮肤)切换流程
1.通用主题样式
通用主题样式有apkplug框架在底层适配,app开发过程中无需过多考虑,只要主题包设置了通用主题样式,app中的Activity 主题将自定替换(最前面的Activity需刷新后才能体现)
2.自定义控件样式
自定义控件样式的替换由于每个app的特殊性的原因,没法做统一的规范。但apkplug经过几个月的努力研发出一套简单有效的实施方案,允许开发者自由定制适合自己app的替换接口。而主题包设计者根据该接口简单配置即可。
四,自定义控件样式替换接口举例
1.定义替换接口
以 IMThemeDemo项目为例,我们需要替换聊天界面的聊天泡泡,所以自定义了以下的这样一个接口
com.apkplug.imthemedemo.themeinterface.chatstyles
01 |
public interface chatstyles
{ |
03 |
//主题样式版本,如果主题样式接口有所改变就利用这来判断 |
06 |
public int chat_right_msg_background(); |
08 |
public int chat_left_msg_background(); |
10 |
public int chatbackground(); |
以上接口返回值是一个资源ID,它可能是一张图片或者一个xml布局样式。但它将由主题包(插件)提供。
2.主程序监听主题切换事件
以上我们定义了一套UI样式的切换接口,但我们主应用并不知道合适会有主题包来替换我们现有的样式。所以我们需要一个监听器来监听这个接口事件,一下是模板代码 (此处设计一些OSGI服务方面的知识,不明白的同学可看 OSGI服务基本原理),但我们提供模板代码,开发者可以先实现在研究其原理。
定义一个专门监听接口事件变化的单例类
com.apkplug.imthemedemo.ThemeChengFactory
01 |
mcontext.addServiceListener( |
02 |
new ServiceListener(){ |
04 |
public void serviceChanged(ServiceEvent
event) { |
05 |
switch (event.getType())
{ |
06 |
case ServiceEvent.REGISTERED: |
08 |
//当有主题包注册了该接口,意味着它为我们提供样式切换的具体资源了 |
09 |
ref
= event.getServiceReference(); |
10 |
service
= (chatstyles) mcontext.getService(ref); |
13 |
case ServiceEvent.UNREGISTERING: |
14 |
if (ref
== event.getServiceReference()) { |
15 |
//主题包注销了该接口,意味着它不再提供切换的具体资源了 |
16 |
mcontext.ungetService(ref); |
24 |
},String.format( "(objectclass=%s)" ,chatstyles. class .getCanonicalName())
); |
3.界面创建时判断是否切换样式
上一步我们已经实现了监听接口注册与注销事件,但我们还没有将切换的样式绑定到具体的控件上来。这一步我们将完成这一块工作
根据上一段代码我们得知 ThemeChengFactory类中的chatstyles service 成员变量在主题包注册以后不为空,没有注册时为空。这样我们便通过判断 serice是否为空来判断是否有主题样式可切换。同时我们判断返回值是否为-1来判断主题包提供的样式是否完整
注:我们约定主题包可能只提供了接口的部分控件样式,其他样式返回-1 表示没有提供相应资源
4.在创建控件时设置样式
1)聊天泡泡样式
com.apkplug.imthemedemo.adapter.ChatMsgViewAdapter
01 |
chatstyles
cs=ThemeChengFactory.getInstance( null ).getService(); |
03 |
//chatstyles
不为空表示有主题包提供替换的资源 |
04 |
ViewHolder
v= (ViewHolder)convertView.getTag(); |
06 |
if (cs.chat_left_msg_background()!=- 1 ){ |
08 |
v.tvContent.setBackgroundResource(cs.chat_left_msg_background()); |
11 |
if (cs.chat_right_msg_background()!=- 1 ){ |
13 |
v.tvContent.setBackgroundResource(cs.chat_right_msg_background()); |
2)聊天界面背景图片样式
com.apkplug.imthemedemo.activity.ChatActivity
1 |
chatstyles
cs=ThemeChengFactory.getInstance( null ).getService(); |
4 |
if (cs.chatbackground()!=- 1 ){ |
6 |
mListView.setBackgroundResource(cs.chatbackground()); |
5.监听主题切换事件,重刷UI
第四步我们完成了在UI创建刷新时判断并替换新的样式,但目前为止我们还不只到什么时候应该刷新UI。以下将解决这个问题
当主题包设置了可替换主题以后,apkplug会给监听器发送主题切换事件,我们可注册这样一个监听器实时监听主题切换事件刷新activity从而实现实时换肤的功能。
com.apkplug.imthemedemo.activity.MainActivity
01 |
public void ListenerTheme(){ |
02 |
BundleContext
context=frame.getSystemBundleContext(); |
03 |
ServiceReference
reference=context.getServiceReference(RegThemeChengeListener. class .getName()); |
06 |
final RegThemeChengeListener
service=(RegThemeChengeListener) context.getService(reference); |
08 |
//找到服务注册一个监听器,实时监听主题切换动态 |
09 |
service.registerOnThemeListener( |
10 |
new OnThemeChengeListener(){ |
11 |
@SuppressLint ( "NewApi" ) |
13 |
public void afterChenged(org.osgi.framework.Bundle
arg0, int arg1)
{ |
15 |
MainActivity. this .recreate(); |
16 |
System.out.println( "afterChenged" ); |
17 |
//把上一个监听器注销,因为界面被重刷以后我们又注册了一个新的监听器 |
18 |
service.unregisterOnThemeListener( this ); |
21 |
public void beforeChenge( |
22 |
org.osgi.framework.Bundle
bb, int arg1,org.osgi.framework.Bundle
tob, int arg2)
{ |
27 |
context.ungetService(reference); |
我们没有在ChatActivity界面设置监听器重刷的原因是,每次设置主题我们都会到主题包的Activity中,并且返回以后每次都重新进入ChatActivity界面,所以ChatActivity不需要重刷(因为它每次都是新的)
完成以上步骤以后主应用完成了,但这还不够因为我们还没有开发主题包(插件)呢。下一节将讲解怎么开发主题包,它同样简单快捷
android下apkplug通用主题(皮肤)切换解决方案之主应用-01
时间: 2024-10-07 04:02:27