资源生命周期与诊断
配置应用配额,管理计时器和图片,并用结构化关闭报告与内容安全快照定位问题。
言界 1.0 在创建应用时协商言台 1.0 的配额、拒绝统计、退出幂等、生命周期统计和关闭资源 归零能力。缺少任一必需能力会在创建首个窗口前停止,不退回无界资源管理。
在首次使用前下调配额
配额必须在创建首个窗口、计时器、图片或首次运行前配置:
定 应用 为 界面.应用(「有界应用」);
定 能力 为 应用.资源能力();
定 生效配额 为 应用.配置资源配额({
「资源总数」:64,
「窗口数」:4,
「计时器数」:16,
「图片数」:16,
「字体数」:8,
「图片字节」:67108864,
「字体字节」:33554432,
「帧字节」:33554432,
「无障碍节点」:16384,
「无障碍文字字节」:4194304
});省略字段沿用当前值。配置只能下调,未知字段、非整数、超过言台硬上限或冻结后再次配置
都会以PLATFORM_QUOTA_*稳定错误拒绝。资源关闭后会归还当前用量,但不会解冻或提高上限。
使用应用.资源配额()读取当前复制值,不要修改返回典来尝试改变内部状态。
托管资源
应用.定时器(毫秒,重复,回调)返回托管任务。一次任务正常回调后自动进入完成并归还
配额;重复任务保持运行。任务公开编号、状态、运行中、查询/快照、取消和关闭,回调错误
只使当前任务失败,迟到事件不会重新激活已经结束的任务。
应用.加载图片(字节)返回托管图片资源。查询保留宽、高和字节数,关闭后归还图片数量
与解码后 RGBA 字节配额,并把公开句柄置空。图片控件默认不取得调用者资源的所有权;只有
配置拥有资源时,控件关闭才调用同一幂等关闭路径。
单向关闭报告
窗口和应用都只沿可用 → 关闭中 → 已关闭前进。关闭()返回可 JSON 序列化的报告,
包含状态、成功步骤和全部结构化错误。某一步失败不会阻止后续清理;重复关闭返回原报告,
不再次释放资源或调用回调。
窗口.关闭();
定 应用关闭报告 为 应用.关闭();生产应用应在运行()返回后调用一次应用关闭,记录全部失败步骤。不要围绕同一个已关闭
对象无限重试;言台根资源已经作为最后兜底尝试回收所有子资源。
内容安全诊断
窗口.诊断快照()和应用.诊断快照()返回版本化纯言序值。窗口快照包含布局/语义
脏状态、焦点、捕获、叠层、无障碍摘要、待呈现帧、动画和生命周期;应用快照包含言台事件
队列、资源、帧、无障碍桥、配额、窗口、计时器、图片、主题和监听摘要。
快照不会复制窗口标题、显示器名称、输入框内容、密码值、回调、无障碍文字树或原生句柄, 适合写入结构化日志。计数是进程内累计量,不是持久化格式;监控系统应按时间采样计算差值。 应用关闭后诊断不会再次访问已释放句柄,而是明确报告平台不可用。
完整恢复策略与验收规模见 生命周期指南。 六目标发布门禁执行 1024 轮窗口、计时器和图片资源归零;应用仍需对自己的并发规模、图片 负载、退出保存和目标桌面服务做上线压力测试。