介绍

svga-cj是一个动画库，它可以解析svga格式的动画，并在移动设备上进行本地渲染。

特性

• 支持加载svga格式的动画
• 支持动画播放，暂停，快进等功能

源码目录

/svga-cj             # 项目根目录
├─AppScope
├─doc                         # API文档和使用手册存放目录                   
├─entry                       # 示例代码文件夹    
├─hvigor                      # 构建工具目录              
├─svga                        # 弹幕库文件夹                   
│  └─src
│      └─main
│          ├─cangjie
│          │  └─src           # 库源代码目录
│          └─resources
├─README.md                   # svga库介绍及使用说明

接口说明

主要类和函数接口说明详见 API

使用说明

编译构建

该三方库依赖stdx，请参考stdx文档配置CANGJIE_STDX_PATH路径

1. 通过module引入
   1. 克隆下载项目
   2. 将svga模块拷贝到应用项目下
   3. 将svga模块当module引用，修改项目下的 build-profile.json5 文件，在 modules 字段添加下面代码

      {
      "name": "svga",
      "srcPath": "./svga"
      }
      

   4. 修改自身应用 entry 下的 oh-package.json5 文件，在 dependencies 字段添加 "@cangjie-tpc/svga": "file:../svga"

      {
         "name": "entry",
         "version": "1.0.0",
         "description": "Please describe the basic information.",
         "main": "",
         "author": "",
         "license": "",
         "dependencies": {
           "@cangjie-tpc/svga": "file:../svga"
         }
       }
      

   5. 修改自身应用 entry/src/main/cangjie 下的 cjpm.toml 文件，在 [dependencies] 字段下添加 svga = {path = "${cangjie_tpc_svga}"}

      [dependencies]
       [dependencies.svga]
       path = "${cangjie_tpc_svga}"
      

   6. 在项目中使用 import svga.* 引用svga项目

      import svga.*
      

功能示例

import ohos.base.*
import ohos.component.*
import ohos.state_manage.*
import ohos.state_macro_manage.*
import svga.*
import svga.player.*

@HybridComponentEntry
@Component
class Index {
    @State
    var controller: SvgaController = SvgaController()
    public func build() {
        Column {
              SvgaPlayer(url: "angel.svga",abilitycontext: getContext(),controller: controller)
        }
    }
}

约束与限制

在下述版本验证通过：

编号	依赖构建工具	版本号
1	DevEco Studio 6.1.1 Release	6.1.1.280
2	cjc	v1.1.3
3	DevEco Studio-Cangjie Plugin 6.1.1 Beta1	6.1.1.280
4	compatibility-sdk-6.1.1.280	6.1.1.280

svga依赖三方库：

编号	依赖三方库	版本号
1	stdx	v1.1.3.1
2	zlib4cj	v1.2.3-rc.1
3	protobuf4cj	v1.0.3

1. 只支持2.0版本svga资源
2. 不支持音频动画播放

开源协议

本项目基于 Apache License 2.0，请自由地享受和参与开源。

参与贡献

欢迎给我们提交 PR，欢迎给我们提交 Issue，欢迎参与任何形式的贡献。