生态桌面应用

图片和资源

使用言界 1.0 托管图片、显式所有权、应用配额和幂等关闭。

应用从 PNG 或 JPEG 字节加载图片,格式和像素上限由言台验证,单边最大 16384 像素。 加载图片返回言界托管资源:

定 图片资源 为 应用.加载图片(图片字节);
定 图片控件 为 布局.图片(图片资源);
图片控件.尺寸(320,180);

托管资源公开编号、状态、可用、查询、快照和关闭;查询包含宽、高和解码后字节数。画布 图片命令引用内部同一资源句柄,而不是把像素重复写入每个绘制帧。后端呈现时才解析句柄; 资源关闭后公开句柄置空,后续帧不会继续访问它。

图片控件默认不取得调用者传入资源的所有权。需要让控件关闭时同步释放图片,可在配置中 设置拥有资源;不要同时让调用者和控件假设自己是唯一所有者。两条路径最终进入同一幂等 关闭状态机。

言台句柄由槽位和代际组成:释放资源后,即使槽位被新资源复用,旧句柄也只会返回 PLATFORM_RESOURCE_CLOSED,不能误操作新对象。加载前会检查图片数量与应用剩余图片字节 配额,元数据或创建失败会回滚平台资源,不产生半初始化托管对象。关闭会归还当前用量, 但不会解冻应用配额。

应用关闭会统一清理仍活动的图片并生成结构化报告。诊断快照可核对活动图片、持有字节、 创建/关闭量和资源归零,但不会包含像素、路径或原生句柄,也不是持久化格式。

发布应用时把图片和字体放入项目资源目录,让言包 Bundle 携带并记录摘要;不要在启动热路径依赖网络下载核心界面资源。