基于ArkUI框架开发-ImageKnife渲染层重构ImageKnife是一款图像加载缓存库,次要性能个性如下:
●反对内存缓存,应用LRUCache算法,对图片数据进行内存缓存。
●反对磁盘缓存,对于下载图片会保留一份至磁盘当中。
●反对进行图片变换:反对图像像素源图片变换成果。
●反对用户配置参数应用:(例如:配置是否开启一级内存缓存,配置磁盘缓存策略,配置仅应用缓存加载数据,配置图片变换成果,配置占位图,配置加载失败占位图等)。
更多细节请拜访源码仓库地址:https://gitee.com/openharmony-tpc/ImageKnife
背景阐明
晚期ImageKnife三方库在实现渲染局部的时候,应用的是image组件来展现图片的。因为image组件其实是一个残缺的集加载解析和图片展现的组件,渲染的模式只能通过配置固定参数进行,面对简单的需要场景,可能会呈现扩展性不够的状况。
当初随着工夫的推移渲染组件又多了一位重量级选手Canvas组件。能够通过2个组件渲染层的能力比照进行判断渲染层最终交由哪个组件展现。
如果想理解更多ImageKnife的背景常识,能够点击链接查看之前的文章介绍:
旧版本ImageKnife加载流程介绍https://developer.huawei.com/consumer/cn/forum/topic/02038645...
组件选型,能力比照
首先咱们来看看Image组件和Canvas组件对于渲染这一块的反对状况。
从上表咱们能够看出:
Image组件尽管反对了PixelMap的绘制,然而根本没有绘制控制能力,而且扩展性能力也比拟弱,并且渲染过程不可见,也无奈对绘制内容进行更多操作。
而Canvas组件属于更加底层的渲染组件,能够完满地管制绘制内容,并且渲染过程可见,合乎了开发者对于扩展性要求较高的定制场景。
重构前后能力比照
重构实现的内容
1.应用canvas组件代替Image组件进行渲染展现图片。
2.所有图像数据在渲染层都转换为PixelMap,不便对立治理和扩大。
3.所有回调节点,对立形象成接口,不便后续进行扩大,进步代码可维护性。
4.所有的回调节点绘制的实现,都采纳了责任链模式,进步了自定义绘制扩大能力。
5.将局部通用办法封装成工厂办法,缩小开发者代码量。
6.通用办法从配置参数剥离,可采纳链式调用形式应用这些办法。
7.为了反对列表ImageKnifeOption参数应用@LinkObject润饰,同时ImageKnifeOption类型被@Observed润饰继承,不可被继承。
重构中比拟重要的点
点1:回调接口形象为IDrawLifeCycle接口
渲染绘制是主线程能力操作。因而咱们能够对渲染程序进行了梳理,大抵流程:展现占位图->展现网络加载进度->展现缩略图->展现主图->展现重试图层->展现失败占位图
这里每个蓝色的小方格都代表着一个数据返回的回调接口,咱们须要在这个回调接口,解决接下来内容渲染的展现操作。因为每个回调的流程是固定的,有点像生命周期的流程。所以我这边形象成接口IDrawLifeCycle绘制生命周期进行表白。这其实也是为了前面扩大做了筹备。
点2:绘制实现采纳责任链模式
咱们反对了用户配置自定义绘制和全局配置自定义绘制的能力。采纳了责任链模式实现,用户参数设置->全局参数设置->自定义组件外部设置。这样设计的益处就是保留了用户扩大的能力,用户能够参加自定义绘制。
点3:提供了ImageKnifeDrawFactory工厂类
在开发者须要进行自定义绘制时,必须实现IDrawLifeCycle的6个接口。为了简化开发者操作,这里提供了ImageKnifeDrawFactory工厂类。
ImageKnifeDrawFactory外面封装了圆角、椭圆、百分比下载等实现,简化用户操作。当然更多的需要,能够参考该工厂类自行扩大实现。
这里咱们提供简略的场景示例:
场景1:一句代码,加个圆角成果
代码如下:
import {ImageKnifeComponent} from '@ohos/imageknife'import {ImageKnifeOption} from '@ohos/imageknife'import {ImageKnifeDrawFactory} from '@ohos/imageknife'@Entry@Componentstruct Index { @State imageKnifeOption1: ImageKnifeOption = { // 加载一张本地的png资源(必选) loadSrc: $r('app.media.pngSample'), // 主图的展现模式是 缩放至适宜组件大小,并且在组件底部绘制 mainScaleType: ScaleType.FIT_END, // 占位图应用本地资源icon_loading(可选) placeholderSrc: $r('app.media.icon_loading'), // 失败占位图应用本地资源icon_failed(可选) errorholderSrc: $r('app.media.icon_failed'), // 绘制圆角30,边框5,边框"#ff00ff".用户自定义绘制(可选) drawLifeCycle:ImageKnifeDrawFactory.createRoundLifeCycle(5,"#ff00ff",30) }; build() { Scroll() { Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) { ImageKnifeComponent({ imageKnifeOption: this.imageKnifeOption1 }) .width(300) // 自定义组件已反对设置通用属性和事件,这里宽高设置放在链式调用中实现 .height(300) } } .width('100%') .height('100%') }}
场景2:全局配置网络下载百分比成果展现
仅需一句代码所有网络图片加载都能新增网络下载百分比成果展现。代码如下:
import AbilityStage from '@ohos.application.Ability'import { ImageKnife,ImageKnifeDrawFactory} from '@ohos/imageknife'export default class EntryAbility extends Ability { onCreate(want,launchParam) { globalThis.ImageKnife = ImageKnife.with(this.context); // 全局配置网络加载进度条 globalThis.ImageKnife.setDefaultLifeCycle(ImageKnifeDrawFactory.createProgressLifeCycle("#10a5ff", 0.5)) }}
这里大家可能会问,为什么会将这个IDrawLifeCycle放在EntryAbility外面实现?
这是因为网络下载百分比进度很多时候都是全局通用,如果有须要全局配置的自定义展现计划。举荐在EntryAbility外面,往ImageKnife的setDefaultLifeCycle函数中注入,即可将ImageKnifeComponent中的默认绘制计划替换。
在这里咱们实现的成果如下图所示。
点4:通用属性办法和属性曾经反对链式调用
比方上面的代码的宽高曾经不必设置在ImageKnifeOption对象中了,间接在自定义组件下方链式调用设置即可。
import {ImageKnifeComponent,ImageKnifeOption,ImageKnifeDrawFactory} from '@ohos/imageknife'@Entry@Componentstruct Index { @State imageKnifeOption1: ImageKnifeOption = { // 加载一张本地的png资源(必选) loadSrc: $r('app.media.pngSample'), }; build() { Scroll() { Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) { ImageKnifeComponent({ imageKnifeOption: this.imageKnifeOption1 }) .width(300) // 自定义组件已反对设置通用属性和事件,这里宽高设置放在链式调用中实现 .height(300) } } .width('100%') .height('100%') }}
点5:如何在列表应用
反对列表应用图片加载,只须要保护一个@State options:Array<ImageKnifeOption> = []对象即可
import {ImageKnifeOption,ImageKnifeComponent} from '@ohos/imageknife'@Entry@Componentstruct BasicTestFeatureAbilityPage { urls=[ "http://e.hiphotos.baidu.com/image/pic/item/a1ec08fa513d2697e542494057fbb2fb4316d81e.jpg", "http://c.hiphotos.baidu.com/image/pic/item/30adcbef76094b36de8a2fe5a1cc7cd98d109d99.jpg", "http://h.hiphotos.baidu.com/image/pic/item/7c1ed21b0ef41bd5f2c2a9e953da81cb39db3d1d.jpg", "http://g.hiphotos.baidu.com/image/pic/item/55e736d12f2eb938d5277fd5d0628535e5dd6f4a.jpg", "http://e.hiphotos.baidu.com/image/pic/item/4e4a20a4462309f7e41f5cfe760e0cf3d6cad6ee.jpg", ] @State options:Array<ImageKnifeOption> = [] aboutToAppear(){ this.options = this.urls.map((url)=>{ return { loadSrc:url } }) console.log('this.options length ='+this.options.length) } build() { Stack({ alignContent: Alignment.TopStart }) { Column() { List({ space: 20, initialIndex: 0 }) { ForEach(this.options, (item) => { ListItem() { ImageKnifeComponent({imageKnifeOption:item}).width(300).height(300) } }, item => item.loadSrc) } .listDirection(Axis.Vertical) // 排列方向 .divider({ strokeWidth: 2, color: 0xFFFFFF, startMargin: 20, endMargin: 20 }) // 每行之间的分界线 .edgeEffect(EdgeEffect.None) // 滑动到边缘无成果 .chainAnimation(false) // 联动特效敞开 }.width('100%') }.width('100%').height('100%').backgroundColor(0xDCDCDC).padding({ top: 5 }) }}
渲染层重构的总结
综上可知,此次重构渲染层,一共新增了6个根底能力,适配了IDE最新版个性自定义组件可链式调用通用属性和办法,并且采纳适宜的设计模式保留了自定义组件绘制局部的拓展能力。展现了局部罕用场景下应用代码的形式,帮忙开发者更快上手开发。
最初在OpenHarmony一直新陈代谢之际,三方库ImageKnife也应该激流勇进,一直地晋升组件的实用性和适用性,为开发者发明一个良好的开发体验。
咱们将会继续更新ImageKnife三方库,后续会切换成GPU来渲染图片变换能力,一直进行性能优化,晋升ImageKnife三方库。
同时也欢送开发者应用和提issue。