AndroidSVG 使用指南

1. 项目介绍

AndroidSVG 是一个用于 Android 平台的 SVG 解析器和渲染库。它支持 SVG 1.1 和 SVG 1.2 Tiny 规范中的静态视觉元素（不包括过滤器）。库能够正确地渲染 SVG 酸性测试文件，并且兼容各种流行的矢量编辑软件如 Adobe Illustrator、Sketch 等导出的 SVG 文件。该项目采用 Apache 2.0 许可。

2. 项目快速启动

在你的项目中集成 AndroidSVG，首先确保在根级 build.gradle 文件的仓库列表中添加了 Maven 中央仓库：

repositories {
    google()
    jcenter()
    mavenCentral()
}

然后，在你的 app 模块的 build.gradle 文件中添加依赖：

dependencies {
    implementation 'com.caverock:androidsvg-aar:1.4'
}

接下来，你就可以加载并解析 SVG 文件了。以下是一个简单的示例：

SVG svg = SVG.getFromString("<svg width='100%' height='100%' viewBox='0 0 100 100'><rect x='10' y='10' width='80' height='80' fill='red'/></svg>");
ImageView imageView = findViewById(R.id.imageView);
imageView.setImageBitmap(svg.renderToBitmap());

3. 应用案例和最佳实践

示例一：从资源文件加载 SVG

如果你的 SVG 图片已存储在项目的 res/raw 目录下，可以通过以下方式加载：

InputStream inputStream = getResources().openRawResource(R.raw.my_svg_file);
SVG svg = SVGParser.parse(inputStream);
Bitmap bitmap = svg.renderToBitmap();
imageView.setImageBitmap(bitmap);

最佳实践

• 在内存有限的情况下，考虑将 SVG 渲染成 Bitmap 后再进行显示，以减少内存消耗。
• 对于不需要动态改变的 SVG 图形，可以先预渲染成图片存储起来，避免频繁解析。

4. 典型生态项目

虽然 AndroidSVG 主要是作为一个独立库存在，但在实际应用中，它常与其他图形库或框架配合使用，例如结合 RecyclerView 或 ViewPager 来实现 SVG 图片的滑动展示，或者在地图应用中作为图标绘制元素等。

若需查看更多相关示例和实际应用，可以参考项目提供的 Sample App，这将有助于了解如何在实际应用程序中使用该库。

希望这个指南对您理解和使用 AndroidSVG 能有所帮助。如果在使用过程中遇到任何问题，建议查阅项目文档或直接向作者反馈。祝您开发愉快！