Skip to content

Latest commit

 

History

History
194 lines (151 loc) · 7.91 KB

README.zh-cn.md

File metadata and controls

194 lines (151 loc) · 7.91 KB
Raw

简介

Jcenter Status license

switch language: English

SVG-Android是一款支持在Android 4.0+系统上显示SVG图片的开源库。

SVG-Android库可以将svg格式图片自动转化成vector文件(VectorDrawable对应的资源文件)，并且支持将vector文件一键 转化成java图片类文件，这些java图片类可以直接用来绘制在View的画布上。java图片类的绘制渲染速度比使用vector 文件更加快捷和高效，同时可以避免兼容性问题，毕竟5.0以上系统才支持VectorDrawable。同时，SVG-Android支持库还有 很多强大的功能，将svg矢量图的特性发挥到极致，比如给图片着色、缩放大小、改变透明度等等。另外，既支持在java代码中 使用也支持在xml中引用，对开发者来说非常地方便和人性化。

演示

范例

https://github.com/MegatronKing/SVG-Android/raw/master/SVG-Sample.apk

特性

  • 整体加载速度比png、iconfont和vector要快，主要是编译前预解码可以节省大量时间。
  • 相比于png格式图片，具有更好的性能和图片表现力。
  • 支持tint, alpha, size, selector等基本图片功能。
  • 可以降低apk包体积，相同内容但不同尺寸不同颜色的图片只需要一张即可，大幅提高图片利用率。
  • 维护方便，修改图片尺寸、颜色、透明等时，不需要找设计师重新切图，只需要修改大小或者替换色值就可以。
  • 支持各种动画效果，包括帧动画和属性动画，甚至支持@animator/xxx方式引用动画。
          速度   内存 兼容性 scaleType支持 清晰度 多色彩 降低包大小
  SVG-Android   √     √     √       √           √     √       √
Vector × √ x √ √ √ ×
Png √ × √ √ × √ ×
Iconfont × √ √ × √ × √

原理

使用

由于需要预处理svg图片，所以我们需要引入gradle插件并运行task，将svg或者svgz格式的图片生成对应的java渲染类， 为了在开发时能预览图片，我们会先生成vector资源文件并放到debug资源目录中参与编译。当然，这些vector资源文件是不能 release的，所以我们还会生成一个替代的空的shape资源文件并放到release资源目录中参与打包。

步骤1：在build.gradle中引入插件并配置参数

apply plugin: 'svg'

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.github.megatronking:svg-plugin:1.3.9'
    }
}

svg {
    // 下面四个参数是vector文件生成java渲染类文件的相关配置
    // vector资源文件目录，支持多个目录
    vectorDirs = ["src/main/svg_debug/drawable"]
    // shape资源文件目录
    shapeDir = "src/main/svg_release/drawable"
    // 生成java渲染类的存放包目录
    javaDir = "src/main/java/com/github/megatronking/svg/sample/drawables"

    // 下面参数是svg格式文件生成vector资源文件的配置
    svg2vector {
        // 这里的test可以随意命名，建议使用文件夹名
        test {
            // svg格式文件目录
            svgDir = "${rootDir}/test"
            // 生成vector资源文件的存放目录
            vectorDir = "src/main/svg_debug/drawable"
            // 宽高参数指定生成vector文件的宽高，如果省略将默认使用图片原始宽高
            // 注意此处宽高比要与图片宽高比一致，否则图片会变形
            height = 48
            width = 48
        }
     }
}

这里注意svgDir指向的目录，为存放svg文件的目录，区分好是rootDir（项目根目录）还是projectDir（模块根目录，比如app目录下面），否则后面执行task无法生成文件。

步骤2：在build.gradle中引入svg-support依赖

dependencies {
    compile 'com.github.megatronking:svg-support:1.3.2'
}

步骤3：运行相关task（可以执行下面的命令行，也可以在gradle面板中点击）

gradlew svgAssemble

这个命令可以将svg文件生成vector资源文件，再将vector资源文件生成java图片渲染类，如下：

public class ic_android_red extends SVGRenderer {
    ...

    @Override
    public void render(Canvas canvas, int w, int h, ColorFilter filter) {
        ...

        mPath.rCubicTo(0.0f, 0.55f, 0.45f, 1.0f, 1.0f, 1.0f);
        mPath.rLineTo(1.0f, 0f);
        mPath.rLineTo(0f, 3.5f);
        mPath.rCubicTo(0.0f, 0.83f, 0.67f, 1.5f, 1.5f, 1.5f);
        mPath.rCubicTo(0.8299999f, 0.0f, 1.5f, -0.67f, 1.5f, -1.5f);
        ...
        mPath.moveTo(10.0f, 5.0f);
        mPath.moveTo(15.0f, 5.0f);
        mPath.rLineTo(-1.0f, 0f);
        mPath.lineTo(14.0f, 4.0f);
        mPath.rLineTo(1.0f, 0f);
        mPath.rLineTo(0f, 1.0f);
        mPath.close();
        mPath.moveTo(15.0f, 5.0f);
        ...
        canvas.drawPath(mRenderPath, mFillPaint);
    }

}

通过上面自动生成的Java渲染类，就可以高效地将SVG图片直接绘制在View上。

gradlew svg2vector

这个命令可以批量将svg文件生成vector资源文件，即使你不需要java图片渲染类，使用这个任务批量处理svg->vector也是一个不错的选择。

步骤4：在Application类中提前初始化SVG加载器

public void onCreate() {
    SVGLoader.load(this)
}

步骤5：开发时既可以引用资源文件，也可以直接使用java渲染类

<ImageView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:src="@drawable/ic_android_red"/>

或者

Drawable drawable = new SVGDrawable(new ic_android_red(context));
imageView.setImageDrawable(drawable);

工具

图片库

SVG-Android提供了一套material-design风格的图片库，是基于google谷歌官方的svg文件生成。在svg-iconlibs目录下面，除了 可以直接使用的vector资源文件外，还有已经生成好的java图片类文件。如果你的项目缺少UI设计师，那么可以直接通过iconlibs找到大量常用的 图片。

点击查看： https://megatronking.github.io/SVG-Android/

文档