0
  • 聊天消息
  • 系統(tǒng)消息
  • 評論與回復(fù)
登錄后你可以
  • 下載海量資料
  • 學(xué)習(xí)在線課程
  • 觀看技術(shù)視頻
  • 寫文章/發(fā)帖/加入社區(qū)
會(huì)員中心
創(chuàng)作中心

完善資料讓更多小伙伴認(rèn)識你,還能領(lǐng)取20積分哦,立即完善>

3天內(nèi)不再提示

基于ArkUI框架開發(fā)-ImageKnife渲染層重構(gòu)

OpenAtom OpenHarmony ? 來源:未知 ? 2023-04-05 00:25 ? 次閱讀

點(diǎn)擊藍(lán)字 ╳ 關(guān)注我們


開源項(xiàng)目 OpenHarmony
是每個(gè)人的 OpenHarmony

周黎生

OpenHarmony知識體系工作組

ImageKnife是一款圖像加載緩存庫,主要功能特性如下:
支持內(nèi)存緩存,使用LRUCache算法,對圖片數(shù)據(jù)進(jìn)行內(nèi)存緩存。
支持磁盤緩存,對于下載圖片會(huì)保存一份至磁盤當(dāng)中。
支持進(jìn)行圖片變換:支持圖像像素源圖片變換效果。
支持用戶配置參數(shù)使用:(例如:配置是否開啟一級內(nèi)存緩存,配置磁盤緩存策略,配置僅使用緩存加載數(shù)據(jù),配置圖片變換效果,配置占位圖,配置加載失敗占位圖等)。
更多細(xì)節(jié)請?jiān)L問源碼倉庫地址:
https://gitee.com/openharmony-tpc/ImageKnife

背景說明

早期ImageKnife三方庫在實(shí)現(xiàn)渲染部分的時(shí)候,使用的是image組件來展示圖片的。由于image組件其實(shí)是一個(gè)完整的集加載解析和圖片展示的組件,渲染的模式只能通過配置固定參數(shù)進(jìn)行,面對復(fù)雜的需求場景,可能會(huì)出現(xiàn)擴(kuò)展性不夠的情況。
現(xiàn)在隨著時(shí)間的推移渲染組件又多了一位重量級選手Canvas組件。可以通過2個(gè)組件渲染層的能力對比進(jìn)行判斷渲染層最終交由哪個(gè)組件展示。
如果想了解更多ImageKnife的背景知識,可以點(diǎn)擊鏈接查看之前的文章介紹:
舊版本ImageKnife加載流程介紹
https://developer.huawei.com/consumer/cn/forum/topic/0203864555891240375?fid=0101587866109860105

組件選型,能力對比

首先我們來看看Image組件和Canvas組件對于渲染這一塊的支持情況。


從上表我們可以看出:
Image組件雖然支持了PixelMap的繪制,但是基本沒有繪制控制能力,而且擴(kuò)展性能力也比較弱,并且渲染過程不可見,也無法對繪制內(nèi)容進(jìn)行更多操作。
而Canvas組件屬于更加底層的渲染組件,可以完美地控制繪制內(nèi)容,并且渲染過程可見,符合了開發(fā)者對于擴(kuò)展性要求較高的定制場景。

重構(gòu)前后能力對比

重構(gòu)完成的內(nèi)容

1.使用canvas組件替代Image組件進(jìn)行渲染展示圖片。
2.所有圖像數(shù)據(jù)在渲染層都轉(zhuǎn)換為PixelMap,方便統(tǒng)一管理和擴(kuò)展。
3.所有回調(diào)節(jié)點(diǎn),統(tǒng)一抽象成接口,方便后續(xù)進(jìn)行擴(kuò)展,提高代碼可維護(hù)性。
4.所有的回調(diào)節(jié)點(diǎn)繪制的實(shí)現(xiàn),都采用了責(zé)任鏈模式,提高了自定義繪制擴(kuò)展能力。
5.將部分通用方法封裝成工廠方法,減少開發(fā)者代碼量。
6.通用方法從配置參數(shù)剝離,可采用鏈?zhǔn)秸{(diào)用方式使用這些方法。
7.為了支持列表ImageKnifeOption參數(shù)使用@LinkObject修飾,同時(shí)ImageKnifeOption類型被@Observed修飾繼承,不可被繼承。

重構(gòu)中比較重要的點(diǎn)

點(diǎn)1:回調(diào)接口抽象為IDrawLifeCycle接口
渲染繪制是主線程才能操作。因此我們可以對渲染順序進(jìn)行了梳理,大致流程:展示占位圖->展示網(wǎng)絡(luò)加載進(jìn)度->展示縮略圖->展示主圖->展示重試圖層->展示失敗占位圖


這里每個(gè)藍(lán)色的小方格都代表著一個(gè)數(shù)據(jù)返回的回調(diào)接口,我們需要在這個(gè)回調(diào)接口,處理接下來內(nèi)容渲染的展示操作。因?yàn)槊總€(gè)回調(diào)的流程是固定的,有點(diǎn)像生命周期的流程。所以我這邊抽象成接口IDrawLifeCycle繪制生命周期進(jìn)行表達(dá)。這其實(shí)也是為了后面擴(kuò)展做了準(zhǔn)備。

點(diǎn)2:繪制實(shí)現(xiàn)采用責(zé)任鏈模式
我們支持了用戶配置自定義繪制和全局配置自定義繪制的能力。采用了責(zé)任鏈模式實(shí)現(xiàn),用戶參數(shù)設(shè)置->全局參數(shù)設(shè)置->自定義組件內(nèi)部設(shè)置。這樣設(shè)計(jì)的好處就是保留了用戶擴(kuò)展的能力,用戶可以參與自定義繪制。


點(diǎn)3:提供了ImageKnifeDrawFactory工廠類
在開發(fā)者需要進(jìn)行自定義繪制時(shí),必須實(shí)現(xiàn)IDrawLifeCycle的6個(gè)接口。為了簡化開發(fā)者操作,這里提供了ImageKnifeDrawFactory工廠類。
ImageKnifeDrawFactory里面封裝了圓角、橢圓、百分比下載等實(shí)現(xiàn),簡化用戶操作。當(dāng)然更多的需求,可以參考該工廠類自行擴(kuò)展實(shí)現(xiàn)。
這里我們提供簡單的場景示例:
場景1:一句代碼,加個(gè)圓角效果
代碼如下:
import {ImageKnifeComponent} from '@ohos/imageknife'
import {ImageKnifeOption} from '@ohos/imageknife'
import {ImageKnifeDrawFactory} from '@ohos/imageknife'
@Entry
@Component
struct 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) // 自定義組件已支持設(shè)置通用屬性和事件,這里寬高設(shè)置放在鏈?zhǔn)秸{(diào)用中完成
.height(300)
}
}
.width('100%')
.height('100%')
}
}

場景2:全局配置網(wǎng)絡(luò)下載百分比效果展示
僅需一句代碼所有網(wǎng)絡(luò)圖片加載都能新增網(wǎng)絡(luò)下載百分比效果展示。代碼如下:
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);
// 全局配置網(wǎng)絡(luò)加載進(jìn)度條
globalThis.ImageKnife.setDefaultLifeCycle(ImageKnifeDrawFactory.createProgressLifeCycle("#10a5ff", 0.5))
}
}
這里大家可能會(huì)問,為什么會(huì)將這個(gè)IDrawLifeCycle放在EntryAbility里面實(shí)現(xiàn)?
這是因?yàn)榫W(wǎng)絡(luò)下載百分比進(jìn)度很多時(shí)候都是全局通用,如果有需要全局配置的自定義展示方案。推薦在EntryAbility里面,往ImageKnife的setDefaultLifeCycle函數(shù)中注入,即可將ImageKnifeComponent中的默認(rèn)繪制方案替換。
在這里我們實(shí)現(xiàn)的效果如下圖所示。


點(diǎn)4:通用屬性方法和屬性已經(jīng)支持鏈?zhǔn)秸{(diào)用
比如下面的代碼的寬高已經(jīng)不用設(shè)置在ImageKnifeOption對象中了,直接在自定義組件下方鏈?zhǔn)秸{(diào)用設(shè)置即可。
import {ImageKnifeComponent,ImageKnifeOption,ImageKnifeDrawFactory} from '@ohos/imageknife'
@Entry
@Component
struct 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) // 自定義組件已支持設(shè)置通用屬性和事件,這里寬高設(shè)置放在鏈?zhǔn)秸{(diào)用中完成
.height(300)
}
}
.width('100%')
.height('100%')
}
}

點(diǎn)5:如何在列表使用
支持列表使用圖片加載,只需要維護(hù)一個(gè)@State options:Array = []
對象即可
import {ImageKnifeOption,ImageKnifeComponent} from '@ohos/imageknife'
@Entry
@Component
struct 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 = []
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) // 滑動(dòng)到邊緣無效果
.chainAnimation(false) // 聯(lián)動(dòng)特效關(guān)閉
}.width('100%')
}.width('100%').height('100%').backgroundColor(0xDCDCDC).padding({ top: 5 })
}
}

渲染層重構(gòu)的總結(jié)

綜上可知,此次重構(gòu)渲染層,一共新增了6個(gè)基礎(chǔ)能力,適配了IDE最新版特性自定義組件可鏈?zhǔn)秸{(diào)用通用屬性和方法,并且采用適合的設(shè)計(jì)模式保留了自定義組件繪制部分的拓展能力。展示了部分常用場景下使用代碼的方式,幫助開發(fā)者更快上手開發(fā)。
最后在OpenHarmony不斷推陳出新之際,三方庫ImageKnife也應(yīng)該激流勇進(jìn),不斷地提升組件的實(shí)用性和適用性,為開發(fā)者創(chuàng)造一個(gè)良好的開發(fā)體驗(yàn)。
我們將會(huì)持續(xù)更新ImageKnife三方庫,后續(xù)會(huì)切換成GPU來渲染圖片變換能力,不斷進(jìn)行性能優(yōu)化,提升ImageKnife三方庫。
同時(shí)也歡迎開發(fā)者使用和提issue。




原文標(biāo)題:基于ArkUI框架開發(fā)-ImageKnife渲染層重構(gòu)

文章出處:【微信公眾號:OpenAtom OpenHarmony】歡迎添加關(guān)注!文章轉(zhuǎn)載請注明出處。

聲明:本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人,不代表電子發(fā)燒友網(wǎng)立場。文章及其配圖僅供工程師學(xué)習(xí)之用,如有內(nèi)容侵權(quán)或者其他違規(guī)問題,請聯(lián)系本站處理。 舉報(bào)投訴
  • 鴻蒙
    +關(guān)注

    關(guān)注

    57

    文章

    2295

    瀏覽量

    42641
  • OpenHarmony
    +關(guān)注

    關(guān)注

    25

    文章

    3614

    瀏覽量

    15991

原文標(biāo)題:基于ArkUI框架開發(fā)-ImageKnife渲染層重構(gòu)

文章出處:【微信號:gh_e4f28cfa3159,微信公眾號:OpenAtom OpenHarmony】歡迎添加關(guān)注!文章轉(zhuǎn)載請注明出處。

收藏 人收藏

    評論

    相關(guān)推薦

    ArkUI-X開發(fā)指南:【SDK配置和構(gòu)建說明】

    ArkUI-X SDK是ArkUI-X開源項(xiàng)目的編譯產(chǎn)物,可將ArkUI-X SDK集成到現(xiàn)有Android和iOS應(yīng)用工程中,使開發(fā)者基于一套ArkTS主代碼,就可以構(gòu)建支持多平臺的
    的頭像 發(fā)表于 05-25 16:48 ?2392次閱讀
    <b class='flag-5'>ArkUI</b>-X<b class='flag-5'>開發(fā)</b>指南:【SDK配置和構(gòu)建說明】

    鴻蒙開發(fā)ArkUI-X基礎(chǔ)知識:【ArkUI代碼工程及構(gòu)建介紹】

    ArkUI作為OpenHarmony的默認(rèn)開發(fā)框架,在本項(xiàng)目(ArkUI-X)中需要做到一套代碼同時(shí)支持多平臺構(gòu)建,所以會(huì)采取共倉開發(fā)的方式
    的頭像 發(fā)表于 05-25 16:45 ?1931次閱讀
    鴻蒙<b class='flag-5'>開發(fā)</b><b class='flag-5'>ArkUI</b>-X基礎(chǔ)知識:【<b class='flag-5'>ArkUI</b>代碼工程及構(gòu)建介紹】

    鴻蒙開發(fā)ArkUI-X基礎(chǔ)知識:【ArkUI跨平臺設(shè)計(jì)總體說明】

    本文檔描述ArkUI開發(fā)框架跨平臺運(yùn)行能力相關(guān)的總體技術(shù)方案。
    的頭像 發(fā)表于 05-24 15:41 ?1391次閱讀
    鴻蒙<b class='flag-5'>開發(fā)</b><b class='flag-5'>ArkUI</b>-X基礎(chǔ)知識:【<b class='flag-5'>ArkUI</b>跨平臺設(shè)計(jì)總體說明】

    鴻蒙ArkUI-X跨平臺技術(shù):【開發(fā)準(zhǔn)備】

    本文檔適用于ArkUI跨平臺應(yīng)用開發(fā)的初學(xué)者。通過開發(fā)環(huán)境搭建、應(yīng)用工程創(chuàng)建、編譯和運(yùn)行,熟悉ArkUI跨平臺應(yīng)用開發(fā)基本流程。
    的頭像 發(fā)表于 05-24 10:40 ?379次閱讀
    鴻蒙<b class='flag-5'>ArkUI</b>-X跨平臺技術(shù):【<b class='flag-5'>開發(fā)</b>準(zhǔn)備】

    鴻蒙ArkUI-X框架開發(fā):【開發(fā)準(zhǔn)備】

    本文檔適用于ArkUI-X框架開發(fā)的初學(xué)者。通過環(huán)境搭建、代碼下載、代碼編譯、API擴(kuò)展和使用,快速了解跨平臺項(xiàng)目開發(fā)流程。
    的頭像 發(fā)表于 05-23 21:02 ?384次閱讀
    鴻蒙<b class='flag-5'>ArkUI</b>-X<b class='flag-5'>框架開發(fā)</b>:【<b class='flag-5'>開發(fā)</b>準(zhǔn)備】

    鴻蒙ArkUI-X跨平臺開發(fā):【bility開發(fā)說明(Android平臺)】

    本文介紹將ArkUI框架擴(kuò)展到Android平臺所需要的必要的類及其使用說明,開發(fā)者基于OpenHarmony,可復(fù)用大部分的應(yīng)用代碼(生命周期等)并可以部署到Android平臺,降低跨平臺應(yīng)用
    的頭像 發(fā)表于 05-21 10:54 ?828次閱讀
    鴻蒙<b class='flag-5'>ArkUI</b>-X跨平臺<b class='flag-5'>開發(fā)</b>:【bility<b class='flag-5'>開發(fā)</b>說明(Android平臺)】

    鴻蒙ArkUI-X跨平臺開發(fā):【SDK目錄結(jié)構(gòu)介紹】

    本文檔配套ArkUI-X,將OpenHarmony ArkUI開發(fā)框架擴(kuò)展到不同的OS平臺,比如Android和iOS平臺,讓開發(fā)者基于
    的頭像 發(fā)表于 05-20 16:28 ?735次閱讀
    鴻蒙<b class='flag-5'>ArkUI</b>-X跨平臺<b class='flag-5'>開發(fā)</b>:【SDK目錄結(jié)構(gòu)介紹】

    鴻蒙ArkUI-X跨平臺開發(fā):【 應(yīng)用工程結(jié)構(gòu)說明】

    本文檔配套ArkUI-X,將OpenHarmony ArkUI開發(fā)框架擴(kuò)展到不同的OS平臺,比如Android和iOS平臺,讓開發(fā)者基于
    的頭像 發(fā)表于 05-19 21:05 ?484次閱讀
    鴻蒙<b class='flag-5'>ArkUI</b>-X跨平臺<b class='flag-5'>開發(fā)</b>:【 應(yīng)用工程結(jié)構(gòu)說明】

    鴻蒙跨平臺框架:【ArkUi-X】創(chuàng)建工程

    鴻蒙推出了鴻ArkUi-X 框架所以就寫個(gè)文章分享一下
    的頭像 發(fā)表于 05-13 17:48 ?791次閱讀
    鴻蒙跨平臺<b class='flag-5'>框架</b>:【<b class='flag-5'>ArkUi</b>-X】創(chuàng)建工程

    鴻蒙ArkUI:【從代碼到UI顯示的整體渲染流程】

    方舟開發(fā)框架(簡稱ArkUI)是鴻蒙開發(fā)的UI框架,提供如下兩種開發(fā)范式,我們 **只學(xué)聲明式
    的頭像 發(fā)表于 05-13 16:06 ?727次閱讀
    鴻蒙<b class='flag-5'>ArkUI</b>:【從代碼到UI顯示的整體<b class='flag-5'>渲染</b>流程】

    鴻蒙開發(fā)學(xué)習(xí):初探【ArkUI-X】

    **簡單來說,ArkTS + ArkUI-X 對標(biāo)的框架為 flutter,一次代碼,編譯為 native 全平臺運(yùn)行**
    的頭像 發(fā)表于 05-13 15:58 ?922次閱讀
    鴻蒙<b class='flag-5'>開發(fā)</b>學(xué)習(xí):初探【<b class='flag-5'>ArkUI</b>-X】

    HarmonyOS實(shí)戰(zhàn)開發(fā)-合理選擇條件渲染和顯隱控制

    if/else條件渲染ArkUI應(yīng)用開發(fā)框架提供的渲染控制的能力之一。條件渲染可根據(jù)應(yīng)用的不
    發(fā)表于 05-10 15:16

    鴻蒙ArkUI開發(fā)學(xué)習(xí):【渲染控制語法】

    ArkUI開發(fā)框架是一套構(gòu)建 HarmonyOS / OpenHarmony 應(yīng)用界面的聲明式UI開發(fā)框架,它支持程序使用?`if/else
    的頭像 發(fā)表于 04-09 16:40 ?869次閱讀
    鴻蒙<b class='flag-5'>ArkUI</b><b class='flag-5'>開發(fā)</b>學(xué)習(xí):【<b class='flag-5'>渲染</b>控制語法】

    鴻蒙ArkUI開發(fā)-Tabs組件的使用

    鴻蒙ArkUI開發(fā)-Tabs組件的使用
    的頭像 發(fā)表于 01-19 16:01 ?1627次閱讀
    鴻蒙<b class='flag-5'>ArkUI</b><b class='flag-5'>開發(fā)</b>-Tabs組件的使用

    鴻蒙開發(fā)-ArkUI框架實(shí)戰(zhàn)【日歷應(yīng)用 】

    :eTS 關(guān)于eTS eTS語言:基于TypeScript(簡稱TS)拓展的出來的,是OpenHarmony應(yīng)用開發(fā)語言,使用ArkUI框架提供的組件進(jìn)行界面開發(fā)。 什么是TypeSc
    發(fā)表于 01-17 21:37