文章目錄每日一句正能量一、前言資源文件是包體積的沉默殺手二、HarmonyOS 資源文件體系概覽2.1 資源分類與訪問方式2.2 資源限定詞匹配優(yōu)先級(jí)三、圖片資源優(yōu)化格式選型是第一步3.1 各圖片格式特性對(duì)比3.2 圖片格式選型實(shí)戰(zhàn)3.3 批量轉(zhuǎn)換腳本3.4 紋理壓縮高頻渲染場(chǎng)景的終極武器四、字體文件優(yōu)化從全量引入到按需加載4.1 字體優(yōu)化策略五、音頻資源優(yōu)化壓縮與格式選擇5.1 音頻格式選型5.2 音頻壓縮實(shí)戰(zhàn)5.3 音頻資源上云六、rawfile 治理容易被忽視的體積黑洞6.1 rawfile 使用規(guī)范6.2 HarmonyOS 6 新增 rawfile 壓縮6.3 大文件遷移方案七、冗余資源清理ShrinkResources 與手動(dòng)檢測(cè)7.1 啟用自動(dòng)資源收縮7.2 手動(dòng)冗余資源檢測(cè)腳本八、資源優(yōu)化工具鏈與自動(dòng)化流程8.1 設(shè)計(jì)階段規(guī)范8.2 CI/CD 集成九、實(shí)戰(zhàn)案例資源文件優(yōu)化前后對(duì)比十、總結(jié)與最佳實(shí)踐每日一句正能量位置不同不爭(zhēng)認(rèn)知不同不辯三觀不合不言。不爭(zhēng)是位置不同時(shí)的從容不辯是認(rèn)知不同時(shí)的清醒不言是三觀不合時(shí)的自重。不與他人糾纏不是軟弱而是清醒。把精力留給值得的人和事是成年人最珍貴的自覺。一、前言資源文件是包體積的沉默殺手在 HarmonyOS 應(yīng)用開發(fā)中資源文件圖片、字體、音頻、配置文件等往往占據(jù)應(yīng)用包體積的40%~60%。與代碼不同資源文件的體積增長(zhǎng)是靜默的——設(shè)計(jì)師交付一張新的 Banner 圖、產(chǎn)品經(jīng)理要求增加一套主題皮膚、運(yùn)營(yíng)同事上傳一段引導(dǎo)視頻這些看似微不足道的操作日積月累便會(huì)讓應(yīng)用包膨脹到用戶難以接受的規(guī)模。更棘手的是資源文件的優(yōu)化涉及多個(gè)維度格式選型、分辨率適配、壓縮策略、冗余清理、動(dòng)態(tài)加載等。每個(gè)維度都有獨(dú)立的決策邏輯且相互之間存在耦合關(guān)系。例如將 PNG 轉(zhuǎn)為 WebP 可以減小體積但如果同時(shí)存在多套密度資源優(yōu)化效果會(huì)被重復(fù)拷貝抵消使用 SVG 可以無限縮放但復(fù)雜路徑的 SVG 在運(yùn)行時(shí)渲染性能反而不如位圖。本文將從資源分類與格式選型出發(fā)系統(tǒng)講解 HarmonyOS 資源文件的優(yōu)化方法論涵蓋圖片壓縮、矢量圖應(yīng)用、紋理壓縮、字體優(yōu)化、音頻壓縮、rawfile 治理、冗余資源清理等七大方向并提供可直接落地的代碼示例和 CI/CD 自動(dòng)化方案。二、HarmonyOS 資源文件體系概覽2.1 資源分類與訪問方式HarmonyOS 的資源文件按照用途和訪問方式分為兩大類資源類型訪問方式編譯行為適用場(chǎng)景Resource$r(app.type.name)編譯時(shí)生成索引支持限定詞匹配圖片、字符串、顏色、尺寸等Rawfile$rawfile(path/file.ext)原樣打包不參與編譯配置文件、字體、模板、大文件Resource 資源支持限定詞匹配機(jī)制系統(tǒng)會(huì)根據(jù)設(shè)備的語(yǔ)言、屏幕密度、方向、深色模式等條件自動(dòng)選擇最合適的資源版本。這一機(jī)制雖然提升了用戶體驗(yàn)但也引入了資源冗余的風(fēng)險(xiǎn)——如果開發(fā)者在每個(gè)限定詞目錄下都放置了完整的資源副本包體積將成倍增長(zhǎng)。2.2 資源限定詞匹配優(yōu)先級(jí)HarmonyOS 的資源限定詞匹配遵循嚴(yán)格的優(yōu)先級(jí)順序從高到低語(yǔ)言區(qū)域如zh_CN、en_US屏幕密度如sdpi、mdpi、ldpi、xldpi、xxldpi屏幕方向如horizontal、vertical深色模式如dark、light回退 base默認(rèn)資源兜底關(guān)鍵原則只在確實(shí)需要差異化適配的限定詞目錄下放置資源其他情況統(tǒng)一放在base目錄。HarmonyOS 的資源回退機(jī)制會(huì)自動(dòng)在base目錄查找缺失的資源無需在每個(gè)目錄下重復(fù)放置。三、圖片資源優(yōu)化格式選型是第一步圖片資源通常是應(yīng)用包中體積最大的部分優(yōu)化圖片是資源治理的重中之重。HarmonyOS 支持多種圖片格式每種格式都有其適用場(chǎng)景和壓縮特性。3.1 各圖片格式特性對(duì)比格式透明通道有損/無損相對(duì)PNG體積HarmonyOS兼容性推薦場(chǎng)景PNG支持無損100%基準(zhǔn)API 9需要精確像素的UI圖JPEG不支持有損35%API 9照片、復(fù)雜色彩圖WebP支持有損/無損25%~55%API 9通用首選AVIF支持有損/無損20%API 12HarmonyOS 6 推薦SVG支持矢量3%API 9圖標(biāo)、簡(jiǎn)單矢量圖GIF支持無損低壓縮API 9簡(jiǎn)單動(dòng)圖不推薦從數(shù)據(jù)可以看出在相同視覺質(zhì)量下WebP 有損格式的體積僅為 PNG 的25%而AVIFHarmonyOS 6/API 12 原生支持更是只有 PNG 的20%。對(duì)于圖標(biāo)類資源SVG的體積優(yōu)勢(shì)極為明顯——一個(gè) 48x48 的圖標(biāo)SVG 通常不足 5KB而同等尺寸的 PNG 可能需要 20~50KB。3.2 圖片格式選型實(shí)戰(zhàn)場(chǎng)景一工具欄圖標(biāo)24x24 ~ 48x48// 推薦SVG 矢量格式// 文件resources/base/media/ic_home.svgImage($r(app.media.ic_home)).width(24).height(24).fillColor(#1890FF)// SVG 支持動(dòng)態(tài)著色// 不推薦PNG 位圖// 需要為每種密度準(zhǔn)備獨(dú)立文件體積大且無法動(dòng)態(tài)變色場(chǎng)景二啟動(dòng)頁(yè)背景1920x1080// 推薦WebP 有損格式質(zhì)量 80// 文件resources/base/media/bg_splash.webpImage($r(app.media.bg_splash)).width(100%).height(100%).objectFit(ImageFit.Cover)// 原始 PNG 2.8MB → WebP 1.2MB減少 57%// HarmonyOS 6 可進(jìn)一步使用 AVIF1.2MB → 0.95MB再減 21%場(chǎng)景三商品詳情圖800x800需要透明背景// 推薦WebP 無損Alpha 替代 PNG// 原始 PNG 0.85MB → WebP 無損 0.45MB減少 47%Image($r(app.media.product_detail)).width(300).height(300).objectFit(ImageFit.Contain)3.3 批量轉(zhuǎn)換腳本#!/bin/bash# convert_to_webp.sh - 批量將 PNG/JPG 轉(zhuǎn)為 WebPRESOURCE_DIRentry/src/main/resources/base/mediaQUALITY80forfilein$RESOURCE_DIR/*.{png,jpg,jpeg};do[-e$file]||continuefilename$(basename$file)name${filename%.*}# 判斷是否需要透明通道iffile$file|grep-qRGBA;then# 需要透明使用 WebP 無損cwebp-lossless$file-o$RESOURCE_DIR/${name}.webpecho[無損]$filename→${name}.webpelse# 不需要透明使用 WebP 有損cwebp-q$QUALITY$file-o$RESOURCE_DIR/${name}.webpecho[有損]$filename→${name}.webp (q$QUALITY)fi# 刪除原文件確認(rèn)轉(zhuǎn)換成功后if[-f$RESOURCE_DIR/${name}.webp];thenrm$filefidoneecho轉(zhuǎn)換完成3.4 紋理壓縮高頻渲染場(chǎng)景的終極武器對(duì)于游戲、相冊(cè)、電商等需要高頻渲染大量圖片的場(chǎng)景HarmonyOS 提供了紋理壓縮技術(shù)。紋理壓縮在編譯構(gòu)建階段將圖片預(yù)轉(zhuǎn)換為 GPU 可直接讀取的紋理格式SUT/ASTC避免運(yùn)行時(shí)的 CPU 解碼開銷。// build-profile.json5 - 紋理壓縮配置 { apiType: stageMode, buildOption: { resOptions: { compression: { media: { enable: true }, filters: [ { method: { type: sut, blocks: 4x4 }, files: { path: [./**/*], size: [[0, 1000k]], resolution: [ [ { width: 0, height: 0 }, { width: 3000, height: 3000 } ] ] }, exclude: { path: [./**/*.webp], size: [[0, 1k]] } } ] } } } }注意事項(xiàng)紋理壓縮會(huì)增加編譯時(shí)間且對(duì).jpg和.webp格式的圖片可能導(dǎo)致包體積膨脹膨脹率約 2~3 倍。建議僅對(duì).png格式圖片啟用紋理壓縮或?qū)Πw積不敏感的性能敏感場(chǎng)景使用。四、字體文件優(yōu)化從全量引入到按需加載自定義字體文件是另一個(gè)容易被忽視的體積大戶。一套中文字體如思源黑體的 TTF 文件通常有8~15MB如果直接放入rawfile目錄將直接增加同等的包體積。4.1 字體優(yōu)化策略策略一優(yōu)先使用系統(tǒng)字體HarmonyOS 內(nèi)置了 HarmonyOS Sans 字體族覆蓋中文、英文、數(shù)字等全量字符無需額外引入// 直接使用系統(tǒng)默認(rèn)字體Text(歡迎使用 HarmonyOS).fontFamily(HarmonyOS Sans)// 系統(tǒng)自帶零體積成本.fontSize(16).fontWeight(FontWeight.Medium)策略二字體子集化Subsetting如果必須使用自定義字體可以通過字體子集化工具僅保留應(yīng)用實(shí)際使用的字符# 使用 pyftsubset 提取子集pipinstallfonttools# 提取僅包含常用漢字的子集約 3500 字pyftsubset CustomFont.ttf\--text-fileused_chars.txt\--output-fileCustomFont_subset.ttf\--layout-features*\--glyph-names\--symbol-cmap\--legacy-cmap\--notdef-glyph\--notdef-outline\--recommended-glyphs\--name-IDs*\--obfuscate-names# 原始 12MB → 子集化后 1.2MB減少 90%策略三HSP 動(dòng)態(tài)加載字體將字體文件放入 HSP 動(dòng)態(tài)共享包按需下載加載// 動(dòng)態(tài)加載 HSP 中的字體asyncfunctionloadCustomFont(){constfontModuleawaitimport(myapp/fonts);constfontPathfontModule.getFontPath(custom_font);// 注冊(cè)字體font.registerFont({familyName:CustomFont,familySrc:fontPath});}五、音頻資源優(yōu)化壓縮與格式選擇音頻文件提示音、背景音樂、語(yǔ)音播報(bào)等雖然數(shù)量不多但單個(gè)體積往往很大。一段 30 秒的未壓縮 WAV 音頻可達(dá)5MB即使 MP3 壓縮后也可能有500KB。5.1 音頻格式選型格式壓縮率音質(zhì)適用場(chǎng)景MP3中較好背景音樂、長(zhǎng)音頻AAC高好語(yǔ)音播報(bào)、提示音推薦OPUS極高好實(shí)時(shí)語(yǔ)音、網(wǎng)絡(luò)傳輸WAV無無損短提示音不推薦大文件5.2 音頻壓縮實(shí)戰(zhàn)# 使用 ffmpeg 批量壓縮音頻# 背景音樂128kbps AACffmpeg-ibg_music.wav-c:aaac-b:a128k bg_music.m4a# 提示音64kbps AAC單聲道ffmpeg-inotification.wav-c:aaac-b:a64k-ac1notification.m4a# 語(yǔ)音播報(bào)48kbps AAC單聲道語(yǔ)音優(yōu)化ffmpeg-ivoice_guide.wav-c:aaac-b:a48k-ac1-ar22050voice_guide.m4a5.3 音頻資源上云對(duì)于長(zhǎng)背景音樂30秒建議不打包進(jìn) HAP而是通過服務(wù)端下發(fā)或 HSP 按需加載// 從網(wǎng)絡(luò)加載音頻import{audio}fromkit.AudioKit;asyncfunctionplayRemoteAudio(url:string){constavPlayerawaitaudio.createAVPlayer();awaitavPlayer.setSource(url);awaitavPlayer.prepare();avPlayer.play();}六、rawfile 治理容易被忽視的體積黑洞rawfile目錄中的文件會(huì)被原封不動(dòng)地打包進(jìn) HAP不參與任何編譯優(yōu)化。這意味著放入rawfile的 JSON 配置文件不會(huì)被壓縮放入rawfile的字體文件體積完全保留放入rawfile的視頻/音頻文件直接增加包體積6.1 rawfile 使用規(guī)范? 錯(cuò)誤用法 resources/rawfile/ ├── large_dataset.json (4.2MB - 大JSON數(shù)據(jù)) ├── intro_video.mp4 (18.3MB - 引導(dǎo)視頻) ├── full_font.ttf (8.6MB - 完整字體) └── config_backup.xml (未使用的備份配置) ? 正確用法 resources/rawfile/ ├── app_config.json ( 50KB - 精簡(jiǎn)配置) ├── license.txt ( 5KB - 許可證文本) └── templates/ └── email_template.html ( 10KB - 郵件模板)6.2 HarmonyOS 6 新增 rawfile 壓縮HarmonyOS 6API 23新增了compressRawfile構(gòu)建選項(xiàng)可自動(dòng)對(duì)rawfile中的文本文件進(jìn)行壓縮// build-profile.json5 (HarmonyOS 6) { module: { name: entry, type: entry, resourceOptions: { compressRawfile: true, // 自動(dòng)壓縮 rawfile 中的文本文件 excludeLocales: [ar, he] // 排除不需要的語(yǔ)言包 } } }6.3 大文件遷移方案對(duì)于必須包含的大文件推薦以下三種方案// 方案一HSP 動(dòng)態(tài)共享多模塊共用// 將大文件放入 HSP多個(gè) HAP 共享同一份// 方案二Feature HAP 按需加載// 將非核心資源拆分為 Feature HAPasyncfunctionloadLargeResource(){constmoduleawaitimport(myapp/feature_resources);returnmodule.getResource(large_file);}// 方案三服務(wù)端下發(fā)首次啟動(dòng)下載// 應(yīng)用啟動(dòng)時(shí)檢查并下載必要資源import{request}fromkit.BasicServicesKit;asyncfunctiondownloadResourceIfNeeded(){constcacheDirgetContext().cacheDir;consttargetPath${cacheDir}/resources/large_file.json;if(!fileIo.accessSync(targetPath)){constdownloadTaskrequest.downloadFile(getContext(),{url:https://cdn.example.com/resources/large_file.json,filePath:targetPath});awaitdownloadTask.promise;}returntargetPath;}七、冗余資源清理ShrinkResources 與手動(dòng)檢測(cè)項(xiàng)目迭代過程中廢棄的圖片、字符串、顏色等資源會(huì)不斷累積。DevEco Studio 提供了shrinkResources功能可以在 Release 構(gòu)建時(shí)自動(dòng)移除未被引用的資源。7.1 啟用自動(dòng)資源收縮// build-profile.json5 { apiType: stageMode, buildOption: { shrinkResources: true, // 移除未引用資源 enableObfuscation: true, // 配合代碼混淆使用 enableMinification: true } }7.2 手動(dòng)冗余資源檢測(cè)腳本// scripts/check_unused_resources.tsimport*asfsfromfs;import*aspathfrompath;functionfindUnusedResources(projectPath:string):string[]{constresourceDirpath.join(projectPath,src/main/resources);constsourceDirpath.join(projectPath,src/main/ets);// 收集所有資源文件constresources:SetstringnewSet();collectResources(resourceDir,resources);// 收集所有源碼中的資源引用constreferences:SetstringnewSet();collectReferences(sourceDir,references);// 找出未被引用的資源constunused:string[][];resources.forEach(res{if(!references.has(res)){unused.push(res);}});returnunused;}functioncollectResources(dir:string,resources:Setstring):void{if(!fs.existsSync(dir))return;constentriesfs.readdirSync(dir);for(constentryofentries){constfullPathpath.join(dir,entry);conststatfs.statSync(fullPath);if(stat.isDirectory()){collectResources(fullPath,resources);}else{// 提取資源名不含擴(kuò)展名constextpath.extname(entry);constnamepath.basename(entry,ext);resources.add(name);}}}functioncollectReferences(dir:string,references:Setstring):void{if(!fs.existsSync(dir))return;constentriesfs.readdirSync(dir);for(constentryofentries){constfullPathpath.join(dir,entry);conststatfs.statSync(fullPath);if(stat.isDirectory()){collectReferences(fullPath,references);}elseif(entry.endsWith(.ets)||entry.endsWith(.ts)){constcontentfs.readFileSync(fullPath,utf-8);// 匹配 $r(app.media.xxx) 等引用constregex/\$r\([]app\.(media|string|color|profile)\.(\w)[]\)/g;letmatch;while((matchregex.exec(content))!null){references.add(match[2]);}// 匹配 $rawfile(xxx)constrawfileRegex/\$rawfile\([]([^])[]\)/g;while((matchrawfileRegex.exec(content))!null){references.add(path.basename(match[1],path.extname(match[1])));}}}}// 執(zhí)行檢測(cè)constunusedfindUnusedResources(./entry);console.log(發(fā)現(xiàn)${unused.length}個(gè)未使用資源:);unused.forEach(rconsole.log(-${r}));八、資源優(yōu)化工具鏈與自動(dòng)化流程將資源優(yōu)化融入開發(fā)流程需要建立從設(shè)計(jì)交付到 CI/CD 發(fā)布的全鏈路工具鏈8.1 設(shè)計(jì)階段規(guī)范# resource-guidelines.yml - 資源規(guī)范配置image:max_width:1920max_height:1080format:webp# 強(qiáng)制使用 WebPquality:80# 壓縮質(zhì)量icon_format:svg# 圖標(biāo)必須使用 SVGfont:max_size:2MB# 單字體文件不超過 2MBsubset_required:true# 必須子集化audio:max_duration:30s# 音頻不超過 30 秒format:aac# 強(qiáng)制使用 AACbitrate:128k# 碼率限制rawfile:max_file_size:500KB# 單個(gè)文件不超過 500KBcompress_text:true# 文本文件必須壓縮8.2 CI/CD 集成# .github/workflows/resource-check.ymlname:Resource Size Checkon:[push,pull_request]jobs:check:runs-on:ubuntu-lateststeps:-uses:actions/checkoutv4-name:Check image formatsrun:|# 檢查是否有未轉(zhuǎn)換為 WebP 的 PNG/JPG png_count$(find entry/src/main/resources -name *.png | wc -l) jpg_count$(find entry/src/main/resources -name *.jpg -o -name *.jpeg | wc -l) if [ $png_count -gt 0 ] || [ $jpg_count -gt 0 ]; then echo ? 發(fā)現(xiàn) $png_count 個(gè) PNG 和 $jpg_count 個(gè) JPG 文件請(qǐng)轉(zhuǎn)換為 WebP exit 1 fi echo ? 圖片格式檢查通過-name:Check large filesrun:|# 檢查 rawfile 中是否有超過 500KB 的文件 large_files$(find entry/src/main/resources/rawfile -type f -size 500k) if [ -n $large_files ]; then echo ? 發(fā)現(xiàn)大文件: echo $large_files exit 1 fi echo ? 大文件檢查通過-name:Build and analyzerun:|hvigorw assembleRelease java -jar $OHOS_SDK/toolchains/lib/app-check-tool.jar \ --mode hap \ --input build/outputs/default/packaging/entry-default-signed.hap \ --output ./scan-report/-name:Check bundle sizerun:|size$(stat -c%s build/outputs/default/packaging/entry-default-signed.hap) limit$((30 * 1024 * 1024)) # 30MB if [ $size -gt $limit ]; then echo ? Entry HAP 體積超標(biāo): $size bytes $limit bytes exit 1 fi echo ? 包體積檢查通過: $size bytes九、實(shí)戰(zhàn)案例資源文件優(yōu)化前后對(duì)比以下是一個(gè)電商類 HarmonyOS 應(yīng)用的資源優(yōu)化實(shí)戰(zhàn)數(shù)據(jù)資源類別優(yōu)化前優(yōu)化后減少比例優(yōu)化手段圖片資源42.5 MB15.2 MB64%PNG→WebP 壓縮 密度目錄精簡(jiǎn)字符串/顏色3.2 MB2.1 MB34%字符串復(fù)用 未使用清理配置文件5.8 MB2.4 MB59%JSON 精簡(jiǎn) 冗余字段刪除原始文件18.3 MB4.5 MB75%大文件上云 rawfile 壓縮字體文件8.6 MB2.8 MB67%系統(tǒng)字體替代 子集化音頻資源12.4 MB3.6 MB71%WAV→AAC 碼率控制主題文件2.1 MB1.2 MB43%主題合并 重復(fù)顏色清理總計(jì)92.9 MB31.8 MB66%—十、總結(jié)與最佳實(shí)踐資源文件優(yōu)化是 HarmonyOS 應(yīng)用性能優(yōu)化的基礎(chǔ)工程需要從格式選型、壓縮策略、冗余清理、動(dòng)態(tài)加載等多個(gè)維度系統(tǒng)推進(jìn)。核心最佳實(shí)踐清單格式優(yōu)先圖標(biāo)用 SVG位圖用 WebPHarmonyOS 6 用 AVIF照片用有損 WebP密度精簡(jiǎn)僅在 base 目錄放置默認(rèn)資源非必要不在多密度目錄重復(fù)放置字體子集化自定義字體必須通過子集化提取僅使用字符或優(yōu)先使用系統(tǒng)字體音頻壓縮背景音樂用 128kbps AAC提示音用 64kbps AAC 單聲道rawfile 管控單個(gè)文件不超過 500KB大文件通過 HSP 或服務(wù)端下發(fā)自動(dòng)清理Release 構(gòu)建啟用shrinkResources定期執(zhí)行冗余資源掃描CI/CD 攔截在流水線中設(shè)置資源格式檢查、體積閾值檢查超標(biāo)自動(dòng)阻斷資源優(yōu)化不是一次性的大掃除而是需要融入日常開發(fā)流程的持續(xù)工程。通過建立規(guī)范化的資源治理體系和自動(dòng)化的檢查機(jī)制可以確保應(yīng)用始終保持輕量、高效的用戶體驗(yàn)。轉(zhuǎn)載自https://blog.csdn.net/u014727709/article/details/164003792歡迎 點(diǎn)贊?評(píng)論?收藏歡迎指正