生态桌面应用

资源生命周期与诊断

配置应用配额,管理计时器和图片,并用结构化关闭报告与内容安全快照定位问题。

言界 1.0 在创建应用时协商言台 1.0 的配额、拒绝统计、退出幂等、生命周期统计和关闭资源 归零能力。缺少任一必需能力会在创建首个窗口前停止,不退回无界资源管理。

在首次使用前下调配额

配额必须在创建首个窗口、计时器、图片或首次运行前配置:

 应用  界面.应用「有界应用」);

 能力  应用.资源能力();
 生效配额  应用.配置资源配额({
    「资源总数」64
    「窗口数」4
    「计时器数」16
    「图片数」16
    「字体数」8
    「图片字节」67108864
    「字体字节」33554432
    「帧字节」33554432
    「无障碍节点」16384
    「无障碍文字字节」4194304
});

省略字段沿用当前值。配置只能下调,未知字段、非整数、超过言台硬上限或冻结后再次配置 都会以PLATFORM_QUOTA_*稳定错误拒绝。资源关闭后会归还当前用量,但不会解冻或提高上限。 使用应用.资源配额()读取当前复制值,不要修改返回典来尝试改变内部状态。

托管资源

应用.定时器(毫秒,重复,回调)返回托管任务。一次任务正常回调后自动进入完成并归还 配额;重复任务保持运行。任务公开编号、状态、运行中、查询/快照、取消和关闭,回调错误 只使当前任务失败,迟到事件不会重新激活已经结束的任务。

应用.加载图片(字节)返回托管图片资源。查询保留宽、高和字节数,关闭后归还图片数量 与解码后 RGBA 字节配额,并把公开句柄置空。图片控件默认不取得调用者资源的所有权;只有 配置拥有资源时,控件关闭才调用同一幂等关闭路径。

单向关闭报告

窗口和应用都只沿可用 → 关闭中 → 已关闭前进。关闭()返回可 JSON 序列化的报告, 包含状态、成功步骤和全部结构化错误。某一步失败不会阻止后续清理;重复关闭返回原报告, 不再次释放资源或调用回调。

窗口.关闭();
 应用关闭报告  应用.关闭();

生产应用应在运行()返回后调用一次应用关闭,记录全部失败步骤。不要围绕同一个已关闭 对象无限重试;言台根资源已经作为最后兜底尝试回收所有子资源。

内容安全诊断

窗口.诊断快照()应用.诊断快照()返回版本化纯言序值。窗口快照包含布局/语义 脏状态、焦点、捕获、叠层、无障碍摘要、待呈现帧、动画和生命周期;应用快照包含言台事件 队列、资源、帧、无障碍桥、配额、窗口、计时器、图片、主题和监听摘要。

快照不会复制窗口标题、显示器名称、输入框内容、密码值、回调、无障碍文字树或原生句柄, 适合写入结构化日志。计数是进程内累计量,不是持久化格式;监控系统应按时间采样计算差值。 应用关闭后诊断不会再次访问已释放句柄,而是明确报告平台不可用。

完整恢复策略与验收规模见 生命周期指南。 六目标发布门禁执行 1024 轮窗口、计时器和图片资源归零;应用仍需对自己的并发规模、图片 负载、退出保存和目标桌面服务做上线压力测试。