Android Vector适配

官网文档

简述

矢量图的主要优点是可以无损的拉伸和缩放,而且本身的是一个xml文件,这样可以避免开发时再使用多套图片,减少APK大小,尤其在一些动画效果上节省体积更明显。另外可以通过fillColor或者android:tint动态改变图片颜色,方便开发。

Android Studio里面内置了一些矢量图,可以通过new->vector assets选择一些图标。
vector assetes.png

默认适配

但是Android5.0(API21)以上才正式支持矢量图,5.0以下的手机需要通过AnimatedVectorDrawableVectorDrawable适配,不然系统默认会为矢量图生成每一套分辨率下的图片(/build/generated/res/pngs),原来的矢量图放到了drawable-anyapi-v21目录下。可以看到自动生成的图片质量很差,这样就失去了使用矢量图的意义。

兼容方式

想要使用兼容模式,需要在gradle中添加如下配置

//For Gradle Plugin 2.0+
 android {
   defaultConfig {
     vectorDrawables.useSupportLibrary = true
    }
 }
//For Gradle Plugin 1.5 or below
android {
  defaultConfig {
    // Stops the Gradle plugin’s automatic rasterization of vectors
    generatedDensities = []
  }
  // Flag notifies aapt to keep the attribute IDs around
  aaptOptions {
    additionalParameters "--no-version-vectors"
  }
}

加上上述配置后重新clean编译,generated就不再自动生成相应的png文件了,引用vector的地方使用

//使用android:src="@drawable/ic_add",低版本手机会crash。
app:srcCompat="@drawable/ic_add"

这时候如果手机API小于24,而Vector中使用<gradient>标签APP会crash,只能避免在低版本中使用该标签,只将其添加在drawable-v24包下.

特殊标签

这里有几个xml中的标签和属性与Android版本有关。

首先介绍一下"vectorDrawables.useSupportLibrary = true",这个 是矢量图的兼容库,使用该库项目编译时不会自动生成任何png,如果加了该库并且xml中有低版本不支持的属性或者标签,实际测试下来在低版本手机上有的xml会有以下两种问题:(1)使用app:srcCompat引用图片可能显示不正常。(2)使用drawableTop等属性引用该xml应用直接crash。

以下介绍的需要兼容的标签或者属性都要分使用"vectorDrawables.useSupportLibrary = true"和不使用两种情况去分析。

  • <android:fillColor="@color/xxx"> 这里引用资源需要API 21支持,直接使用#123456这种则可以。(1)引用兼容库可以解决该属性的兼容问题 (2)不引用兼容库,如果minAPI小于21并且引用资源就不能生成png图片,编译会失败。
  • <gradient>标签只能用于API 24及以上。 (1)引用兼容库,编译时不会有问题,但是在低版本上运行时如果没用兼容方法引用会直接crash,比如drawableTop引用。(2)不引用兼容库,该标签可以正常生成png图片,xml只用在drawable-anydpi-v24中。
     Caused by: org.xmlpull.v1.XmlPullParserException: Binary XML file line #12: invalid drawable tag gradient
  • <android:fillType="">只支持API 24以上。这个属性在绝大部分情况下都可以安全删除,不会影响图片显示,但个别图片也会被改变显示。(1) 引用兼容库时编译运行正常,但实测在低版本上该属性会被忽略。(2)不引用兼容库编译生成png时会失败,需要删除。

兼容原理

使用app:srcCompat或者动态使用setImageResource()可以让低版本使用矢量图,我们可以在v7包中的values.xml中找到srcCompat的定义

   <declare-styleable name="AppCompatImageView">
        ....
        <!-- Sets a drawable as the content of this ImageView. Allows the use of vector drawable
             when running on older versions of the platform. -->
        <attr format="reference" name="srcCompat"/>
        ....
    </declare-styleable>

之后我们在AppCompatImageView控件中可以看到使用app:srcCompat或者setImageResource()最终都会在AppCompatImageHelper中调到如下方法

Drawable d = AppCompatResources.getDrawable(mView.getContext(), resId);

最终完成低版本使用矢量图在VectorDrawableCompat完成,如果API < 24就使用XmlPullParser解析节点构建drawable,否则直接通过ResourcesCompat获取。

 synchronized Drawable getDrawable(@NonNull Context context, @DrawableRes int resId, boolean failIfNotKnown) {
        //会加载一个测试用的vector,如果加载失败则throw一个未初始化矢量图的exception
        checkVectorDrawableSetup(context);
        //通过委托模式加载图片
        Drawable drawable = this.loadDrawableFromDelegates(context, resId);
        .....
        return drawable;
    }
//loadDrawableFromDelegates方法中使用XmlPullParser获得AttributeSet
AppCompatDrawableManager.InflateDelegate delegate = (AppCompatDrawableManager.InflateDelegate)this.mDelegates.get(tagName);
if (delegate != null) {
    //在VectorDrawableCompat的inflate中中通过解析各个节点,绘制drawable
    dr = delegate.createFromXmlInner(context, parser, attrs, context.getTheme());
}
    private void inflateInternal(Resources res, XmlPullParser parser, AttributeSet attrs, Theme theme) throws XmlPullParserException, IOException {
        VectorDrawableCompat.VectorDrawableCompatState state = this.mVectorState;
        VectorDrawableCompat.VPathRenderer pathRenderer = state.mVPathRenderer;
        boolean noPathTag = true;
        ArrayDeque<VectorDrawableCompat.VGroup> groupStack = new ArrayDeque();
        groupStack.push(pathRenderer.mRootGroup);
        int eventType = parser.getEventType();

        for(int innerDepth = parser.getDepth() + 1; eventType != 1 && (parser.getDepth() >= innerDepth || eventType != 3); eventType = parser.next()) {
            String tagName;
            if (eventType == 2) {
                tagName = parser.getName();
                VectorDrawableCompat.VGroup currentGroup = (VectorDrawableCompat.VGroup)groupStack.peek();
                if ("path".equals(tagName)) {
                    VectorDrawableCompat.VFullPath path = new VectorDrawableCompat.VFullPath();
                    path.inflate(res, attrs, theme, parser);
                    currentGroup.mChildren.add(path);
                    if (path.getPathName() != null) {
                        pathRenderer.mVGTargetsMap.put(path.getPathName(), path);
                    }

                    noPathTag = false;
                    state.mChangingConfigurations |= path.mChangingConfigurations;
                } else if ("clip-path".equals(tagName)) {
                    VectorDrawableCompat.VClipPath path = new VectorDrawableCompat.VClipPath();
                    path.inflate(res, attrs, theme, parser);
                    currentGroup.mChildren.add(path);
                    if (path.getPathName() != null) {
                        pathRenderer.mVGTargetsMap.put(path.getPathName(), path);
                    }

                    state.mChangingConfigurations |= path.mChangingConfigurations;
                } else if ("group".equals(tagName)) {
                    VectorDrawableCompat.VGroup newChildGroup = new VectorDrawableCompat.VGroup();
                    newChildGroup.inflate(res, attrs, theme, parser);
                    currentGroup.mChildren.add(newChildGroup);
                    groupStack.push(newChildGroup);
                    if (newChildGroup.getGroupName() != null) {
                        pathRenderer.mVGTargetsMap.put(newChildGroup.getGroupName(), newChildGroup);
                    }

                    state.mChangingConfigurations |= newChildGroup.mChangingConfigurations;
                }
            } else if (eventType == 3) {
                tagName = parser.getName();
                if ("group".equals(tagName)) {
                    groupStack.pop();
                }
            }
        }

        if (noPathTag) {
            throw new XmlPullParserException("no path defined");
        }
    }

其它

从上面可以推测如果Activity使用的是AppCompatActivity, ImageView会被替换成AppCompatImageView。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,835评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,598评论 1 295
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,569评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,159评论 0 213
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,533评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,710评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,923评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,674评论 0 203
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,421评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,622评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,115评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,428评论 2 254
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,114评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,097评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,875评论 0 197
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,753评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,649评论 2 271

推荐阅读更多精彩内容