：Storage 存儲空間分析的設(shè)計與實現(xiàn))
HarmonyOS NEXT 實戰(zhàn)Storage 存儲空間分析的設(shè)計與實現(xiàn)前言存儲空間分析是文件管理應(yīng)用的高級能力幫助用戶直觀了解設(shè)備存儲占用情況并釋放空間。HarmonyExplorer 基于 HarmonyOS NEXT 的 Storage 統(tǒng)計能力實現(xiàn)了總?cè)萘拷y(tǒng)計、分類大小統(tǒng)計、大文件掃描與緩存清理的完整方案。存儲分析的核心難點在于掃描性能與數(shù)據(jù)可視化的平衡既要快速統(tǒng)計大量文件又要以直觀的圖表呈現(xiàn)。本文將完整拆解 StorageUtil 封裝、StorageChart 組件、掃描與清理的落地實踐。提示本文代碼基于 HarmonyOS NEXTAPI 12ArkTS 嚴格模式編寫禁用 any 類型與隱式斷言所有存儲數(shù)據(jù)均使用命名接口顯式聲明。一、存儲空間分析功能設(shè)計1.1 需求分析通過對用戶使用場景的調(diào)研HarmonyExplorer 的存儲分析模塊需要覆蓋以下能力點獲取設(shè)備總?cè)萘?、已用空間與可用空間按文件類型分類統(tǒng)計占用大小圖片、視頻、音頻、文檔等以圖表與進度條直觀展示存儲占比掃描大文件并支持快速定位清理一鍵清理應(yīng)用緩存釋放存儲空間1.2 架構(gòu)分層存儲分析功能遵循 UI → ViewModel → Repository → Service → KitManager → Kits 的分層架構(gòu)職責(zé)清晰。UI 層StoragePage 展示圖表與詳情列表Repository 層StorageRepository 聚合統(tǒng)計數(shù)據(jù)KitManager 層封裝 Storage Statistics KitUtils 層StorageUtil 提供純函數(shù)式工具方法提示存儲統(tǒng)計涉及大量文件遍歷建議在子線程或異步任務(wù)中執(zhí)行避免阻塞 UI 主線程導(dǎo)致卡頓。二、Storage Kit 獲取存儲信息2.1 API 概覽HarmonyOS NEXT 通過 storageStatistics 模塊提供存儲統(tǒng)計能力核心 API 包括獲取總?cè)萘俊⑹Ｓ嗫臻g與目錄統(tǒng)計。API 名稱作用返回數(shù)據(jù)getTotalSizeOfVolume獲取總?cè)萘孔止?jié)數(shù)getFreeSizeOfVolume獲取可用空間字節(jié)數(shù)getCurrentBundleStats獲取應(yīng)用占用BundleStatsgetUserStorageStats用戶存儲統(tǒng)計分類大小2.2 獲取存儲信息通過 storageStatistics 獲取設(shè)備存儲基礎(chǔ)信息封裝為統(tǒng)一的 StorageInfo 數(shù)據(jù)模型。// model/StorageModel.etsexportinterfaceStorageInfo{totalSize:numberfreeSize:numberusedSize:numberusedPercent:number}exportinterfaceCategorySize{category:stringsize:numberpercent:number}// manager/StorageKitManager.etsimport{storageStatistics}fromkit.CoreFileKitimport{StorageInfo}from../model/StorageModelexportclassStorageKitManager{staticasyncgetStorageInfo():PromiseStorageInfo{consttotal:numberawaitstorageStatistics.getTotalSizeOfVolume()constfree:numberawaitstorageStatistics.getFreeSizeOfVolume()constused:numbertotal-freeconstpercent:numbertotal0?Math.floor((used/total)*100):0return{totalSize:total,freeSize:free,usedSize:used,usedPercent:percent}}}三、存儲空間統(tǒng)計3.1 總量統(tǒng)計總量統(tǒng)計是存儲分析的基礎(chǔ)HarmonyExplorer 在 StoragePage 進入時即觸發(fā)統(tǒng)計結(jié)果綁定到 ViewModel。3.2 統(tǒng)計實現(xiàn)StorageViewModel 持有存儲狀態(tài)通過 StorageUtil 獲取數(shù)據(jù)并更新 UI 狀態(tài)。// viewmodel/StorageViewModel.etsimport{StorageUtil}from../utils/StorageUtilimport{StorageInfo,CategorySize}from../model/StorageModelObservedexportclassStorageViewModel{storageInfo:StorageInfo{totalSize:0,freeSize:0,usedSize:0,usedPercent:0}categoryList:CategorySize[][]isLoading:booleanfalseasyncloadStorageData():Promisevoid{this.isLoadingtruethis.storageInfoawaitStorageUtil.getStorageInfo()this.categoryListawaitStorageUtil.getCategorySizes()this.isLoadingfalse}}四、文件分類大小統(tǒng)計4.1 分類策略文件按業(yè)務(wù)類型分為五大類每類對應(yīng)不同的擴展名集合統(tǒng)計時遍歷文件目錄累計大小。分類包含類型統(tǒng)計來源圖片png/jpg/gif/webp圖片目錄視頻mp4/mov/avi視頻目錄音頻mp3/aac/flac音頻目錄文檔pdf/doc/txt文檔目錄其他其余類型沙箱目錄4.2 統(tǒng)計實現(xiàn)StorageUtil 遍歷各分類目錄累計文件大小返回分類統(tǒng)計列表。// utils/StorageUtil.etsimport{fileIo}fromkit.CoreFileKitimport{StorageKitManager}from../manager/StorageKitManagerimport{StorageInfo,CategorySize}from../model/StorageModelexportclassStorageUtil{staticreadonlyCATEGORY_MAP:Recordstring,string[]{圖片:[png,jpg,gif,webp],視頻:[mp4,mov,avi],音頻:[mp3,aac,flac],文檔:[pdf,doc,txt]}staticasyncgetCategorySizes():PromiseCategorySize[]{conststorageInfo:StorageInfoawaitStorageKitManager.getStorageInfo()consttotalUsed:numberstorageInfo.usedSizeconstresult:CategorySize[][]constcategories:string[]Object.keys(StorageUtil.CATEGORY_MAP)for(constcategoryofcategories){constsize:numberawaitStorageUtil.calcCategorySize(category)constpercent:numbertotalUsed0?Math.floor((size/totalUsed)*100):0result.push({category:category,size:size,percent:percent})}returnresult}staticasynccalcCategorySize(category:string):Promisenumber{constexts:string[]StorageUtil.CATEGORY_MAP[category]if(extsundefined){return0}lettotal:number0for(constextofexts){totaltotalawaitStorageUtil.scanByExt(ext)}returntotal}}五、StorageChart 圖表組件5.1 組件實現(xiàn)StorageChart 以環(huán)形圖展示各分類占用比例直觀的可視化是存儲分析的核心價值讓用戶一眼看清空間分布。// components/StorageChart.etsComponentexportstruct StorageChart{Propcategories:CategorySize[]privatecolors:string[][#007DFF,#FF6B6B,#4ECDC4,#FFE66D,#95A5A6]build(){Column({space:12}){Text(存儲占用分布).fontSize(16).fontWeight(FontWeight.Medium)Stack(){ForEach(this.categories,(item:CategorySize,index:number){Progress({value:item.percent,total:100,type:ProgressType.Ring}).width(120).height(120).color(this.colors[index%this.colors.length])},(item:CategorySize)item.category)}ForEach(this.categories,(item:CategorySize,index:number){Row({space:8}){Circle({width:10,height:10}).fill(this.colors[index%this.colors.length])Text(item.category item.percent.toString()%).fontSize(12)}},(item:CategorySize)item.category)}.width(100%).padding(16)}}六、ProgressBar 進度條展示6.1 進度展示除環(huán)形圖外HarmonyExplorer 還使用線性 ProgressBar 展示總存儲使用率配合數(shù)字提示形成雙重反饋。// components/StorageOverview.etsComponentexportstruct StorageOverview{ObjectLinkviewModel:StorageViewModelbuild(){Column({space:12}){Row({space:8}){Text(已用 StorageUtil.formatSize(this.viewModel.storageInfo.usedSize)).fontSize(14).layoutWeight(1)Text(總共 StorageUtil.formatSize(this.viewModel.storageInfo.totalSize)).fontSize(14).fontColor(#999999)}Progress({value:this.viewModel.storageInfo.usedPercent,total:100,type:ProgressType.Linear}).width(100%).color(#007DFF)Text(使用率 this.viewModel.storageInfo.usedPercent.toString()%).fontSize(12).fontColor(#666666)}.width(100%).padding(16)}}StorageUtil 的格式化方法將字節(jié)數(shù)轉(zhuǎn)換為易讀的單位// utils/StorageUtil.etsexportclassStorageUtil{staticformatSize(bytes:number):string{if(bytes1024){returnbytes.toString() B}if(bytes1024*1024){return(bytes/1024).toFixed(1) KB}if(bytes1024*1024*1024){return(bytes/(1024*1024)).toFixed(1) MB}return(bytes/(1024*1024*1024)).toFixed(2) GB}}七、存儲詳情列表7.1 列表實現(xiàn)存儲詳情列表展示各分類的具體占用每項包含分類名、大小與占比點擊可進入分類文件列表。// components/StorageDetailList.etsComponentexportstruct StorageDetailList{Proplist:CategorySize[]onItemClick:(category:string)void(){}build(){List({space:8}){ForEach(this.list,(item:CategorySize){ListItem(){Row({space:12}){Text(item.category).fontSize(14).layoutWeight(1)Text(StorageUtil.formatSize(item.size)).fontSize(14).fontColor(#666666)Text(item.percent.toString()%).fontSize(12).fontColor(#999999)}.width(100%).padding(12).backgroundColor(#FFFFFF).borderRadius(12)}.onClick(()this.onItemClick(item.category))},(item:CategorySize)item.category)}.width(100%).layoutWeight(1)}}八、大文件掃描8.1 掃描實現(xiàn)大文件掃描按文件大小閾值篩選幫助用戶快速定位占用空間最大的文件。大文件掃描是釋放存儲空間最直接有效的手段。// utils/StorageUtil.etsimport{FileInfo}from../model/FileInfoexportclassStorageUtil{staticasyncscanLargeFiles(dirPath:string,threshold:number):PromiseFileInfo[]{constresult:FileInfo[][]if(!fileIo.accessSync(dirPath)){returnresult}constnames:string[]fileIo.listFileSync(dirPath)for(constnameofnames){constfullPath:stringdirPath/nameconststat:fileIo.StatfileIo.statSync(fullPath)if(stat.isDirectory()){constsub:FileInfo[]awaitStorageUtil.scanLargeFiles(fullPath,threshold)for(constfofsub){result.push(f)}}elseif(stat.sizethreshold){result.push({id:fullPath,name:name,path:fullPath,size:stat.size,type:StorageUtil.getExt(name),modifyTime:stat.mtime,createTime:stat.mtime,favorite:false})}}returnresult}staticgetExt(name:string):string{constdotIndex:numbername.lastIndexOf(.)returndotIndex0?name.substring(dotIndex1):}}九、緩存清理功能9.1 清理實現(xiàn)緩存清理針對應(yīng)用臨時目錄與緩存目錄一鍵清空非必要文件釋放存儲空間。清理前先統(tǒng)計可清理大小確認后執(zhí)行。完整清理流程如下調(diào)用 calcCacheSize 遍歷緩存目錄并統(tǒng)計可清理的文件總大小彈出 ConfirmDialog 展示可釋放空間并等待用戶確認清理操作用戶確認后調(diào)用 cleanCache 執(zhí)行清理并刷新存儲統(tǒng)計數(shù)據(jù)// utils/StorageUtil.etsexportclassStorageUtil{staticasynccleanCache(cacheDir:string):Promisenumber{letcleaned:number0if(!fileIo.accessSync(cacheDir)){return0}constnames:string[]fileIo.listFileSync(cacheDir)for(constnameofnames){constfullPath:stringcacheDir/nameconststat:fileIo.StatfileIo.statSync(fullPath)if(stat.isDirectory()){fileIo.rmdirSync(fullPath)}else{cleanedcleanedstat.size fileIo.unlinkSync(fullPath)}}returncleaned}staticasynccalcCacheSize(cacheDir:string):Promisenumber{lettotal:number0if(!fileIo.accessSync(cacheDir)){return0}constnames:string[]fileIo.listFileSync(cacheDir)for(constnameofnames){conststat:fileIo.StatfileIo.statSync(cacheDir/name)totaltotalstat.size}returntotal}}提示緩存清理要避免誤刪用戶數(shù)據(jù)建議只清理明確的臨時目錄并在清理前彈出 ConfirmDialog 二次確認。十、StorageUtil 工具類封裝10.1 完整封裝StorageUtil 整合存儲信息獲取、分類統(tǒng)計、大文件掃描與緩存清理對外提供統(tǒng)一入口。// utils/StorageUtil.etsimport{fileIo}fromkit.CoreFileKitimport{StorageKitManager}from../manager/StorageKitManagerimport{StorageInfo,CategorySize,FileInfo}from../model/StorageModelexportclassStorageUtil{staticasyncgetStorageInfo():PromiseStorageInfo{returnawaitStorageKitManager.getStorageInfo()}staticasyncgetLargeFiles(dirPath:string):PromiseFileInfo[]{constthreshold:number100*1024*1024returnawaitStorageUtil.scanLargeFiles(dirPath,threshold)}}各存儲操作的能力與閾值如下表便于運維與擴展時統(tǒng)一調(diào)整操作閾值/范圍觸發(fā)方式總量統(tǒng)計全設(shè)備進入頁面自動分類統(tǒng)計五大類進入頁面自動大文件掃描≥100MB用戶手動觸發(fā)緩存清理緩存目錄用戶確認后執(zhí)行總結(jié)本文完整實現(xiàn)了 HarmonyExplorer 的存儲空間分析模塊涵蓋 Storage Kit 調(diào)用、總量與分類統(tǒng)計、StorageChart 圖表、大文件掃描與緩存清理。分層架構(gòu)讓存儲邏輯清晰可測試圖表與進度條的雙重可視化大幅提升了數(shù)據(jù)可讀性。大文件掃描與緩存清理也為用戶釋放空間提供了實用工具。希望這套方案能幫助你在鴻蒙項目中落地存儲分析能力。如果這篇文章對你有幫助歡迎點贊、收藏?、關(guān)注你的支持是我持續(xù)創(chuàng)作的動力相關(guān)資源HarmonyOS 存儲統(tǒng)計開發(fā)指南Core File Kit 文檔ArkTS 語法規(guī)范Stage Model 開發(fā)模型ArkUI 狀態(tài)管理HarmonyExplorer 項目架構(gòu)CSDN 鴻蒙社區(qū)ArkUI 組件參考 HarmonyOS NEXT 實戰(zhàn)：Storage 存儲空間分析的設(shè)計與實現(xiàn)
HarmonyOS NEXT 實戰(zhàn)Storage 存儲空間分析的設(shè)計與實現(xiàn)前言存儲空間分析是文件管理應(yīng)用的高級能力幫助用戶直觀了解設(shè)備存儲占用情況并釋放空間。HarmonyExplorer 基于 HarmonyOS NEXT 的 Storage 統(tǒng)計能力實現(xiàn)了總?cè)萘拷y(tǒng)計、分類大小統(tǒng)計、大文件掃描與緩存清理的完整方案。存儲分析的核心難點在于掃描性能與數(shù)據(jù)可視化的平衡既要快速統(tǒng)計大量文件又要以直觀的圖表呈現(xiàn)。本文將完整拆解 StorageUtil 封裝、StorageChart 組件、掃描與清理的落地實踐。提示本文代碼基于 HarmonyOS NEXTAPI 12ArkTS 嚴格模式編寫禁用 any 類型與隱式斷言所有存儲數(shù)據(jù)均使用命名接口顯式聲明。一、存儲空間分析功能設(shè)計1.1 需求分析通過對用戶使用場景的調(diào)研HarmonyExplorer 的存儲分析模塊需要覆蓋以下能力點獲取設(shè)備總?cè)萘?、已用空間與可用空間按文件類型分類統(tǒng)計占用大小圖片、視頻、音頻、文檔等以圖表與進度條直觀展示存儲占比掃描大文件并支持快速定位清理一鍵清理應(yīng)用緩存釋放存儲空間1.2 架構(gòu)分層存儲分析功能遵循 UI → ViewModel → Repository → Service → KitManager → Kits 的分層架構(gòu)職責(zé)清晰。UI 層StoragePage 展示圖表與詳情列表Repository 層StorageRepository 聚合統(tǒng)計數(shù)據(jù)KitManager 層封裝 Storage Statistics KitUtils 層StorageUtil 提供純函數(shù)式工具方法提示存儲統(tǒng)計涉及大量文件遍歷建議在子線程或異步任務(wù)中執(zhí)行避免阻塞 UI 主線程導(dǎo)致卡頓。二、Storage Kit 獲取存儲信息2.1 API 概覽HarmonyOS NEXT 通過 storageStatistics 模塊提供存儲統(tǒng)計能力核心 API 包括獲取總?cè)萘俊⑹Ｓ嗫臻g與目錄統(tǒng)計。API 名稱作用返回數(shù)據(jù)getTotalSizeOfVolume獲取總?cè)萘孔止?jié)數(shù)getFreeSizeOfVolume獲取可用空間字節(jié)數(shù)getCurrentBundleStats獲取應(yīng)用占用BundleStatsgetUserStorageStats用戶存儲統(tǒng)計分類大小2.2 獲取存儲信息通過 storageStatistics 獲取設(shè)備存儲基礎(chǔ)信息封裝為統(tǒng)一的 StorageInfo 數(shù)據(jù)模型。// model/StorageModel.etsexportinterfaceStorageInfo{totalSize:numberfreeSize:numberusedSize:numberusedPercent:number}exportinterfaceCategorySize{category:stringsize:numberpercent:number}// manager/StorageKitManager.etsimport{storageStatistics}fromkit.CoreFileKitimport{StorageInfo}from../model/StorageModelexportclassStorageKitManager{staticasyncgetStorageInfo():PromiseStorageInfo{consttotal:numberawaitstorageStatistics.getTotalSizeOfVolume()constfree:numberawaitstorageStatistics.getFreeSizeOfVolume()constused:numbertotal-freeconstpercent:numbertotal0?Math.floor((used/total)*100):0return{totalSize:total,freeSize:free,usedSize:used,usedPercent:percent}}}三、存儲空間統(tǒng)計3.1 總量統(tǒng)計總量統(tǒng)計是存儲分析的基礎(chǔ)HarmonyExplorer 在 StoragePage 進入時即觸發(fā)統(tǒng)計結(jié)果綁定到 ViewModel。3.2 統(tǒng)計實現(xiàn)StorageViewModel 持有存儲狀態(tài)通過 StorageUtil 獲取數(shù)據(jù)并更新 UI 狀態(tài)。// viewmodel/StorageViewModel.etsimport{StorageUtil}from../utils/StorageUtilimport{StorageInfo,CategorySize}from../model/StorageModelObservedexportclassStorageViewModel{storageInfo:StorageInfo{totalSize:0,freeSize:0,usedSize:0,usedPercent:0}categoryList:CategorySize[][]isLoading:booleanfalseasyncloadStorageData():Promisevoid{this.isLoadingtruethis.storageInfoawaitStorageUtil.getStorageInfo()this.categoryListawaitStorageUtil.getCategorySizes()this.isLoadingfalse}}四、文件分類大小統(tǒng)計4.1 分類策略文件按業(yè)務(wù)類型分為五大類每類對應(yīng)不同的擴展名集合統(tǒng)計時遍歷文件目錄累計大小。分類包含類型統(tǒng)計來源圖片png/jpg/gif/webp圖片目錄視頻mp4/mov/avi視頻目錄音頻mp3/aac/flac音頻目錄文檔pdf/doc/txt文檔目錄其他其余類型沙箱目錄4.2 統(tǒng)計實現(xiàn)StorageUtil 遍歷各分類目錄累計文件大小返回分類統(tǒng)計列表。// utils/StorageUtil.etsimport{fileIo}fromkit.CoreFileKitimport{StorageKitManager}from../manager/StorageKitManagerimport{StorageInfo,CategorySize}from../model/StorageModelexportclassStorageUtil{staticreadonlyCATEGORY_MAP:Recordstring,string[]{圖片:[png,jpg,gif,webp],視頻:[mp4,mov,avi],音頻:[mp3,aac,flac],文檔:[pdf,doc,txt]}staticasyncgetCategorySizes():PromiseCategorySize[]{conststorageInfo:StorageInfoawaitStorageKitManager.getStorageInfo()consttotalUsed:numberstorageInfo.usedSizeconstresult:CategorySize[][]constcategories:string[]Object.keys(StorageUtil.CATEGORY_MAP)for(constcategoryofcategories){constsize:numberawaitStorageUtil.calcCategorySize(category)constpercent:numbertotalUsed0?Math.floor((size/totalUsed)*100):0result.push({category:category,size:size,percent:percent})}returnresult}staticasynccalcCategorySize(category:string):Promisenumber{constexts:string[]StorageUtil.CATEGORY_MAP[category]if(extsundefined){return0}lettotal:number0for(constextofexts){totaltotalawaitStorageUtil.scanByExt(ext)}returntotal}}五、StorageChart 圖表組件5.1 組件實現(xiàn)StorageChart 以環(huán)形圖展示各分類占用比例直觀的可視化是存儲分析的核心價值讓用戶一眼看清空間分布。// components/StorageChart.etsComponentexportstruct StorageChart{Propcategories:CategorySize[]privatecolors:string[][#007DFF,#FF6B6B,#4ECDC4,#FFE66D,#95A5A6]build(){Column({space:12}){Text(存儲占用分布).fontSize(16).fontWeight(FontWeight.Medium)Stack(){ForEach(this.categories,(item:CategorySize,index:number){Progress({value:item.percent,total:100,type:ProgressType.Ring}).width(120).height(120).color(this.colors[index%this.colors.length])},(item:CategorySize)item.category)}ForEach(this.categories,(item:CategorySize,index:number){Row({space:8}){Circle({width:10,height:10}).fill(this.colors[index%this.colors.length])Text(item.category item.percent.toString()%).fontSize(12)}},(item:CategorySize)item.category)}.width(100%).padding(16)}}六、ProgressBar 進度條展示6.1 進度展示除環(huán)形圖外HarmonyExplorer 還使用線性 ProgressBar 展示總存儲使用率配合數(shù)字提示形成雙重反饋。// components/StorageOverview.etsComponentexportstruct StorageOverview{ObjectLinkviewModel:StorageViewModelbuild(){Column({space:12}){Row({space:8}){Text(已用 StorageUtil.formatSize(this.viewModel.storageInfo.usedSize)).fontSize(14).layoutWeight(1)Text(總共 StorageUtil.formatSize(this.viewModel.storageInfo.totalSize)).fontSize(14).fontColor(#999999)}Progress({value:this.viewModel.storageInfo.usedPercent,total:100,type:ProgressType.Linear}).width(100%).color(#007DFF)Text(使用率 this.viewModel.storageInfo.usedPercent.toString()%).fontSize(12).fontColor(#666666)}.width(100%).padding(16)}}StorageUtil 的格式化方法將字節(jié)數(shù)轉(zhuǎn)換為易讀的單位// utils/StorageUtil.etsexportclassStorageUtil{staticformatSize(bytes:number):string{if(bytes1024){returnbytes.toString() B}if(bytes1024*1024){return(bytes/1024).toFixed(1) KB}if(bytes1024*1024*1024){return(bytes/(1024*1024)).toFixed(1) MB}return(bytes/(1024*1024*1024)).toFixed(2) GB}}七、存儲詳情列表7.1 列表實現(xiàn)存儲詳情列表展示各分類的具體占用每項包含分類名、大小與占比點擊可進入分類文件列表。// components/StorageDetailList.etsComponentexportstruct StorageDetailList{Proplist:CategorySize[]onItemClick:(category:string)void(){}build(){List({space:8}){ForEach(this.list,(item:CategorySize){ListItem(){Row({space:12}){Text(item.category).fontSize(14).layoutWeight(1)Text(StorageUtil.formatSize(item.size)).fontSize(14).fontColor(#666666)Text(item.percent.toString()%).fontSize(12).fontColor(#999999)}.width(100%).padding(12).backgroundColor(#FFFFFF).borderRadius(12)}.onClick(()this.onItemClick(item.category))},(item:CategorySize)item.category)}.width(100%).layoutWeight(1)}}八、大文件掃描8.1 掃描實現(xiàn)大文件掃描按文件大小閾值篩選幫助用戶快速定位占用空間最大的文件。大文件掃描是釋放存儲空間最直接有效的手段。// utils/StorageUtil.etsimport{FileInfo}from../model/FileInfoexportclassStorageUtil{staticasyncscanLargeFiles(dirPath:string,threshold:number):PromiseFileInfo[]{constresult:FileInfo[][]if(!fileIo.accessSync(dirPath)){returnresult}constnames:string[]fileIo.listFileSync(dirPath)for(constnameofnames){constfullPath:stringdirPath/nameconststat:fileIo.StatfileIo.statSync(fullPath)if(stat.isDirectory()){constsub:FileInfo[]awaitStorageUtil.scanLargeFiles(fullPath,threshold)for(constfofsub){result.push(f)}}elseif(stat.sizethreshold){result.push({id:fullPath,name:name,path:fullPath,size:stat.size,type:StorageUtil.getExt(name),modifyTime:stat.mtime,createTime:stat.mtime,favorite:false})}}returnresult}staticgetExt(name:string):string{constdotIndex:numbername.lastIndexOf(.)returndotIndex0?name.substring(dotIndex1):}}九、緩存清理功能9.1 清理實現(xiàn)緩存清理針對應(yīng)用臨時目錄與緩存目錄一鍵清空非必要文件釋放存儲空間。清理前先統(tǒng)計可清理大小確認后執(zhí)行。完整清理流程如下調(diào)用 calcCacheSize 遍歷緩存目錄并統(tǒng)計可清理的文件總大小彈出 ConfirmDialog 展示可釋放空間并等待用戶確認清理操作用戶確認后調(diào)用 cleanCache 執(zhí)行清理并刷新存儲統(tǒng)計數(shù)據(jù)// utils/StorageUtil.etsexportclassStorageUtil{staticasynccleanCache(cacheDir:string):Promisenumber{letcleaned:number0if(!fileIo.accessSync(cacheDir)){return0}constnames:string[]fileIo.listFileSync(cacheDir)for(constnameofnames){constfullPath:stringcacheDir/nameconststat:fileIo.StatfileIo.statSync(fullPath)if(stat.isDirectory()){fileIo.rmdirSync(fullPath)}else{cleanedcleanedstat.size fileIo.unlinkSync(fullPath)}}returncleaned}staticasynccalcCacheSize(cacheDir:string):Promisenumber{lettotal:number0if(!fileIo.accessSync(cacheDir)){return0}constnames:string[]fileIo.listFileSync(cacheDir)for(constnameofnames){conststat:fileIo.StatfileIo.statSync(cacheDir/name)totaltotalstat.size}returntotal}}提示緩存清理要避免誤刪用戶數(shù)據(jù)建議只清理明確的臨時目錄并在清理前彈出 ConfirmDialog 二次確認。十、StorageUtil 工具類封裝10.1 完整封裝StorageUtil 整合存儲信息獲取、分類統(tǒng)計、大文件掃描與緩存清理對外提供統(tǒng)一入口。// utils/StorageUtil.etsimport{fileIo}fromkit.CoreFileKitimport{StorageKitManager}from../manager/StorageKitManagerimport{StorageInfo,CategorySize,FileInfo}from../model/StorageModelexportclassStorageUtil{staticasyncgetStorageInfo():PromiseStorageInfo{returnawaitStorageKitManager.getStorageInfo()}staticasyncgetLargeFiles(dirPath:string):PromiseFileInfo[]{constthreshold:number100*1024*1024returnawaitStorageUtil.scanLargeFiles(dirPath,threshold)}}各存儲操作的能力與閾值如下表便于運維與擴展時統(tǒng)一調(diào)整操作閾值/范圍觸發(fā)方式總量統(tǒng)計全設(shè)備進入頁面自動分類統(tǒng)計五大類進入頁面自動大文件掃描≥100MB用戶手動觸發(fā)緩存清理緩存目錄用戶確認后執(zhí)行總結(jié)本文完整實現(xiàn)了 HarmonyExplorer 的存儲空間分析模塊涵蓋 Storage Kit 調(diào)用、總量與分類統(tǒng)計、StorageChart 圖表、大文件掃描與緩存清理。分層架構(gòu)讓存儲邏輯清晰可測試圖表與進度條的雙重可視化大幅提升了數(shù)據(jù)可讀性。大文件掃描與緩存清理也為用戶釋放空間提供了實用工具。希望這套方案能幫助你在鴻蒙項目中落地存儲分析能力。如果這篇文章對你有幫助歡迎點贊、收藏?、關(guān)注你的支持是我持續(xù)創(chuàng)作的動力相關(guān)資源HarmonyOS 存儲統(tǒng)計開發(fā)指南Core File Kit 文檔ArkTS 語法規(guī)范Stage Model 開發(fā)模型ArkUI 狀態(tài)管理HarmonyExplorer 項目架構(gòu)CSDN 鴻蒙社區(qū)ArkUI 組件參考