配套工程源码、测试材料与运行说明

前言 我先打开两个 HAP 的条目清单。PNG 版是 197,799 B,WebP 版是 165,259 B。目光往下移到 rawfile,旧 PNG 的确已经从新版包里消失。接着装上 WebP 版,依次打开「轨道」「温室」「至日」,确认页面显示的是这三张版画。下面从 HAP 列表开始追这两个结果,分别看打包输入和运行时使用的资源。

一个 HAP 里到底发出了哪三张图

拿两份使用同一套调试构建配置的 HAP。第一份只带 PNG 资源,第二份带对应的无损 WebP。用工具打开 ZIP 目录,找应用 rawfile 中的资源,再单独查看整个归档的字节数。可以先打开这张清单再看脚本,不必先了解图像编码。

同尺寸样本

PNG 条目

WebP 条目

轨道

28,819 B

9,816 B

温室

13,841 B

4,032 B

至日

6,644 B

2,910 B

完整 HAP

197,799 B

165,259 B

三个条目的差加起来是 32,546 B,包整体的差是 32,540 B。差了几个字节不值得在这轮做归因。两条数据各有用途。条目用来查看最大的目标文件,整个 HAP 有多大才是交付成果。别只拿一种格式的文件大小除以整包,换算出一个看起来特别大的收益。小示例中三张图占比很高,别的应用如果多数体积来自库和语言资源,整体比例会不一样。

import sys
from collections import defaultdict
from pathlib import Path
from zipfile import ZipFile

hap = Path(sys.argv[1])
totals = defaultdict(int)
with ZipFile(hap) as package:
    for entry in sorted(package.infolist(), key=lambda item: item.filename):
        if entry.is_dir() or '/rawfile/' not in '/' + entry.filename:
            continue
        suffix = Path(entry.filename).suffix.lower()
        totals[suffix] += entry.compress_size
        print(entry.filename, entry.file_size, entry.compress_size)
print('后缀小计(包内字节)', dict(totals))
print('完整 HAP(字节)', hap.stat().st_size)

操作时可以用同一份清单脚本对两个 HAP 各跑一次,分别把三张图所在的归档路径留住。先比单个成员,再比 rawfile 这一组合计,最后看完整文件。这里还有一个特别实用的检测:新 HAP 应只包含预期的三份 WebP,旧三个 PNG 不应该再出现在随包资源里。若总大小降了一点但旧图仍然在,仍应继续找来源,不应直接把新的文件名当成旧项已移除。某张展品映射有多个同名目录时,要读路径和后缀两项。具体报告里三个条目的原大小和压缩大小恰好相同,表示这次结果中归档没有进一步缩这三项,不代表别的应用也这样打包。

交叉查时还可以看内容是否真来自生成脚本。测试先从 HAP 解出以 /rawfile/ 文件名结尾的成员,再和对应格式准备目录下的文件字节比较。后缀相同却放错了图,这一步就能发现。页面随后也应显示同一个名字和相同的文件大小。大小相同不保证图相同,所以清单和字节比较各有用途。有图片被换成另外一份等长文件时,单读 file_size 就不会发现。

为什么要从同一组像素各存一份

如果网上各找一张看起来类似的图片,改格式后出现的差值可能来自原图的噪声、尺寸或颜色,而不是输出格式。样本生成脚本用三套图稿,每套同一份内容按两个后缀输出。脚本分别写到不同的构建准备目录,打包前各自只放预期的三张,才方便从条目清单确认旧资源确实不在新包里。

"""Create matching lossless PNG/WebP variants of three original poster designs."""
import argparse
import math
from pathlib import Path
import shutil

from PIL import Image, ImageDraw, ImageChops

ROOT = Path(__file__).resolve().parent
WIDTH, HEIGHT = 960, 720


def poster(number):
    canvas = Image.new('RGB', (WIDTH, HEIGHT), ('#DDD9F2', '#C9E4D9', '#F3D0A7')[number])
    d = ImageDraw.Draw(canvas)
    d.rectangle((36, 36, 923, 683), outline=('#6E5BBA', '#437C69', '#AC5E3A')[number], width=2)
    if number == 0:
        for i in range(24):
            d.arc((70+i*10, 55+i*9, 890-i*10, 665-i*9), 120, 420,
                  fill=(88+i*4, 61+i*5, 163+i*2), width=5)
        d.ellipse((376, 259, 585, 468), fill='#F9F4FF')
        d.ellipse((451, 333, 510, 392), fill='#62509A')
    elif number == 1:
        for j in range(7):
            for i in range(9):
                x, y = 115 + i*83, 97+j*75
                d.arc((x, y, x+120, y+120), 180, 355, fill=('#234D42', '#488D76', '#F6FAF4')[(i+j)%3], width=10)
    else:
        d.ellipse((260, 128, 695, 563), fill='#D66342')
        for i in range(22):
            angle = i * math.tau / 22
            x, y = 478 + 263 * math.cos(angle), 346 + 263 * math.sin(angle)
            d.ellipse((x-13, y-13, x+13, y+13), fill='#80442F')
        d.ellipse((351, 218, 606, 473), fill='#FFF0D0')
        d.ellipse((434, 301, 523, 390), fill='#9F4E3D')
    return canvas


def run(codec):
    raw = ROOT / 'project/entry/src/main/resources/rawfile'
    raw.mkdir(parents=True, exist_ok=True)
    for i, name in enumerate(('orbit', 'greenhouse', 'solstice')):
        canvas = poster(i)
        for extension in ('png', 'webp'):
            target = ROOT / 'variants' / extension / (name + '.' + extension)
            target.parent.mkdir(parents=True, exist_ok=True)
            if extension == 'png':
                canvas.save(target, optimize=True)
            else:
                canvas.save(target, lossless=True, method=6)
            with Image.open(target) as decoded:
                assert ImageChops.difference(decoded.convert('RGB'), canvas).getbbox() is None
            if extension == codec:
                shutil.copyfile(target, raw / target.name)
            else:
                (raw / target.name).unlink(missing_ok=True)


if __name__ == '__main__':
    p = argparse.ArgumentParser()
    p.add_argument('codec', choices=['png', 'webp'])
    run(p.parse_args().codec)

生成脚本前先确保开发机 Python 能导入 Pillow。文件参数只选 png 或 webp。将它单独放到工程的上级工作目录,把相同像素先准备好,打包 PNG 之前运行 python make_samples.py png 并留一份 HAP;再运行 python make_samples.py webp,重新构建并留另一份。脚本最后只把目标格式放入 rawfile,同时从同一目录移走另一格式的同名文件,所以每个包的来源明确。若在自己的工程里已经有同名素材,建议用单独空工程重放,确认脚本输出目录对应的是样例仓库,不要覆盖原资源。

这里如何确认 WebP 的图没换内容?生成时用同一画布导出,回读无损输出后转回 RGB 与原画布做差。一点不一样就应先查生成或转换配置。应用真正显示时又要用 system Image 验一次,证明解码和引用路径正常。前者用于核验这批测试像素是否一致,后者检查用户看到的是交付包资源。要改有损转换,差异检查需要改成按场景审可见效果,不能拿这里的逐像素结论推到所有输出模式。

项目真正换资源时可以按使用方式选样。海报大图、带透明的图章和很多细字的示意图,分别挑真实内容再回看。先把存储单位、像素尺寸和透明处理约定对齐。准备用有损模式,最好先拿典型查看距离做一组肉眼对照,别把页面缩成很小再宣称细节全一样。当前实验选择无损,结论与有损品质设置是两件事。

展签的数据来自实际打开的文件

资产清单可以按旧文件、新文件和使用位置来核对。一张图可能还被另一个页面用旧路径引用,所以改完后不一定在这篇样例的第一页暴露。如果确实要给多个环境留两种格式,要说明两份为何同时存在,再算包含回退文件的包大小。这里一份包只带一组,回退让同一个入口可以分别运行两份包。

比较两个包还应把其他构建输入固定。如果换资源时升级了库,签名、清单、目录名和依赖都可能影响整包。留存两份 HAP 可以以后以同一规则重新统计。只有两个含图源码目录时,最多知道交付前的准备数据,判断不了使用者拿到的整包。

展品选中后,界面先清空上一张的展签。读取资源时尝试同名 WebP,失败才按 PNG 读。随机选一张把扩展名写到 Text 里不能证明资源有效,所以拿实际的 Uint8Array 查字节数,从图像源读宽高,再把决定过的文件名交给 Image。假如回退成功,画面和展签都应出现 PNG。即使屏幕看上去一样,也能知道安装包中实际走的是哪个文件。

private async select(index: number): Promise<void> {
  const epoch = ++this.serial;
  this.selected = index;
  this.filename = '';
  this.bytes = 0;
  this.dimensions = '—';
  this.ready = '读取展品';
  let source: image.ImageSource | undefined;
  try {
    const context = this.getUIContext().getHostContext() as common.UIAbilityContext;
    const manager = context.resourceManager;
    let name = FILES[index] + '.webp';
    let raw: Uint8Array;
    try {
      raw = await manager.getRawFileContent(name);
    } catch (_) {
      name = FILES[index] + '.png';
      raw = await manager.getRawFileContent(name);
    }
    source = image.createImageSource(raw.buffer.slice(raw.byteOffset, raw.byteOffset + raw.byteLength) as ArrayBuffer);
    const size = (await source.getImageInfo()).size;
    if (epoch !== this.serial) return;
    this.bytes = raw.byteLength;
    this.dimensions = `${size.width} × ${size.height}`;
    this.filename = name;
  } catch (error) {
    if (epoch === this.serial) this.ready = '资源读取失败:' + String(error);
  } finally {
    await source?.release();
  }
}

模拟器上点温室,正确的一组是 greenhouse.webp、4032 B、960 × 720,最后还要等 Image 回调显示「渲染就绪」。文件名和尺寸出现只代表图像源能读出信息。测试循环轮换的顺序是轨道、温室、至日、轨道、至日,检查每次选中的文件和状态,覆盖了切回旧展项以及最后一次选择。若最终画面出错却已读到尺寸,优先查绑定到 Image 的资源名;若连展签都没有刷新,就查更早的 rawfile 读取和尺寸获取。

为了不把结果写到其他展品,select 先递增 serial 并保存本次序号。比如从轨道切到温室很快,轨道的读取可能晚于温室返回。写状态前比较序号,已经过时的响应直接离开。图像源仍从 finally 释放。读信息的缓冲先按有效 byteOffset 和 byteLength 截出,避免一段有效资源共享了更大的底层数组时带进无关字节。后面的 Image 还有自己的完成与错误回调,可以看真正渲染是否就绪。

快速切换之后,除了核对最终展签,还要确认图片完成回调更新的是当前那张。select 里的序号保护文件和尺寸写回,并没有给 Image 的 onComplete 自动附上相同的序号。如果真实页面还需要严格区分图片渲染的完成回执,可以把资源名或切换编号带进回调,再检查它是否仍是当前选中项。

在 MateBook Pro API 24 模拟器里,本次装的是 WebP 包。依次轮到轨道、温室、至日,展签读到 9816、4032、2910 字节,都是对应文件;界面也实际显示。PNG 的数字来自保留的对照 HAP。快切可以作为另外一项回归:接连点三次后末尾应该留下第三张展品与它自己的文件名。一旦发现图与展签对不上,先检查读取和渲染入口有没有绑定同一个选择和文件名,再查缓存。

复跑时用 MateBook Pro 模拟器,API 24,运行版本 6.1.0.125(SP12DEVC00E47R1P3)。把新版装进去后,不止看默认轨道,还要点第二、第三张,三份都应显示「渲染就绪」,后缀都是 WebP,数字分别对应那三条归档记录。随后切回第一张确认仍读到自己的尺寸和字节。本轮用于写稿的运行截图来自安装新版之后。PNG 是上一份基线归档的测量,这两个来源明确分开后,读者还能照着步骤实跑一遍旧版,验证 WebP 缺失时入口确实能读回 PNG。

若第一张能显示、第二张出不来,先查具体选中项。读取原资源失败和读到后无法渲染,是两个观察点。宽高和字节数都对,却没出现图,优先看画面回调或绑定位置。可以故意从测试包装漏掉第二张,验证回退或提示只落在这项,另外两张还能继续操作。要是窗口切过去又回来,还应核对先前一次迟到的读取没有把最后一张的展签改回去。

同一个入口分别验证两份安装包

工程和图稿生成器已放在文首。先用 Pillow 执行 python make_samples.py png,在同一套 DevEco API 24 调试构建设置下产出基线 HAP。换用 python make_samples.py webp 再打包一次。把两个产物另存后列出压缩条目和总字节数,再安装 WebP 版逐张看图。@kit.ImageKit 负责运行时的图片读取和解码,生成脚本中的像素一致检查只校验输入样本。这次归档体积、解码和上屏时间是不同的观察项目。

import { image } from '@kit.ImageKit';
import { common } from '@kit.AbilityKit';

const FILES = ['orbit', 'greenhouse', 'solstice'];
const NAMES = ['轨道', '玻璃温室', '冬至'];
const SERIES = ['交错的椭圆轨迹', '重复的温室拱顶', '一张几何日历'];
const ACCENTS = ['#5D489B', '#275D4C', '#9C432A'];

@Entry
@Component
struct Index {
  @State private selected: number = 0;
  @State private bytes: number = 0;
  @State private filename: string = '';
  @State private dimensions: string = '—';
  @State private ready: string = '读取展品';
  private serial: number = 0;

  aboutToAppear(): void {
    void this.select(0);
  }

  private async select(index: number): Promise<void> {
    const epoch = ++this.serial;
    this.selected = index;
    this.filename = '';
    this.bytes = 0;
    this.dimensions = '—';
    this.ready = '读取展品';
    let source: image.ImageSource | undefined;
    try {
      const context = this.getUIContext().getHostContext() as common.UIAbilityContext;
      const manager = context.resourceManager;
      let name = FILES[index] + '.webp';
      let raw: Uint8Array;
      try {
        raw = await manager.getRawFileContent(name);
      } catch (_) {
        name = FILES[index] + '.png';
        raw = await manager.getRawFileContent(name);
      }
      source = image.createImageSource(raw.buffer.slice(raw.byteOffset, raw.byteOffset + raw.byteLength) as ArrayBuffer);
      const size = (await source.getImageInfo()).size;
      if (epoch !== this.serial) return;
      this.bytes = raw.byteLength;
      this.dimensions = `${size.width} × ${size.height}`;
      this.filename = name;
    } catch (error) {
      if (epoch === this.serial) this.ready = '资源读取失败:' + String(error);
    } finally {
      await source?.release();
    }
  }

  @Builder
  private Selector(i: number) {
    Button(`0${i + 1}  ${NAMES[i]}`, { type: ButtonType.Normal }).id('poster-' + i)
      .width('100%').height(41).borderRadius(0)
      .backgroundColor(this.selected === i ? '#F6F1E8' : '#282846')
      .fontColor(this.selected === i ? '#292447' : '#F0EEF5')
      .fontSize(14).onClick(() => { void this.select(i); })
  }

  build() {
    Scroll() {
      GridRow({ columns: 12, gutter: 20 }) {
        GridCol({ span: { xs: 12, sm: 4 } }) {
          Column({ space: 12 }) {
            Text('版画资源室').fontSize(25).fontWeight(FontWeight.Bold).fontColor('#FFFAF3')
            Text('PRINT ARCHIVE / 03').fontSize(11).letterSpacing(2).fontColor('#DED8F0')
            Divider().color('#686683').margin({ bottom: 2 })
            this.Selector(0)
            this.Selector(1)
            this.Selector(2)
            Text('从安装包读取 · 资源格式见展签').fontSize(11).fontColor('#DED8F0')
          }.width('100%').alignItems(HorizontalAlign.Start).padding(17).backgroundColor('#282846')
        }
        GridCol({ span: { xs: 12, sm: 8 } }) {
          Column({ space: 8 }) {
            Row() {
              Text(NAMES[this.selected]).fontSize(27).fontWeight(FontWeight.Bold).fontColor('#242132').layoutWeight(1)
              Text('0' + (this.selected + 1)).fontSize(21).fontFamily('monospace').fontColor(ACCENTS[this.selected])
            }.width('100%')
            Text(SERIES[this.selected]).fontSize(13).fontColor('#514955')
            if (this.filename) {
              Image($rawfile(this.filename)).width('100%').aspectRatio(4 / 3).objectFit(ImageFit.Contain)
                .onComplete(() => { this.ready = '渲染就绪'; })
                .onError(() => { this.ready = '图片渲染失败'; })
            }
            Row({ space: 8 }) {
              Text(this.filename || '—').id('file').fontSize(12).fontFamily('monospace').fontColor('#473951').layoutWeight(1)
              Text(this.dimensions).id('dimension').fontSize(12).fontFamily('monospace').fontColor('#473951')
              Text(this.bytes + ' B').id('bytes').fontSize(13).fontWeight(FontWeight.Bold).fontColor(ACCENTS[this.selected])
            }.width('100%').padding({ top: 9, bottom: 7 }).border({ width: { top: 1 }, color: '#C5BDCB' })
            Text(this.ready).id('ready').fontSize(12).fontColor('#514955')
          }.width('100%').alignItems(HorizontalAlign.Start)
        }
      }.width('100%').constraintSize({ maxWidth: 900 }).padding(22)
    }.width('100%').height('100%').align(Alignment.Top).backgroundColor('#F7F3E9')
  }
}

FAQ|换了后缀,清单里为什么还有两份? 查构建输入的根目录。两个目录都被资源规则扫描时,新入口可以正常读新图,旧图也仍会打到包里。清单要能找到多出来的那个路径,定位后再重新构建一次。别改显示文案就认为部署变了。

FAQ|文件变小以后,为什么加载没有更快? 包的体积、读出资源的时间、解码和上屏都有自己的成本。延迟若来自图像解码,文件更小也可能没有线性关系。给同一个展品重复切换,先固定是否已动过缓存,再对照资源读回与最终显示两个点。只跑一次结果不足以区别启动负载。

这一轮为什么没有拿每张图的文件大小替代内存峰值? 解码后的图通常按像素尺寸和实际图像格式占内存。两种归档压缩程度不同,到页面显示时仍可能有相同尺寸。若要解决有图的页面容易被系统回收,应另采打开资源室、连续切三张以及退出后的内存。还要看切换时上一张图何时释放、是否为回退页或缩略图留着。有时问题来自同时打开过多大图,换后缀并不能解决。以安装包命名、归档条目、实际展牌和内存分别作为四项检查,发布时就不会拿一个值替另一项承诺。

FAQ|回退旧图时还需要标记吗? 实际文件名和状态最好能看见。否则回退一直工作而使用者并未发现,安装包改动看似上线,应用却从未读过新版。这里在面板上列明扩展名和实际大小,测试可直接断言期望格式。

总结 发给别人的包小了 32,540 B,三个 WebP 资源都在模拟器逐张读取并显示。以后换下一组图,先用实际 HAP 核对资源进出,再用真实安装结果保护显示。

做回归时,可先固定三张的存在检查,再在安装后抽测一次最快发生的切换和一次高成本的大图,两轮追的错误类型不同。如果应用还有下载后的图片,把安装资源和网络资源的大小另放两列。本文的数据只来自随包交付的展品,应用联网后另存了多少资源需要另量。

清点记录写明包类型与构建来源,才能让另一个人找到同一份可安装测量对象。

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐