文章目錄每日一句正能量一、前言資源文件是包體積的沉默殺手二、HarmonyOS 資源文件體系概覽2.1 資源分類與訪問方式2.2 資源限定詞匹配優(yōu)先級三、圖片資源優(yōu)化格式選型是第一步3.1 各圖片格式特性對比3.2 圖片格式選型實戰(zhàn)3.3 批量轉(zhuǎn)換腳本3.4 紋理壓縮高頻渲染場景的終極武器四、字體文件優(yōu)化從全量引入到按需加載4.1 字體優(yōu)化策略五、音頻資源優(yōu)化壓縮與格式選擇5.1 音頻格式選型5.2 音頻壓縮實戰(zhàn)5.3 音頻資源上云六、rawfile 治理容易被忽視的體積黑洞6.1 rawfile 使用規(guī)范6.2 HarmonyOS 6 新增 rawfile 壓縮6.3 大文件遷移方案七、冗余資源清理ShrinkResources 與手動檢測7.1 啟用自動資源收縮7.2 手動冗余資源檢測腳本八、資源優(yōu)化工具鏈與自動化流程8.1 設計階段規(guī)范8.2 CI/CD 集成九、實戰(zhàn)案例資源文件優(yōu)化前后對比十、總結與最佳實踐每日一句正能量位置不同不爭認知不同不辯三觀不合不言。不爭是位置不同時的從容不辯是認知不同時的清醒不言是三觀不合時的自重。不與他人糾纏不是軟弱而是清醒。把精力留給值得的人和事是成年人最珍貴的自覺。一、前言資源文件是包體積的沉默殺手在 HarmonyOS 應用開發(fā)中資源文件圖片、字體、音頻、配置文件等往往占據(jù)應用包體積的40%~60%。與代碼不同資源文件的體積增長是靜默的——設計師交付一張新的 Banner 圖、產(chǎn)品經(jīng)理要求增加一套主題皮膚、運營同事上傳一段引導視頻這些看似微不足道的操作日積月累便會讓應用包膨脹到用戶難以接受的規(guī)模。更棘手的是資源文件的優(yōu)化涉及多個維度格式選型、分辨率適配、壓縮策略、冗余清理、動態(tài)加載等。每個維度都有獨立的決策邏輯且相互之間存在耦合關系。例如將 PNG 轉(zhuǎn)為 WebP 可以減小體積但如果同時存在多套密度資源優(yōu)化效果會被重復拷貝抵消使用 SVG 可以無限縮放但復雜路徑的 SVG 在運行時渲染性能反而不如位圖。本文將從資源分類與格式選型出發(fā)系統(tǒng)講解 HarmonyOS 資源文件的優(yōu)化方法論涵蓋圖片壓縮、矢量圖應用、紋理壓縮、字體優(yōu)化、音頻壓縮、rawfile 治理、冗余資源清理等七大方向并提供可直接落地的代碼示例和 CI/CD 自動化方案。二、HarmonyOS 資源文件體系概覽2.1 資源分類與訪問方式HarmonyOS 的資源文件按照用途和訪問方式分為兩大類資源類型訪問方式編譯行為適用場景Resource$r(app.type.name)編譯時生成索引支持限定詞匹配圖片、字符串、顏色、尺寸等Rawfile$rawfile(path/file.ext)原樣打包不參與編譯配置文件、字體、模板、大文件Resource 資源支持限定詞匹配機制系統(tǒng)會根據(jù)設備的語言、屏幕密度、方向、深色模式等條件自動選擇最合適的資源版本。這一機制雖然提升了用戶體驗但也引入了資源冗余的風險——如果開發(fā)者在每個限定詞目錄下都放置了完整的資源副本包體積將成倍增長。2.2 資源限定詞匹配優(yōu)先級HarmonyOS 的資源限定詞匹配遵循嚴格的優(yōu)先級順序從高到低語言區(qū)域如zh_CN、en_US屏幕密度如sdpi、mdpi、ldpi、xldpi、xxldpi屏幕方向如horizontal、vertical深色模式如dark、light回退 base默認資源兜底關鍵原則只在確實需要差異化適配的限定詞目錄下放置資源其他情況統(tǒng)一放在base目錄。HarmonyOS 的資源回退機制會自動在base目錄查找缺失的資源無需在每個目錄下重復放置。三、圖片資源優(yōu)化格式選型是第一步圖片資源通常是應用包中體積最大的部分優(yōu)化圖片是資源治理的重中之重。HarmonyOS 支持多種圖片格式每種格式都有其適用場景和壓縮特性。3.1 各圖片格式特性對比格式透明通道有損/無損相對PNG體積HarmonyOS兼容性推薦場景PNG支持無損100%基準API 9需要精確像素的UI圖JPEG不支持有損35%API 9照片、復雜色彩圖WebP支持有損/無損25%~55%API 9通用首選AVIF支持有損/無損20%API 12HarmonyOS 6 推薦SVG支持矢量3%API 9圖標、簡單矢量圖GIF支持無損低壓縮API 9簡單動圖不推薦從數(shù)據(jù)可以看出在相同視覺質(zhì)量下WebP 有損格式的體積僅為 PNG 的25%而AVIFHarmonyOS 6/API 12 原生支持更是只有 PNG 的20%。對于圖標類資源SVG的體積優(yōu)勢極為明顯——一個 48x48 的圖標SVG 通常不足 5KB而同等尺寸的 PNG 可能需要 20~50KB。3.2 圖片格式選型實戰(zhàn)場景一工具欄圖標24x24 ~ 48x48// 推薦SVG 矢量格式// 文件resources/base/media/ic_home.svgImage($r(app.media.ic_home)).width(24).height(24).fillColor(#1890FF)// SVG 支持動態(tài)著色// 不推薦PNG 位圖// 需要為每種密度準備獨立文件體積大且無法動態(tài)變色場景二啟動頁背景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 可進一步使用 AVIF1.2MB → 0.95MB再減 21%場景三商品詳情圖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# 刪除原文件確認轉(zhuǎn)換成功后if[-f$RESOURCE_DIR/${name}.webp];thenrm$filefidoneecho轉(zhuǎn)換完成3.4 紋理壓縮高頻渲染場景的終極武器對于游戲、相冊、電商等需要高頻渲染大量圖片的場景HarmonyOS 提供了紋理壓縮技術。紋理壓縮在編譯構建階段將圖片預轉(zhuǎn)換為 GPU 可直接讀取的紋理格式SUT/ASTC避免運行時的 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]] } } ] } } } }注意事項紋理壓縮會增加編譯時間且對.jpg和.webp格式的圖片可能導致包體積膨脹膨脹率約 2~3 倍。建議僅對.png格式圖片啟用紋理壓縮或?qū)Πw積不敏感的性能敏感場景使用。四、字體文件優(yōu)化從全量引入到按需加載自定義字體文件是另一個容易被忽視的體積大戶。一套中文字體如思源黑體的 TTF 文件通常有8~15MB如果直接放入rawfile目錄將直接增加同等的包體積。4.1 字體優(yōu)化策略策略一優(yōu)先使用系統(tǒng)字體HarmonyOS 內(nèi)置了 HarmonyOS Sans 字體族覆蓋中文、英文、數(shù)字等全量字符無需額外引入// 直接使用系統(tǒng)默認字體Text(歡迎使用 HarmonyOS).fontFamily(HarmonyOS Sans)// 系統(tǒng)自帶零體積成本.fontSize(16).fontWeight(FontWeight.Medium)策略二字體子集化Subsetting如果必須使用自定義字體可以通過字體子集化工具僅保留應用實際使用的字符# 使用 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 動態(tài)加載字體將字體文件放入 HSP 動態(tài)共享包按需下載加載// 動態(tài)加載 HSP 中的字體asyncfunctionloadCustomFont(){constfontModuleawaitimport(myapp/fonts);constfontPathfontModule.getFontPath(custom_font);// 注冊字體font.registerFont({familyName:CustomFont,familySrc:fontPath});}五、音頻資源優(yōu)化壓縮與格式選擇音頻文件提示音、背景音樂、語音播報等雖然數(shù)量不多但單個體積往往很大。一段 30 秒的未壓縮 WAV 音頻可達5MB即使 MP3 壓縮后也可能有500KB。5.1 音頻格式選型格式壓縮率音質(zhì)適用場景MP3中較好背景音樂、長音頻AAC高好語音播報、提示音推薦OPUS極高好實時語音、網(wǎng)絡傳輸WAV無無損短提示音不推薦大文件5.2 音頻壓縮實戰(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# 語音播報48kbps AAC單聲道語音優(yōu)化ffmpeg-ivoice_guide.wav-c:aaac-b:a48k-ac1-ar22050voice_guide.m4a5.3 音頻資源上云對于長背景音樂30秒建議不打包進 HAP而是通過服務端下發(fā)或 HSP 按需加載// 從網(wǎng)絡加載音頻import{audio}fromkit.AudioKit;asyncfunctionplayRemoteAudio(url:string){constavPlayerawaitaudio.createAVPlayer();awaitavPlayer.setSource(url);awaitavPlayer.prepare();avPlayer.play();}六、rawfile 治理容易被忽視的體積黑洞rawfile目錄中的文件會被原封不動地打包進 HAP不參與任何編譯優(yōu)化。這意味著放入rawfile的 JSON 配置文件不會被壓縮放入rawfile的字體文件體積完全保留放入rawfile的視頻/音頻文件直接增加包體積6.1 rawfile 使用規(guī)范? 錯誤用法 resources/rawfile/ ├── large_dataset.json (4.2MB - 大JSON數(shù)據(jù)) ├── intro_video.mp4 (18.3MB - 引導視頻) ├── full_font.ttf (8.6MB - 完整字體) └── config_backup.xml (未使用的備份配置) ? 正確用法 resources/rawfile/ ├── app_config.json ( 50KB - 精簡配置) ├── license.txt ( 5KB - 許可證文本) └── templates/ └── email_template.html ( 10KB - 郵件模板)6.2 HarmonyOS 6 新增 rawfile 壓縮HarmonyOS 6API 23新增了compressRawfile構建選項可自動對rawfile中的文本文件進行壓縮// build-profile.json5 (HarmonyOS 6) { module: { name: entry, type: entry, resourceOptions: { compressRawfile: true, // 自動壓縮 rawfile 中的文本文件 excludeLocales: [ar, he] // 排除不需要的語言包 } } }6.3 大文件遷移方案對于必須包含的大文件推薦以下三種方案// 方案一HSP 動態(tài)共享多模塊共用// 將大文件放入 HSP多個 HAP 共享同一份// 方案二Feature HAP 按需加載// 將非核心資源拆分為 Feature HAPasyncfunctionloadLargeResource(){constmoduleawaitimport(myapp/feature_resources);returnmodule.getResource(large_file);}// 方案三服務端下發(fā)首次啟動下載// 應用啟動時檢查并下載必要資源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 與手動檢測項目迭代過程中廢棄的圖片、字符串、顏色等資源會不斷累積。DevEco Studio 提供了shrinkResources功能可以在 Release 構建時自動移除未被引用的資源。7.1 啟用自動資源收縮// build-profile.json5 { apiType: stageMode, buildOption: { shrinkResources: true, // 移除未引用資源 enableObfuscation: true, // 配合代碼混淆使用 enableMinification: true } }7.2 手動冗余資源檢測腳本// 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{// 提取資源名不含擴展名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í)行檢測constunusedfindUnusedResources(./entry);console.log(發(fā)現(xiàn)${unused.length}個未使用資源:);unused.forEach(rconsole.log(-${r}));八、資源優(yōu)化工具鏈與自動化流程將資源優(yōu)化融入開發(fā)流程需要建立從設計交付到 CI/CD 發(fā)布的全鏈路工具鏈8.1 設計階段規(guī)范# resource-guidelines.yml - 資源規(guī)范配置image:max_width:1920max_height:1080format:webp# 強制使用 WebPquality:80# 壓縮質(zhì)量icon_format:svg# 圖標必須使用 SVGfont:max_size:2MB# 單字體文件不超過 2MBsubset_required:true# 必須子集化audio:max_duration:30s# 音頻不超過 30 秒format:aac# 強制使用 AACbitrate:128k# 碼率限制rawfile:max_file_size:500KB# 單個文件不超過 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 個 PNG 和 $jpg_count 個 JPG 文件請轉(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 體積超標: $size bytes $limit bytes exit 1 fi echo ? 包體積檢查通過: $size bytes九、實戰(zhàn)案例資源文件優(yōu)化前后對比以下是一個電商類 HarmonyOS 應用的資源優(yōu)化實戰(zhàn)數(shù)據(jù)資源類別優(yōu)化前優(yōu)化后減少比例優(yōu)化手段圖片資源42.5 MB15.2 MB64%PNG→WebP 壓縮 密度目錄精簡字符串/顏色3.2 MB2.1 MB34%字符串復用 未使用清理配置文件5.8 MB2.4 MB59%JSON 精簡 冗余字段刪除原始文件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%主題合并 重復顏色清理總計92.9 MB31.8 MB66%—十、總結與最佳實踐資源文件優(yōu)化是 HarmonyOS 應用性能優(yōu)化的基礎工程需要從格式選型、壓縮策略、冗余清理、動態(tài)加載等多個維度系統(tǒng)推進。核心最佳實踐清單格式優(yōu)先圖標用 SVG位圖用 WebPHarmonyOS 6 用 AVIF照片用有損 WebP密度精簡僅在 base 目錄放置默認資源非必要不在多密度目錄重復放置字體子集化自定義字體必須通過子集化提取僅使用字符或優(yōu)先使用系統(tǒng)字體音頻壓縮背景音樂用 128kbps AAC提示音用 64kbps AAC 單聲道rawfile 管控單個文件不超過 500KB大文件通過 HSP 或服務端下發(fā)自動清理Release 構建啟用shrinkResources定期執(zhí)行冗余資源掃描CI/CD 攔截在流水線中設置資源格式檢查、體積閾值檢查超標自動阻斷資源優(yōu)化不是一次性的大掃除而是需要融入日常開發(fā)流程的持續(xù)工程。通過建立規(guī)范化的資源治理體系和自動化的檢查機制可以確保應用始終保持輕量、高效的用戶體驗。轉(zhuǎn)載自https://blog.csdn.net/u014727709/article/details/164003792歡迎 點贊?評論?收藏歡迎指正