相关文章推荐

放荡不羁SVG讲解与实战——Android高级UI

目录
一、前言
二、SVG小课堂
三、简单使用
四、实战
五、写在最后

原文出处

一、前言

SVG 在安卓5.0被引入,因为其放大后不会模糊的优秀表现,被使用也是越来越多。今天小盆友也来谈谈这个 优秀的SVG ,同时分享一些个人比较喜欢的知识小点。老规矩,先上实战图。

"手写"掘金

地图查阅器


二、SVG小课堂

1、SVG是什么

SVG 全称 Scalable Vector Graphics ,翻译一下即为 可缩放的矢量图形

2、优点

SVG 的优点很多,而且在不同的场景优点也会有所不同,小盆友觉得 SVG 给我带来的优点如下几点

  • 缩放均不失真,这带来的好处是我们不需要多套分辨率的图标;
  • 文件相对较小,相较于 JPEG 和 GIF 格式的文件会小些;
  • 以 XML 为结构,可修改也可扩展,用最简单的记事本也能进行相应的修改;
  • 高交互性,这一点在实战时就能体现出来啦;

3、缺点

这个缺点,说的并不是SVG的缺点,而是 在 Android 中使用SVG的缺点或局限

(1) 动画兼容问题

前言中提到 SVG 是在5.0之后引入 ,虽然作为一个图标资源并不会有兼容问题。

但是如果 对 SVG 进行使用动画时,则需要进行兼容性处理 。否在 5.0 以下会闪退,毕竟 4.4 的占有率还 10.3%左右(如下图,图片来自 Android Studio 的统计)。

至于如何使用和兼容,我们在下一小节进行说明。


2、动画限制问题

动画限制这一点其实准确来说,不属于缺点,小盆友认为是不够灵活。

因为SVG的动画是通过 属性动画 进行执行的,我们知道 属性动画最终是反射调用到类的 setXxx(Xxx就是我们设置的属性名称),所以如果该类没有对应的方法则是没有作用的。

对 “属性动画” 源码兴趣的童鞋可以移步小盆友的另一篇博文, 带有活力的属性动画源码分析与实战

接下来的一个问题就是,属性动画反射回调的类是哪个类呢?这里有两种情况,一种是针对 Group 标签,一种是针对 Path 标签。但在说明具体具体类之前,我们有必要说明 Group 和 Path 标签的层级关系。

如下图所示, 叶子节点只能为Path标签 ,而 Group标签用于装载Path标签或Group标签 。值得一提的是 Vector 可以直接包含一个或多个Path, 而不一定需要包含Group。

接着我们来说说他们各自的具体反射类, Group标签 对应的是 VectorDrawableCompat$VGroup 类 ,其类的内部方法如下,带 set 开头的方法,已经用红框圈出, 这代表着我们为Group标签设置的属性动画所作用的属性就只能局限于这几个方法中


Path标签对应的是 VectorDrawableCompat\$VFullPath ,而 VectorDrawableCompat\$VFullPath 继承于 VectorDrawableCompat\$VPath ,这两个类的内部方法如下,同样用红框圈出 set 开头的方法,所以我们通过属性动画对Path标签进行控制的只能这几个属性。

小结一下,这些方法能满足我们一些简单的动画,但是设计师来了一个较为骚气的交互,这时我们比较尴尬了,因为我们没法进行扩展,没法设置我们自己想要的动画逻辑。

三、简单使用

我们先来阐述如何将SVG常规使用起来。但在这之前我们需要说明一下 SVG 中绘制 Path 的语法。

1、绘制语法

path 的 pathData属性内装载的就是路径数据,其语法如下

M = moveto(M X,Y) 将画笔移动到指定的坐标位置
L = lineto(L X,Y) 画直线到指定的坐标位置
H = horizontal lineto(H X)画水平线到指定的X坐标位置
V = vertical lineto(V Y)画垂直线到指定的Y坐标位置
C = curveto(C X1,Y1,X2,Y2,ENDX,ENDY)三阶贝赛曲线
S = smooth curveto(S X2,Y2,ENDX,ENDY)三阶贝赛曲线
Q = quadratic Belzier curve(Q X,Y,ENDX,ENDY)二阶贝赛曲线
T = smooth quadratic Belzier curveto(T ENDX,ENDY)映射
A = elliptical Arc(A RX,RY,XROTATION,FLAG1,FLAG2,X,Y)弧线
Z = closepath()关闭路径

小盆友个人认为,这些语法作为一个了解即可,并不需要记忆,因为 SVG 的资源文件一般不需要我们程序猿自行绘制,只是偶尔需要修改一下,所以要求并不是很高。

现在有很多在线编辑SVG工具,可以通过绘制后,将路径数据拷贝下来稍作修改,便可使用。

“手写”掘金 的 SVG资源就是小盆友从掘金官网获取后,进行一些简单的修改,所以只需要了解,需要修改时会运用就行。

2、作为静态图片资源

在 Android 中的常使用的模版为

<?xml version="1.0" encoding="utf-8"?>
<vector xmlns:android="http://schemas.android.com/apk/res/android"
    android:width="xxdp"
    android:height="yydp"
    android:viewportWidth="xx"
    android:viewportHeight="yy">
    <group>
            android:fillColor="#006CFF"
            android:pathData="xxxx" />
       ....more path or group
    </group>
    ....more path or group
</vector>

在 vector 标签中的 android:width android:height 表示的是 SVG的大小 ,而 android:viewportWidth android:viewportHeight 表示的是将 android:width android:height 划分成多少个等份, 随后的 Group 和 Path 的坐标则是基于这一比例进行编写

group 和 path 我们在前面已经提过了,就不再赘述。

我们举个简单的例子,用 SVG画出 如下图形,并将其使用

具体的SVG代码如下

// ic_menu.xml
<?xml version="1.0" encoding="utf-8"?>
<vector xmlns:android="http://schemas.android.com/apk/res/android"
    android:width="200dp"
    android:height="200dp"
    android:viewportWidth="100"
    android:viewportHeight="100">
        android:name="top"
        android:pathData="
        M 20,20
        L 50,20 80,20"
        android:strokeWidth="5"
        android:strokeColor="#000000"
        android:strokeLineCap="round" />
        android:name="middle"
        android:pathData="
        M 20,50
        L 50,50 80,50"
        android:strokeWidth="5"
        android:strokeColor="#000000"
        android:strokeLineCap="round" />
        android:name="bottom"
        android:pathData="
        M 20,80
        L 50,80 80,80"
        android:strokeWidth="5"
        android:strokeColor="#000000"
        android:strokeLineCap="round" />
</vector>

使用其实和普通的图片资源一样,ic_menu资源 便是我们的 SVG 图形

<ImageView
    android:layout_width="50dp"
    android:layout_height="50dp"
    android:layout_marginTop="10dp"
    android:src="@drawable/ic_menu" />

这里不存在兼容问题,小盆友在4.4的机子上也有测试过。

3、作为动态图片资源

SVG 的动画是比较有趣的,但我们在 “动画限制问题” 小节中提到,存在着兼容问题,5.0之前的版本不能使用SVG动画。

所以我们需要新建一个 drawable-anydpi-v21 文件夹,来存放我们的动画资源,具体存放结构和代码如下

animated-vector 起着 扣接 SVG静态资源 和 属性动画 的作用。

// menu.xml
<?xml version="1.0" encoding="utf-8"?>
<animated-vector xmlns:android="http://schemas.android.com/apk/res/android"
    android:drawable="@drawable/ic_menu">
    <target
        android:name="top"
        android:animation="@animator/top_anim" />
    <target
        android:name="bottom"
        android:animation="@animator/bottom_anim" />
</animated-vector>
// top_anim.xml
<?xml version="1.0" encoding="utf-8"?>
<objectAnimator xmlns:android="http://schemas.android.com/apk/res/android"
    android:duration="500"
    android:interpolator="@android:interpolator/accelerate_decelerate"
    android:propertyName="pathData"
    android:valueFrom="
    M 20,20
    L 50,20 80,20"
    android:valueTo="
    M 20,50
    L 50,20 50,20"
    android:valueType="pathType" />
// bottom_anim.xml
<?xml version="1.0" encoding="utf-8"?>
<objectAnimator xmlns:android="http://schemas.android.com/apk/res/android"
    android:duration="500"
    android:interpolator="@android:interpolator/accelerate_decelerate"
    android:propertyName="pathData"
    android:valueFrom="
    M 20,80
    L 50,80 80,80"
    android:valueTo="
    M 20,50
    L 50,80 50,80"
    android:valueType="pathType" />
值得一提的是,这里的 pathData 最终就是调用了 VectorDrawableCompat\$VPath 中的 setPathData,而参数类型便为 pathType。忘记的童鞋可以回 “动画限制问题” 小节查看下。

如果只是把我们这里使用的 menu资源放在 drawable-anydpi-v21 文件夹下,运行于 4.4的机子时,会报找不到相应资源的错误。所以我们需要在 drawable 文件夹下,建一个相同名字的资源 menu资源,只是里面的内容不是 animated-vector 作为根标签,而是使用和 ic_menu资源 完全一样的内容。

最终在代码中进行兼容处理 5.0之后的版本开启动画,之前的版本切换图片资源

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
    ((Animatable) img1.getDrawable()).start();
} else {
    img1.setImageDrawable(
            ContextCompat.getDrawable(SvgUseActivity.this, R.drawable.ic_back));
}

5.0之后版本的效果如下。5.0之前版本就只是简单图片切换,就不上图了:


四、实战

上一小节我们知道,对 SVG 添加动画,简单方便,但是也说明了使用系统自带的这一套操作无法实现较为复杂的交互,所以我们只能自己动手,才能丰衣足食了。

还记得小盆友在介绍优点时,说到SVG的格式是XML,这就是我们自己动手的切入点。因为格式为XML,所以可以自行解析,拿取其中的pathData数据转为Path路径,接下来就可以做很多有趣的事情。我们融入到实战中来体会这一趣事。

1、"手写"掘金

效果图

Github入口: 传送门

编码思路

(1)解析 SVG 文件 首先需要将 “掘金”这一SVG进行XML解析,我们借助 DocumentBuilderFactory 类,为我们解析获取一棵DOM树。

// 从 XML文档 生成 DOM对象树
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
Document document = null;
try {
    document = factory.newDocumentBuilder().parse(inputStream);
} catch (SAXException |
        IOException |
        ParserConfigurationException e) {
    e.printStackTrace();
} finally {
    try {
        inputStream.close();
    } catch (IOException e) {
        e.printStackTrace();
}

(2)获取并保存Path的数据 在上一步中获取到DOM树之后,进行遍历DOM节点获取到 Path 数据,保存其填充的颜色和将 pathData 的数据翻译成 Path对象进行保存起来。

这里需要借助 PathParser 类将 pathData 的数据翻译成 Path对象 ,但是PathParser类 被打上了注解 @hide ,我们无法直接使用,所以只能是将其拷贝一份放置我们的目录下来使用。具体核心代码如下

// 遍历所有的 Path 节点
for (int i = 0; i < pathNodeList.getLength(); ++i) {
    Element pathNode = (Element) pathNodeList.item(i);
    // path 的 svg 路径
    String pathData = pathNode.getAttribute(PATH_DATA);
    // path 的 颜色
    String colorData = pathNode.getAttribute(FILL_COLOR);
    // 解析 path
    Path path = null;
    try {
        path = PathParser.createPathFromPathData(pathData);
    } catch (Exception e) {
        e.printStackTrace();
    // path 解析出错,退出
    if (path == null) {
        mHandle.sendEmptyMessage(InnerHandler.ERROR);
        return;
    int color = Color.parseColor(colorData);
    path.computeBounds(rect, true);
    left = left == -1 ? rect.left : Math.min(left, rect.left);
    right = right == -1 ? rect.right : Math.max(right, rect.right);
    top = top == -1 ? rect.top : Math.min(top, rect.top);
    bottom = bottom == -1 ? rect.bottom : Math.max(bottom, rect.bottom);
    PathData item = new PathData();
    item.path = path;
    item.color = color;
    pathDataList.add(item);
}

(3)进行缩放 根据 SVG图像大小 和 画布大小,进行偏移和缩放,让SVG图像大小合适且居中显示于画布中。核心代码如下

float mScale = calculateScale(mSvgRect.width(), mSvgRect.height(), getWidth(), getHeight());
// 移至中心
mCanvasMatrix.preTranslate(getWidth() / 2, getHeight() / 2);
mCanvasMatrix.preTranslate(-mSvgRect.width() / 2, -mSvgRect.height() / 2);
mCanvasMatrix.preScale(
        mScale,
        mScale,
        mSvgRect.width() / 2,
        mSvgRect.height() / 2);
canvas.setMatrix(mCanvasMatrix);

(4)借助 PathMeasure 和 属性动画,让其进行勾勒后填充 属性动画开启后,每次刷新都通过 PathMeasure 对当前需要勾勒的Path进行裁剪绘制,达到一步步勾勒的效果。核心代码如下

PathData pathData = mPathDataList.get(index);
mPaint.setStyle(Paint.Style.STROKE);
mPaint.setColor(pathData.color);
mPaint.setStrokeWidth(mLineWidth / mScale);
mPathMeasure.setPath(pathData.path, false);
mPathMeasure.getSegment(0,
        mPathMeasure.getLength() * process,
        mAnimPath,
        true);
canvas.drawPath(mAnimPath, mPaint);
PathMeasure的使用,可以查看小盆友的另一篇博文: PathMeasure的API讲解与实战

2、地图查阅器

效果图


Github入口: 传送门

编码思路

(1)解析SVG数据 与“手写”掘金的事例一样,第一步也是解析数据,通过 PathParser 类将svg的数据转为Path对象,而颜色填充则由我们设置的数组决定。

同时还要保存好svg图像的大小,具体核心代码如下:

// 用于记录整个 svg 的实际大小
float left = -1;
float top = -1;
float right = -1;
float bottom = -1;
// 计算出 path 的 rect
RectF rect = new RectF();
// 遍历所有的 Path 节点
for (int i = 0; i < pathNodeList.getLength(); ++i) {
    Element pathNode = (Element) pathNodeList.item(i);
    // path 的 svg 路径
    String pathData = pathNode.getAttribute(DATA);
    // path 的 title
    String title = pathNode.getAttribute(TITLE);
    // 省略一些代码
    path.computeBounds(rect, true);
    left = left == -1 ? rect.left : Math.min(left, rect.left);
    right = right == -1 ? rect.right : Math.max(right, rect.right);
    top = top == -1 ? rect.top : Math.min(top, rect.top);
    bottom = bottom == -1 ? rect.bottom : Math.max(bottom, rect.bottom);
    ItemData itemData = new ItemData(path,
            ContextCompat.getColor(getContext(), mMapColor[i % colorSize]),
            title);
    mapDataList.add(itemData);
mSvgRect.left = left;
mSvgRect.top = top;
mSvgRect.right = right;
mSvgRect.bottom = bottom;

(2)缩放地图至View中心 根据画布的大小 和 svg的大小,将我们的画布进行偏移和缩放,使我们的地图大小合适且居中放置(这里借助了矩阵,但最终会将该矩阵作用于我们的画布)

// 移至画布中心
mCanvasMatrix.preTranslate(getWidth() / 2, getHeight() / 2);
// 移外边
float lastLeftMargin = mLastRectF.left - mSvgRect.left;
float lastTopMargin = mLastRectF.top - mSvgRect.top;
mCanvasMatrix.preTranslate(-lastLeftMargin, -lastTopMargin);
// 移至中心
mCanvasMatrix.preTranslate(-mLastRectF.width() / 2, -mLastRectF.height() / 2);
// 进行缩放
if (!mLastRectF.isEmpty()) {
    mScale = calculateScale(
            mLastRectF.width(),
            mLastRectF.height(),
            getWidth(),
            getHeight());
mCanvasMatrix.preScale(
        mScale,
        mScale,
        lastLeftMargin + mLastRectF.width() / 2,
        lastTopMargin + mLastRectF.height() / 2);

(3)如何交互 至此我们的地图就已经能正常显示了,但还需要交互。交互最主要的问题是 我们如何知道选中的是哪块区域 。具体通过一下代码进行判断,便可知道我们是否触碰了 该Path所包含的区域

/**
 * 是否在触碰的范围内
 * @param item 地图的每个数据项
 * @param x    触碰点的x轴
 * @param y    触碰点的y轴
 * @return true:在范围内;false:在范围外
private boolean isTouch(ItemData item, float x, float y) {
    item.path.computeBounds(mTouchRectF, true);
    mTouchRegion.setPath(
            item.path,
            new Region((int) mTouchRectF.left,
                    (int) mTouchRectF.top, 
 
推荐文章