模仿安卓源码,手写过时的方法兼容低版本

经常写代码时候,会看到某个方法上面画一条横线,注释写的是此方法已过时,推荐使用XXX某某方法替代。我觉得这个提示很有用。在实际开发中,有时候老项目版本迭代之后,用了最新的API,为了兼容老版本,要把老方法保留,还要新增很多新方法,无疑增加了工作量。假如这时候引入安卓源码的这种设计思想,问题就会变得很简单了。下面简单的来讲一下:

我们经常会使用getColor(R.color.XXX)获取颜色的资源文件,但是在安卓6.0开始,这个方法被标注为过时,推荐使用两个参数的方法替代,如下图所示:

模仿安卓源码,手写过时的方法兼容低版本_第1张图片
过时的方法

那么我怎么才能象系统源码那样去做呢?别着急,干货来了。。

首先,写一个方法,加上 @Deprecated 注解,表示这个方法已过时,
然后在上面加上文档注释, @deprecated 请用 {@link 类名#方法名(参数...)} 替代

举例如下,下面是我写的一个工具类:

public class ResourceUtils {

    public static ResourceUtils resourceUtils;
    public Context mContext;

    public ResourceUtils(Context context) {
        this.mContext = context;
    }

    public static ResourceUtils getInstance(Context context) {
        if (resourceUtils == null) {
            synchronized (ResourceUtils.class) {
                if (resourceUtils == null) {
                    resourceUtils = new ResourceUtils(context);
                }
            }
        }
        return resourceUtils;
    }

    /**
     * @param colorResId
     * @removed
     * @deprecated 请用 {@link ResourceUtils#obtainColorResources(int)} 替代
     */
    @Deprecated
    public ResourceUtils getColorResources(int colorResId) {
        mContext.getResources().getColor(colorResId);
        return this;
    }

    /**
     * @param colorResId
     * @return
     */
    @TargetApi(23)
    public ResourceUtils obtainColorResources(int colorResId) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
            ContextCompat.getColor(mContext,colorResId);
        } else {
            mContext.getResources().getColor(colorResId);
        }
        return this;
    }
}

调用方法如下:

模仿安卓源码,手写过时的方法兼容低版本_第2张图片
调用方法

怎么样?是不是很装(6)逼?别人用这个方法的时候,一看过时了,说明这个方法兼容的版本比你编译的版本要低,那么切换到新的方法就没问题了。有着轻度强迫症我,是不会看到这种过时方法存在的。

小伙伴们,快来试试看吧。从此让你的代码逼格起来!

你可能感兴趣的:(模仿安卓源码,手写过时的方法兼容低版本)