ImageKnife组件，让小白也能轻松搞定图片开发

本期我们给大家带来的是开发者周黎生的分享，希望能给你的HarmonyOS开发之旅带来启发~

图片是UI界面的重要元素之一，图片加载速度及效果直接影响应用体验。ArkUI开发框架提供了丰富的图像处理能力，如图像解码、图像编码、图像编辑及基本的位图操作等，满足了开发者日常开发所需。

但随着产品需求的日益增长，基本的图像处理能力已不能胜任某些比较复杂的应用场景，如无法直接获取缓存图片、无法配置占位图、无法进行自定义PixelMap图片变换等。

为增强ArkUI开发框架的图像处理能力，ImageKnife组件应运而生。本期我们将为大家带来ImageKnife的介绍。

一、ImageKnife简介

ImageKnife是一个参考Glide框架进行设计，并基于eTS语言实现的图片处理组件。它可以让开发者能轻松且高效地进行图片开发。

注：Glide是一个快速高效的图片加载库，注重于平滑的滚动，提供了易用的API，高性能、可扩展的图片解码管道，以及自动的资源池技术。

功能方面，ImageKnife提供了自定义图片变换、占位图等图片处理能力，几乎满足了开发者进行图片处理的一切需求。
性能方面，ImageKnife采用LRU策略实现二级缓存，可灵活配置，有效减少内存消耗，提升了应用性能。
使用方面，ImageKnife封装了一套完整的图片加载流程，开发者只需根据ImageKnifeOption配置相关信息即可完成图片的开发，降低了开发难度，提升了开发效率。

如图1所示，是ImageKnife加载图片的整体流程。

图1 ImageKnife加载图片整体流程

二、ImageKnife实现原理

下面我们将为大家介绍ImageKnife加载图片过程中每个环节的实现原理，让大家更深刻地认识ImageKnife组件。图2是ImageKnife加载图片的时序图：

图2 ImageKnife加载图片的时序图

1. 用户配置信息

在加载图片前，用户需根据自身需求配置相应的参数，包括图片路径、图片大小、占位图及缓存策略等。ImageKnife提供了RequestOption类，用于封装用户配置信息的接口，如图3所示列举了部分接口供大家参考：

图3 用户配置参数

通过ImageKnifeExecute()方法获取用户配置信息，然后执行ImageKnife.call(request)，正式启动图片加载任务。相关实现代码如下：

imageKnifeExecute() {

  // 首先需要确保获取ImageKnife单例对象

  if(ImageKnife){

  }else{

    ImageKnife = globalThis.exports.default.data.imageKnife;

  }

  // 生成配置信息requestOption

  let request = new RequestOption();

  // 配置必要信息和回调

  this.configNecessary(request);

  // 配置缓存相关信息

  this.configCacheStrategy(request);

  // 配置显示信息和回调

  this.configDisplay(request);

  // 启动ImageKnife执行请求

  ImageKnife.call(request);

}

2. 加载图片

加载图片过程是ImageKnife组件的核心部分，如图4所示，包含占位图填充、缓存实现及图片解码三个环节。下面我们将为大家分别介绍每个环节的实现。

图4图片加载过程

(1) 占位图填充

占位图就是图片加载过程中页面上的过渡效果，通常表现形式是在页面上待加载区域填充灰色的占位图，可以使得页面框架不会因为加载失败而变形。ImageKnife提供了占位图功能，开发者可在RequestOption中配置是否启动占位图任务。

如图5所示是占位图工作流程，执行图片加载任务后，占位图会填充加载页面。如果图片解析成功则将页面上填充的占位图替换为待加载的图片。如果图片解析失败，则将页面上填充的占位图替换为“图片解析失败占位图”。

图5 占位图工作流程

三、ImageKnife实战

通过上文的介绍，相信大家对ImageKnife组件有了深刻的了解。下面我们将创建一个ImageKnife_Test项目，为大家展示ArkUI开发框架中ImageKnife组件的使用。

通过将ImageKnife组件下载至项目中，然后根据ImageKnifeOption配置相关信息，即可完成GIF图片的加载。

1. 创建项目

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

图8 创建项目

2. 添加依赖

成功创建项目后，接下来就是将ImageKnife组件下载至项目中。

首先，我们需找到.npmrc 配置文件，并在文件中添加 @ohos 的scope仓库地址：@ohos:registry=https://repo.harmonyos.com/npm/，如图9所示：

图9 添加 scope仓库地址

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

图10 下载至项目

3. 编写逻辑代码

ImageKnife组件成功下载至项目中后，接下来就是逻辑代码编写，这里我们将为大家介绍两种使用方式：

方式一：首先初始化全局ImageKnife实例，然后在app.ets中调用ImageKnife.with()进行初始化。相关代码如下：

import {ImageKnife} from '@ohos/imageknife'

export default {

  data: {

    imageKnife: {} // ImageKnife

  },

  onCreate() {

    this.data.imageKnife = ImageKnife.with();

  },

  onDestroy() {

  },

}

然后在页面index.ets中使用ImageKnife，相关代码如下：

@Entry

@Component

struct Index {

  build() {

  }

  // 页面初始化完成，生命周期回调函数中 进行调用ImageKnife

  aboutToAppear() {

    let requestOption = new RequestOption();

  requestOptin.load($r('app.media.IceCream'))

  .addListener((err,data) => {

      //加载成功/失败回调监听

    })

    ...

  ImageKnife.call(requestOption)

  }

}

var ImageKnife;

var defaultTemp = globalThis.exports.default

if (defaultTemp != undefined) {

  ImageKnife = defaultTemp.data.imageKnife;

}

方式二：在index.ets中，直接使用ImageKnifeOption作为入参，并配合自定义组件ImageKnifeComponent使用。相关代码如下：

import {ImageKnifeOption} from '@ohos/imageknife'

@Entry

@Component

struct Index {

  @State imageKnifeOption1: ImageKnifeOption =

    {

      loadSrc: $r('app.media.gifSample'),

      size: { width: 300, height: 300 },

      placeholderSrc: $r('app.media.icon_loading'),

      errorholderSrc: $r('app.media.icon_failed')

    };

  build() {

    Scroll() {

      Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {

        ImageKnifeComponent({ imageKnifeOption: $imageKnifeOption1 })

      }

    }

    .width('100%')

    .height('100%')

  }

}

以上就是本期全部内容，恭喜大家花几分钟时间收获了一个实用的组件。希望广大开发者能利用这个强大的开源组件开发出更多精美的应用。

搜索

复制