【亲测免费】 AndroidSVG 教程

1. 项目目录结构及介绍

AndroidSVG 的源代码库在 GitHub 上组织如下：

• androidsvg: 主要的 Java 源代码包，包含了解析和渲染 SVG 文件的核心类。
• doc: 文档目录，含有不同版本的开发者指南。
• gradle: 与 Gradle 构建系统相关的设置和脚本。
• gitignore: Git 忽略规则文件，定义了不应该被提交到仓库的文件类型。
• LICENSE: 开源许可证文件，采用 Apache License v2.0。
• README.md: 项目简介和安装说明。
• build.gradle: 应用构建脚本。
• settings.gradle: 项目级的 Gradle 配置。
• gradlew, gradlew.bat: Gradle 包装器脚本，用于在命令行中执行 Gradle 命令。

2. 项目启动文件介绍

AndroidSVG 是一个库，没有特定的"启动文件"。但是，它的主要入口点是 com.caverock.androidsvg.SVG 类。这个类提供了加载和解析 SVG 文件的方法，如 SVG.getFromString() 或 SVG.fromFile(). 之后，你可以通过 renderToCanvas() 方法将 SVG 渲染到 Android 的 Canvas 对象上。

例如，在你的应用程序中，你可能创建一个自定义的 View 来显示 SVG 图片，如下所示：

public class SVGImageView extends ImageView {
    public SVGImageView(Context context) {
        super(context);
        init();
    }

    public SVGImageView(Context context, AttributeSet attrs) {
        super(context, attrs);
        init();
    }

    private void init() {
        // 加载 SVG 文件
        SVG svg = SVGParser.parse(getResources(), R.raw.my_svg_file);

        // 创建 Canvas 并将其绑定到视图
        Bitmap bitmap = Bitmap.createBitmap(getWidth(), getHeight(), Bitmap.Config.ARGB_8888);
        Canvas canvas = new Canvas(bitmap);

        // 渲染 SVG 到 Canvas
        svg.renderToCanvas(canvas);

        // 设置图像
        setImageBitmap(bitmap);
    }
}

3. 项目的配置文件介绍

1) build.gradle（应用模块）

在应用模块的 build.gradle 文件中，你需要添加依赖以引入 AndroidSVG 库。确保已将 Maven Central 添加为你的仓库列表，并且添加以下依赖项：

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

这将包含 AndroidSVG 的最新稳定版本（在这个例子中是 1.4）。

2) settings.gradle（项目根目录）

虽然默认情况下，新的 Android Studio 项目可能已经有 mavenCentral() 在其仓库列表中，但如果你需要确认，可以在根目录的 settings.gradle 中检查：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
    repositories {
        google()
        mavenCentral()
    }
}

这保证了 build.gradle 文件可以正确地从 Maven Central 检索 AndroidSVG 库。

完成这些步骤后，你就可以在你的 Android 项目中解析和展示 SVG 图形了。如有疑问或遇到问题，参照项目官方文档或查阅 GitHub 页面上的 Issue 跟踪记录以获取更多帮助。