文章目录每日一句正能量一、前言资源文件是包体积的沉默杀手二、HarmonyOS 资源文件体系概览2.1 资源分类与访问方式2.2 资源限定词匹配优先级三、图片资源优化格式选型是第一步3.1 各图片格式特性对比3.2 图片格式选型实战3.3 批量转换脚本3.4 纹理压缩高频渲染场景的终极武器四、字体文件优化从全量引入到按需加载4.1 字体优化策略五、音频资源优化压缩与格式选择5.1 音频格式选型5.2 音频压缩实战5.3 音频资源上云六、rawfile 治理容易被忽视的体积黑洞6.1 rawfile 使用规范6.2 HarmonyOS 6 新增 rawfile 压缩6.3 大文件迁移方案七、冗余资源清理ShrinkResources 与手动检测7.1 启用自动资源收缩7.2 手动冗余资源检测脚本八、资源优化工具链与自动化流程8.1 设计阶段规范8.2 CI/CD 集成九、实战案例资源文件优化前后对比十、总结与最佳实践每日一句正能量位置不同不争认知不同不辩三观不合不言。不争是位置不同时的从容不辩是认知不同时的清醒不言是三观不合时的自重。不与他人纠缠不是软弱而是清醒。把精力留给值得的人和事是成年人最珍贵的自觉。一、前言资源文件是包体积的沉默杀手在 HarmonyOS 应用开发中资源文件图片、字体、音频、配置文件等往往占据应用包体积的40%~60%。与代码不同资源文件的体积增长是静默的——设计师交付一张新的 Banner 图、产品经理要求增加一套主题皮肤、运营同事上传一段引导视频这些看似微不足道的操作日积月累便会让应用包膨胀到用户难以接受的规模。更棘手的是资源文件的优化涉及多个维度格式选型、分辨率适配、压缩策略、冗余清理、动态加载等。每个维度都有独立的决策逻辑且相互之间存在耦合关系。例如将 PNG 转为 WebP 可以减小体积但如果同时存在多套密度资源优化效果会被重复拷贝抵消使用 SVG 可以无限缩放但复杂路径的 SVG 在运行时渲染性能反而不如位图。本文将从资源分类与格式选型出发系统讲解 HarmonyOS 资源文件的优化方法论涵盖图片压缩、矢量图应用、纹理压缩、字体优化、音频压缩、rawfile 治理、冗余资源清理等七大方向并提供可直接落地的代码示例和 CI/CD 自动化方案。二、HarmonyOS 资源文件体系概览2.1 资源分类与访问方式HarmonyOS 的资源文件按照用途和访问方式分为两大类资源类型访问方式编译行为适用场景Resource$r(app.type.name)编译时生成索引支持限定词匹配图片、字符串、颜色、尺寸等Rawfile$rawfile(path/file.ext)原样打包不参与编译配置文件、字体、模板、大文件Resource 资源支持限定词匹配机制系统会根据设备的语言、屏幕密度、方向、深色模式等条件自动选择最合适的资源版本。这一机制虽然提升了用户体验但也引入了资源冗余的风险——如果开发者在每个限定词目录下都放置了完整的资源副本包体积将成倍增长。2.2 资源限定词匹配优先级HarmonyOS 的资源限定词匹配遵循严格的优先级顺序从高到低语言区域如zh_CN、en_US屏幕密度如sdpi、mdpi、ldpi、xldpi、xxldpi屏幕方向如horizontal、vertical深色模式如dark、light回退 base默认资源兜底关键原则只在确实需要差异化适配的限定词目录下放置资源其他情况统一放在base目录。HarmonyOS 的资源回退机制会自动在base目录查找缺失的资源无需在每个目录下重复放置。三、图片资源优化格式选型是第一步图片资源通常是应用包中体积最大的部分优化图片是资源治理的重中之重。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简单动图不推荐从数据可以看出在相同视觉质量下WebP 有损格式的体积仅为 PNG 的25%而AVIFHarmonyOS 6/API 12 原生支持更是只有 PNG 的20%。对于图标类资源SVG的体积优势极为明显——一个 48x48 的图标SVG 通常不足 5KB而同等尺寸的 PNG 可能需要 20~50KB。3.2 图片格式选型实战场景一工具栏图标24x24 ~ 48x48// 推荐SVG 矢量格式// 文件resources/base/media/ic_home.svgImage($r(app.media.ic_home)).width(24).height(24).fillColor(#1890FF)// SVG 支持动态着色// 不推荐PNG 位图// 需要为每种密度准备独立文件体积大且无法动态变色场景二启动页背景1920x1080// 推荐WebP 有损格式质量 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 批量转换脚本#!/bin/bash# convert_to_webp.sh - 批量将 PNG/JPG 转为 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# 删除原文件确认转换成功后if[-f$RESOURCE_DIR/${name}.webp];thenrm$filefidoneecho转换完成3.4 纹理压缩高频渲染场景的终极武器对于游戏、相册、电商等需要高频渲染大量图片的场景HarmonyOS 提供了纹理压缩技术。纹理压缩在编译构建阶段将图片预转换为 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格式图片启用纹理压缩或对包体积不敏感的性能敏感场景使用。四、字体文件优化从全量引入到按需加载自定义字体文件是另一个容易被忽视的体积大户。一套中文字体如思源黑体的 TTF 文件通常有8~15MB如果直接放入rawfile目录将直接增加同等的包体积。4.1 字体优化策略策略一优先使用系统字体HarmonyOS 内置了 HarmonyOS Sans 字体族覆盖中文、英文、数字等全量字符无需额外引入// 直接使用系统默认字体Text(欢迎使用 HarmonyOS).fontFamily(HarmonyOS Sans)// 系统自带零体积成本.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 动态加载字体将字体文件放入 HSP 动态共享包按需下载加载// 动态加载 HSP 中的字体asyncfunctionloadCustomFont(){constfontModuleawaitimport(myapp/fonts);constfontPathfontModule.getFontPath(custom_font);// 注册字体font.registerFont({familyName:CustomFont,familySrc:fontPath});}五、音频资源优化压缩与格式选择音频文件提示音、背景音乐、语音播报等虽然数量不多但单个体积往往很大。一段 30 秒的未压缩 WAV 音频可达5MB即使 MP3 压缩后也可能有500KB。5.1 音频格式选型格式压缩率音质适用场景MP3中较好背景音乐、长音频AAC高好语音播报、提示音推荐OPUS极高好实时语音、网络传输WAV无无损短提示音不推荐大文件5.2 音频压缩实战# 使用 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单声道语音优化ffmpeg-ivoice_guide.wav-c:aaac-b:a48k-ac1-ar22050voice_guide.m4a5.3 音频资源上云对于长背景音乐30秒建议不打包进 HAP而是通过服务端下发或 HSP 按需加载// 从网络加载音频import{audio}fromkit.AudioKit;asyncfunctionplayRemoteAudio(url:string){constavPlayerawaitaudio.createAVPlayer();awaitavPlayer.setSource(url);awaitavPlayer.prepare();avPlayer.play();}六、rawfile 治理容易被忽视的体积黑洞rawfile目录中的文件会被原封不动地打包进 HAP不参与任何编译优化。这意味着放入rawfile的 JSON 配置文件不会被压缩放入rawfile的字体文件体积完全保留放入rawfile的视频/音频文件直接增加包体积6.1 rawfile 使用规范❌ 错误用法 resources/rawfile/ ├── large_dataset.json (4.2MB - 大JSON数据) ├── 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 动态共享多模块共用// 将大文件放入 HSP多个 HAP 共享同一份// 方案二Feature HAP 按需加载// 将非核心资源拆分为 Feature HAPasyncfunctionloadLargeResource(){constmoduleawaitimport(myapp/feature_resources);returnmodule.getResource(large_file);}// 方案三服务端下发首次启动下载// 应用启动时检查并下载必要资源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])));}}}}// 执行检测constunusedfindUnusedResources(./entry);console.log(发现${unused.length}个未使用资源:);unused.forEach(rconsole.log(-${r}));八、资源优化工具链与自动化流程将资源优化融入开发流程需要建立从设计交付到 CI/CD 发布的全链路工具链8.1 设计阶段规范# resource-guidelines.yml - 资源规范配置image:max_width:1920max_height:1080format:webp# 强制使用 WebPquality:80# 压缩质量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:|# 检查是否有未转换为 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 ❌ 发现 $png_count 个 PNG 和 $jpg_count 个 JPG 文件请转换为 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 ❌ 发现大文件: 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九、实战案例资源文件优化前后对比以下是一个电商类 HarmonyOS 应用的资源优化实战数据资源类别优化前优化后减少比例优化手段图片资源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%系统字体替代 子集化音频资源12.4 MB3.6 MB71%WAV→AAC 码率控制主题文件2.1 MB1.2 MB43%主题合并 重复颜色清理总计92.9 MB31.8 MB66%—十、总结与最佳实践资源文件优化是 HarmonyOS 应用性能优化的基础工程需要从格式选型、压缩策略、冗余清理、动态加载等多个维度系统推进。核心最佳实践清单格式优先图标用 SVG位图用 WebPHarmonyOS 6 用 AVIF照片用有损 WebP密度精简仅在 base 目录放置默认资源非必要不在多密度目录重复放置字体子集化自定义字体必须通过子集化提取仅使用字符或优先使用系统字体音频压缩背景音乐用 128kbps AAC提示音用 64kbps AAC 单声道rawfile 管控单个文件不超过 500KB大文件通过 HSP 或服务端下发自动清理Release 构建启用shrinkResources定期执行冗余资源扫描CI/CD 拦截在流水线中设置资源格式检查、体积阈值检查超标自动阻断资源优化不是一次性的大扫除而是需要融入日常开发流程的持续工程。通过建立规范化的资源治理体系和自动化的检查机制可以确保应用始终保持轻量、高效的用户体验。转载自https://blog.csdn.net/u014727709/article/details/164003792欢迎 点赞✍评论⭐收藏欢迎指正