换肤,顾名思义,就是对应用中的视觉元素进行更新,呈现新的显示效果。一般来说,换肤的时候只是更新UI上使用的资源,如颜色,图片,字体等等。本文介绍一种笔者自己使用的基于布局的Android换肤方案,不仅可以更换所有的UI资源,而且可以更换主题样式(style)和布局样式。代码已托管到github:SkinFramework
换肤当然得有相应的皮肤包,不管是内置在应用内,还是做成可安装的皮肤应用包。但是这两种都有弊端:
1.内置在应用内会增加应用包的体积。
2.皮肤安装包需要安装过程,会占用更多的设备内置存储,用户会介意安装过多应用。而且为了是应用能够访问安装包内的资源,必须与应用使用相同的shareUserId。
鉴于此,本文推荐使用无需安装的外置皮肤包,优点在于:
1.无需安装,也无关乎shareUserId,不会引起用户反感。
2.按需下载使用,用户需要使用时自行下载,下载即可使用。
3.可放置于任何可访问的位置,SD卡或内置存储,可随时删除和添加,不会增加应用体积。
先来看一下效果图:
可以看到,图中有三种皮肤,默认皮肤,plain皮肤和vivid皮肤,都是更换了布局和资源的,其中还使用了AdapterView和Fragment作测试。可以看到,不同的皮肤有不同的布局样式,布局样式的不同也带来了很多可能,如隐藏或移动了功能入口。
所以说这是一个有很多可能的换肤框架,下面介绍一下核心 实现。
一、皮肤包
皮肤包就是一个不包含代码文件的Apk包,无需安装,可以新建工程,删除掉代码文件,复制应用里面需要修改的资源到新工程中修改,打成新包即可作为皮肤包使用,皮肤包后缀名可以改为任意。示例中使用了.skin作为后缀名。
二、皮肤包加载
皮肤包中包含的资源文件,需要加载到AssetManager中并创建Resources才能提供使用,关于Android的资源管理机制书上或网上已经有很多介绍,可以参考:Android中资源管理机制详细分析。所以我们的第一件事也是来加载皮肤包:
AssetManager assetManager = AssetManager.class.newInstance();
Method addAssetPath = assetManager.getClass().getMethod("addAssetPath", String.class);
//Return 0 on failure.
Object ret = addAssetPath.invoke(assetManager, skinPath);
if (Integer.parseInt(ret.toString()) == 0) {
throw new IllegalStateException("Add asset fail");
}
Resources localRes = context.getResources();
return new SkinResource(context, assetManager, localRes.getDisplayMetrics(), localRes.getConfiguration(), packageName);
三、资源管理器
加载了皮肤包,我们就有了两套可共使用的皮肤资源,应用默认资源和皮肤包资源,何时使用默认,何时使用皮肤,需要有一个管理器来决定,所以我们实现一个名为ComposedResources的类来扮演ResourcesManager:
/**
* Created by ARES on 2016/5/20
* This is a resources class consists of App default skin and external skin resources if exists. We will find resource in external skin resources first,then the default.
* Assume all resources ids are original so that we should find corresponding resources ids in skin .
*/ public class ComposedResources extends BaseResources {
static int LAYOUT_TAG_ID = -1;
private Context mContext;
private BaseSkinResources mSkinResources; public ComposedResources(Context context) {
this(context, null);
} public ComposedResources(Context context, BaseSkinResources skinResources) {
super(context.getResources());
mContext = context;
mSkinResources = skinResources;
} public ComposedResources setSkinResources(BaseSkinResources resources) {
mSkinResources = resources;
return this;
} public BaseSkinResources getSkinResources() {
return mSkinResources;
} @NonNull
@Override
public CharSequence getText(@StringRes int id) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
try {
return mSkinResources.getText(realId);
} catch (Exception e) {
}
}
return super.getText(id);
} @NonNull
@Override
public CharSequence getQuantityText(@PluralsRes int id, int quantity) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getQuantityText(realId, quantity);
}
return super.getQuantityText(id, quantity);
} @NonNull
@Override
public String getQuantityString(@PluralsRes int id, int quantity, Object... formatArgs) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getQuantityString(realId, quantity, formatArgs);
}
return super.getQuantityString(id, quantity, formatArgs);
} @NonNull
@Override
public String getQuantityString(@PluralsRes int id, int quantity) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getQuantityString(realId, quantity);
}
return super.getQuantityString(id, quantity);
} @Override
public CharSequence getText(@StringRes int id, CharSequence def) {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getText(realId, def);
}
return super.getText(id, def);
} @NonNull
@Override
public CharSequence[] getTextArray(@ArrayRes int id) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getTextArray(id);
}
return super.getTextArray(id);
} @NonNull
@Override
public String[] getStringArray(@ArrayRes int id) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getStringArray(realId);
}
return super.getStringArray(id);
} @NonNull
@Override
public int[] getIntArray(@ArrayRes int id) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getIntArray(realId);
}
return super.getIntArray(id);
} @NonNull
@Override
public TypedArray obtainTypedArray(@ArrayRes int id) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.obtainTypedArray(realId);
}
return super.obtainTypedArray(id);
} @Override
public float getDimension(@DimenRes int id) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getDimension(realId);
}
return super.getDimension(id);
} @Override
public int getDimensionPixelOffset(@DimenRes int id) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getDimensionPixelOffset(realId);
}
return super.getDimensionPixelOffset(id);
} @Override
public int getDimensionPixelSize(@DimenRes int id) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getDimensionPixelSize(realId);
}
return super.getDimensionPixelSize(id);
} @Override
public float getFraction(@FractionRes int id, int base, int pbase) {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getFraction(id, base, pbase);
}
return super.getFraction(id, base, pbase);
} @Override
public Drawable getDrawable(@DrawableRes int id) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getDrawable(realId);
}
return super.getDrawable(id);
} @RequiresApi(api = Build.VERSION_CODES.LOLLIPOP)
@Override
public Drawable getDrawable(@DrawableRes int id, @Nullable Theme theme) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getDrawable(realId, theme);
}
return super.getDrawable(id, theme);
} @Override
public Drawable getDrawableForDensity(@DrawableRes int id, int density) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getDrawableForDensity(realId, density);
}
return super.getDrawableForDensity(id, density);
} @RequiresApi(api = Build.VERSION_CODES.LOLLIPOP)
@Override
public Drawable getDrawableForDensity(@DrawableRes int id, int density, @Nullable Theme theme) {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getDrawableForDensity(realId, density, theme);
}
return super.getDrawableForDensity(id, density, theme);
} @Override
public Movie getMovie(@RawRes int id) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getMovie(realId);
}
return super.getMovie(id);
} @Override
public int getColor(@ColorRes int id) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getColor(realId);
}
return super.getColor(id);
} @RequiresApi(api = Build.VERSION_CODES.M)
@Override
public int getColor(@ColorRes int id, @Nullable Theme theme) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getColor(realId, theme);
}
return super.getColor(id, theme);
} @Nullable
@Override
public ColorStateList getColorStateList(@ColorRes int id) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getColorStateList(realId);
}
return super.getColorStateList(id);
} @RequiresApi(api = Build.VERSION_CODES.M)
@Nullable
@Override
public ColorStateList getColorStateList(@ColorRes int id, @Nullable Theme theme) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getColorStateList(realId, theme);
}
return super.getColorStateList(id, theme);
} @Override
public boolean getBoolean(@BoolRes int id) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getBoolean(realId);
}
return super.getBoolean(id);
} @Override
public int getInteger(@IntegerRes int id) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.getInteger(realId);
}
return super.getInteger(id);
} @Override
public XmlResourceParser getLayout(@LayoutRes int id) throws NotFoundException {
int realId = getCorrespondResIdStrictly(id);
if (realId > 0) {
return mSkinResources.getLayout(realId);
}
return super.getLayout(id);
} @Override
public XmlResourceParser getAnimation(@AnimRes int id) throws NotFoundException {
int realId = getCorrespondResIdStrictly(id);
if (realId > 0) {
return mSkinResources.getAnimation(realId);
}
return super.getAnimation(id);
} @Override
public XmlResourceParser getXml(@XmlRes int id) throws NotFoundException {
int realId = getCorrespondResIdStrictly(id);
if (realId > 0) {
return mSkinResources.getXml(realId);
}
return super.getXml(id);
} @Override
public InputStream openRawResource(@RawRes int id) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.openRawResource(realId);
}
return super.openRawResource(id);
} @Override
public InputStream openRawResource(@RawRes int id, TypedValue value) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.openRawResource(realId, value);
}
return super.openRawResource(id, value);
} @Override
public AssetFileDescriptor openRawResourceFd(@RawRes int id) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
return mSkinResources.openRawResourceFd(realId);
}
return super.openRawResourceFd(id);
} @Override
public void getValue(@AnyRes int id, TypedValue outValue, boolean resolveRefs) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
mSkinResources.getValue(realId, outValue, resolveRefs);
return;
}
super.getValue(id, outValue, resolveRefs);
} @Override
public void getValueForDensity(@AnyRes int id, int density, TypedValue outValue, boolean resolveRefs) throws NotFoundException {
int realId = getCorrespondResId(id);
if (realId > 0) {
mSkinResources.getValueForDensity(realId, density, outValue, resolveRefs);
return;
}
super.getValueForDensity(id, density, outValue, resolveRefs);
} @Override
public void getValue(String name, TypedValue outValue, boolean resolveRefs) throws NotFoundException {
if (mSkinResources != null) {
try {
mSkinResources.getValue(name, outValue, resolveRefs);
return;
} catch (Exception e) {
}
}
super.getValue(name, outValue, resolveRefs);
} @Override
public void updateConfiguration(Configuration config, DisplayMetrics metrics) {
if (mSkinResources != null) {
mSkinResources.updateConfiguration(config, metrics);
}
super.updateConfiguration(config, metrics);
} /**
* Get correspond resources id with app package. See also {@link #getCorrespondResId(int)}
*
* @param resId
* @return 0 if not exist
*/
public int getCorrespondResIdStrictly(int resId) {
if (mSkinResources == null) {
return 0;
}
String resName = getResourceName(resId);
return mSkinResources.getIdentifier(resName, null, null);
} /**
* Get correspond resources id with skin package. See also {@link #getCorrespondResId(int)}
*
* @param resId
* @return
*/
public int getCorrespondResId(int resId) {
if (mSkinResources == null) {
return 0;
}
return mSkinResources.getCorrespondResId(resId);
} @Override
public View getView(Context context, @LayoutRes int resId) {
//Take a resource id as the tag key.
if (LAYOUT_TAG_ID < 1) {
LAYOUT_TAG_ID = resId;
}
View view;
if (mSkinResources != null) {
int realId = getCorrespondResId(resId);
if (realId > 0) {
view = mSkinResources.getView(context, realId);
if (view != null) {
view.setTag(LAYOUT_TAG_ID, mSkinResources.getPackageName());
SkinUtils.showIds(view);
return view;
}
}
}
view = LayoutInflater.from(context).inflate(resId, null);
view.setTag(LAYOUT_TAG_ID, getPackageName());
SkinUtils.showIds(view);
return view;
} @Override
public String getPackageName() {
return mContext.getPackageName();
}
}
可以看到这个ResourceManager本身也是一个Resources,它继承自BaseResources,BaseResources继承自android.content.res.Resources。所以它可以直接作为应用的Resources来使用。其中有几点需要注意:
1.查找资源时,资源管理器应优先查找皮肤包中的资源,若皮肤包中没有相应资源,才使用应用默认资源。
2.每个应用包中的资源id是不同的,查找资源时,我们传入Resources的id都是应用中的id,而非皮肤包中的id,所以我们需要转换为皮肤包中相应的资源id,再获取具体的资源(此代码实现在SkinResources中,ComposedResources调用了此方法):
/**
* Get correspond resource id in skin archive.
* @param resId Resource id in app.
* @return 0 if not exist
*/
public int getCorrespondResId(int resId) {
Resources appResources = getAppResources();
String resName = appResources.getResourceName(resId);
if (!TextUtils.isEmpty(resName)) {
String skinName = resName.replace(mAppPackageName, getPackageName());
int id = getIdentifier(skinName, null, null);
return id;
}
return 0;
}
3.在获取XmlResourceParser时,需要使用应用对于资源的描述,而非皮肤包中的资源描述,所以有了getCorrespondResIdStrictly:
/**
* Get correspond resources id with app package. See also {@link #getCorrespondResId(int)}
*
* @param resId
* @return 0 if not exist
*/
public int getCorrespondResIdStrictly(int resId) {
if (mSkinResources == null) {
return 0;
}
String resName = getResourceName(resId);
return mSkinResources.getIdentifier(resName, null, null);
}
4.我们使用了LAYOUT_TAG_ID来记录了Layout所属的皮肤包,以便可以动态的判断是否需要更换布局(此方法可以用在动态换肤的时候,详情参考Demo):
@Override
public View getView(Context context, @LayoutRes int resId) {
//Take a resource id as the tag key.
if (LAYOUT_TAG_ID < 1) {
LAYOUT_TAG_ID = resId;
}
View view;
if (mSkinResources != null) {
int realId = getCorrespondResId(resId);
if (realId > 0) {
view = mSkinResources.getView(context, realId);
if (view != null) {
view.setTag(LAYOUT_TAG_ID, mSkinResources.getPackageName());
return view;
}
}
}
view = LayoutInflater.from(context).inflate(resId, null);
view.setTag(LAYOUT_TAG_ID, getPackageName());
return view;
}
四、布局更换处理
通过上述的代码,我们就已经能够完成常见资源的换肤了。但是对于布局资源,我们还需要做额外的处理。
1.Context与LayoutInflater
渲染View时,我们需要使用皮肤对应的Context和LayoutInflater,这样才能在View中使用正确的资源,所以我们为外置皮肤包创建相应的Context:
/**
* Context implementation for skin package.
*/
private class SkinThemeContext extends ContextThemeWrapper {
private WeakReference<Context> mContextRef; public SkinThemeContext(Context base) {
super();
if (base instanceof ContextThemeWrapper) {
attachBaseContext(((ContextThemeWrapper) base).getBaseContext());
mContextRef = new WeakReference<Context>(base);
} else {
attachBaseContext(base);
}
int themeRes = getThemeRes();
if (themeRes <= 0) {
themeRes = android.R.style.Theme_Light;
}
setTheme(themeRes);
} /**
* This implementation will support <code>onClick</code> attribute of view in xml.
* @param v
*/
public void onClick(View v) {
Context context = mContextRef == null ? null : mContextRef.get();
if (context == null) {
return;
}
if (context instanceof View.OnClickListener) {
((View.OnClickListener) context).onClick(v);
} else {
Class cls = context.getClass();
try {
Method m = cls.getDeclaredMethod("onClick", View.class);
if (m != null) {
m.invoke(context, v);
}
} catch (NoSuchMethodException e) {
e.printStackTrace();
} catch (InvocationTargetException e) {
e.printStackTrace();
} catch (IllegalAccessException e) {
e.printStackTrace();
}
}
} @Override
public AssetManager getAssets() {
return getAssets();
} @Override
public Resources getResources() {
return SkinResource.this;
} private int getThemeRes() {
try {
Method m = Context.class.getMethod("getThemeResId");
return (int) m.invoke(getBaseContext());
} catch (Exception e) {
e.printStackTrace();
}
return -1;
} }
其中我们对xml布局文件中的onClick属性作了支持,同时通过提供了皮肤包对应的资源,然后我们使用这个Context的实例创建LayoutInflater并渲染View:
@Override
public View getView(Context context, @LayoutRes int resId) {
try {
Context skinContext = new SkinThemeContext(context);
View v = LayoutInflater.from(skinContext).inflate(resId, null);
handleView(skinContext, v);
return v;
} catch (Exception e) { }
return null;
}
其中注意到handleView方法,正如前文所说,每个应用包生成的资源id是不一样的,这里View中生成的id是皮肤包中的id,需要转换为应用中的id方可使用:
/**
* Handle view to support used by app.
*
* @param v View resource from skin package.
*/
public void handleView(Context context, View v) {
resetID();
//Id map: Key as skin id and Value as local id.
SparseIntArray array = new SparseIntArray();
buildIdRules(context, v, array);
int size = array.size();
// Map ids to which app can recognize locally.
for (int i = 0; i < size; i++) {
//Map id defined in skin package into real id in app.
v.findViewById(array.keyAt(i)).setId(array.valueAt(i));
}
} /**
* Extract id from view , build id rules and inflate rules if needed.
*
* @param v
* @param array
*/
protected void buildIdRules(Context context, View v, SparseIntArray array) {
if (v.getId() != View.NO_ID) {
//Get mapped id by id name.
String idName = getResourceEntryName(v.getId());
int mappedId = getAppResources().getIdentifier(idName, "id", context.getPackageName());
//Add custom id to avoid id conflict when mapped id not exist.
//Key as skin id and value as mapped id.
array.put(v.getId(), mappedId > 0 ? mappedId : generateId());
}
if (v instanceof ViewGroup) {
ViewGroup vp = (ViewGroup) v;
int childCount = vp.getChildCount();
for (int i = 0; i < childCount; i++) {
buildIdRules(context, vp.getChildAt(i), array);
}
}
buildInflateRules(v, array);
} /**
* Build inflate rules.
*
* @param v
* @param array ID map of which Key as skin id and value as mapped id.
*/
protected void buildInflateRules(View v, SparseIntArray array) {
ViewGroup.LayoutParams lp = v.getLayoutParams();
if (lp == null) {
return;
}
if (lp instanceof RelativeLayout.LayoutParams) {
int[] rules = ((RelativeLayout.LayoutParams) lp).getRules();
if (rules == null) {
return;
}
int size = rules.length;
int mapRule = -1;
for (int i = 0; i < size; i++) {
//Key as skin id and value as mapped id.
if (rules[i] > 0 && (mapRule = array.get(rules[i])) > 0) {
// Log.i(TAG, "Rules[" + i + "]: Mapped from: " + rules[i] + " to " +mapRule);
rules[i] = mapRule;
}
}
}
}
五、使用
下载源码,集成skin module到工程中,然后使用SkinManager提供的接口:
public SkinManager initialize(Context context);//初始化皮肤管理器 /**
* Register an observer to be informed of skin changed for ui interface such as activity,fragment, dialog etc.
* @param observer
*/
public void register(ISkinObserver observer);//注册换肤监听器,用于需要动态换肤的场景。 /**
* Get resources.
* @return
*/
public BaseResources getResources();//获取资源 /**
* Change skin.
* @param skinPath Path of skin archive.
* @param pkgName Package name of skin archive.
* @param cb Callback to be informed of skin-changing event.
*/
public void changeSkin(String skinPath, String pkgName, ISkinCallback cb);//更换皮肤 /**
* Restore skin to app default skin.
*
* @param cb
*/
public void restoreSkin(ISkinCallback cb) ;//恢复应用默认皮肤 /**
* Resume skin.Call it on application started.
*
* @param cb
*/
public void resumeSkin(ISkinCallback cb) ;//恢复当前使用的皮肤,应在应用启动界面调用。
框架支持两种换肤方式:
1.静态换肤(推荐)
换肤完成后,关闭掉所有的Activity,然后重新启动主界面。简单方便。
2.动态换肤
需要换肤的Activity、Fragment、Dialog实现ISkinObserver, 并通过register(ISkinObserver observer)注册到SkinManager,动态更换布局,详情见Sample代码。
这种方式需要重新渲染View,绑定数据,在使用Fragment时,还需要在换肤期间detach/attach fragment,使用起来比较麻烦。优点是换肤后可以停留在原来界面。
两种方式都需要使用SkinManager提供的Resource来获取布局或其他资源。推荐写自己的BaseActivity,重写getResources()返回SkinManager提供的Resources方便使用。小伙伴们根据自己的实际情况来选择具体使用何种方式。
好了,到这里换肤框架就介绍完了,欢迎关注SkinFramework的最新动态,若有任何建议和意见,欢迎指出!