HarmonyOS Lottie组件，让动画绘制更简单

原文：https://mp.weixin.qq.com/s/eC7g9ya4f_2AiNgteiyXcw，点击链接查看更多技术内容。

动画是UI界面的重要元素之一，精心设计的动画能使UI界面更直观，有助于改进应用程序的外观并改善用户体验。

ArkUI开发框架为开发者提供了丰富的动画能力，如属性动画、转场动画及自定义动画等。这些动画能力帮助开发者美化了UI界面，但不适用于绘制某些比较复杂的动画，例如，属性动画主要针对动画的通用属性进行动态变化，内容动效不够丰富，且变更时需要修改或重写代码；Gif动态图放大后锯齿明显，精度越高占用存储空间越大，直接影响安装包的大小；svg动画DOM节点多开销大，缺乏与用户的交互。

因此，我们引入了比较成熟的Lottie组件，提升了ArkUI开发框架的动画能力。

一、Lottie介绍

1. 什么是Lottie？

Lottie是一款能够为应用添加动画的开源组件，它可以解析AE（After Effects）导出的json文件，让复杂的动画资源轻松运行在应用程序中。如图1所示，动画文件通过AE的bodymovin插件转换成通用的json格式描述文件后，应用开发者只需使用Lottie解析json文件，就能将动画绘制出来。

图1 整体流程

2. Lottie绘制流程

Lottie解析json格式的动画描述文件后，会基于canvas 画布进行2D渲染，并结合原生组件Animator实现动画效果。具体绘制流程如下图2所示：

图2 lottie绘制流程

1）动画加载准备，在使用Lottie加载动画前需先通过插件 bodymovin 将AE生成的动画文件转换为通用的 json 格式描述文件。开发者也可以从互联网获取合适的动画资源直接应用。获取链接：https://lottiefiles.com/

2）获取json文件中的动画数据。

3）解析json文件中的动画数据。

4）创建动画实例，设置动画信息。

5）初始化布局宽高，设置绘制样式等信息。

6）启动动画，触发逐帧绘制。

7）更新动画进度。

8）返回动画实例，通过loadAnimation()接口返回动画实例AnimationItem。

9）控制动画，Lottie提供了一整套简洁易用API，如停止stop()、暂停pause()、播放play()、播放流转togglePause()、方向setDirection()、速度setSpeed()等。

3. Lottie优点

通过上文的介绍，我们可以总结出Lottie的以下优点：

只需使用Lottie解析json文件就能实现动画的加载，基本上实现了0代码开发。
应用开发者可以通过修改json文件的参数，将动画运行到不同的应用程序中，实现动画的一次设计多端使用。
应用开发者可从网络直接下载json文件，实时更新动画资源。
Lottie基于canvas 画布进行基础的2D渲染，让动画流畅度更高。
Lottie可以将UX设计师给出的复杂动画效果100%还原到应用程序中。
Lottie提供了丰富的API，让开发者能轻松控制动画，大大提高了开发效率。

二、Lottie实战

通过上文对Lottie的介绍，相信很多小伙伴已经感受到了Lottie组件的强大，下面我们将通过一个简单的动画示例来为大家展示ArkUI开发框架中Lottie组件的使用。

1. 创建项目

如图3所示，在DevEco Studio中新建Lottis_Test项目，项目类型选择Application，语言选择eTS，点击Finish完成创建。

图3 创建工程

2. 添加依赖

成功创建项目后，接下来就是将Lottie组件下载至项目中。首先，我们需找到npm配置文件，并在.npmrc 配置文件中添加 @ohos 的scope仓库地址：@ohos:registry=https://repo.harmonyos.com/npm/，如图4所示：

图4 指定npm仓库地址

配置好npm仓库地址后，如图5所示，在DevEcoStudio的底部导航栏，点击“Terminal”（快捷键Alt+F12），键入命令：npm install @ohos/lottie-ohos-ets并回车，此时Lottie组件会自动下载至项目中。下载完成后工程根目录下会生成node_modules/@ohos/lottie-ohos-ets目录。

图5 下载Lottie组件

注：由于目前lottie组件正在开源准备中，@ohos/lottie-ohos-ets仓库预计在3月底发布，敬请期待。

3. 导出动画资源并保存

将After Effects 导出的json动画资源文件保存到项目中，如图6所示，保存路径如下：entry/src/main/ets/MainAbility/common/lottie/animation.json,

图6 json保存路径

4. 编写逻辑代码

使用扩展的TS语言在工程的index.ets文件中编写业务逻辑代码，为了兼顾资源的及时释放，在组件@Component声明内的声明周期onDisappear()或onPageHide()中调用lottie.destory()释放资源。示例代码如下所示：

import lottie from '@ohos/lottie-ohos-ets'

@Entry

@Component

struct Index {

  private controller: RenderingContext = new RenderingContext();

// 动画别名

  private animateName: string = "animation";

// 动画资源相对路径

  private animatePath: string = "common/lottie/animation.json";

  private onPageHide(): void {

    // 随页面隐藏销毁动画

    lottie.destroy();

  }

  build() {

    Column() {

      // 声明Animator与Canvas组件

      Animator('__lottie_ets')

      Canvas(this.controller)

        .width('30%')

        .height('20%')

        .backgroundColor('#ff0000')

        .onAppear(() => {

          // 随Canvas布局自动加载动画

          let anim = lottie.loadAnimation({

            container: this.controller,

            renderer: 'canvas',

            loop: true,

            autoplay: true,

            name: this.animateName,

            path: this.animatePath

          })

        })

      Button('togglePause')

        .onClick(() => {

          // 声明button按键与设置点击事件，通过点击控制动画暂停与播放的切换

          lottie.togglePause(this.animateName);

        })

    }

    .width('100%')

    .height('100%')

  }

}

效果如下所示：

以上就是ArkUI开发框架中Lottie组件的使用，希望广大开发者能利用这个强大的开源组件开发出更多精美的应用。