跳到主要内容

ArkTS卡片适配常见问题

ArkTS卡片开发是否支持V2装饰器?如何从V1到V2迁移?

ArkTS卡片开发支持V2装饰器语法(如@ObservedV2@ComponentV2),建议开发者使用V2装饰器替代V1语法进行状态管理,以获得更优的组件渲染性能和状态同步能力。

完整的语法差异对比、迁移步骤及示例代码,请参见官方文档: V1->V2迁移指导概述

如何定位ArkTS卡片白屏问题?

ArkTS卡片白屏问题定位请参考服务卡片显示问题定位指导

ArkTS卡片如何适配深浅色模式?

当前系统存在深浅色两种显示模式,为了给用户更好的使用体验,保障卡片与页面视觉体验一致性,ArkTS卡片支持适配深浅色模式,具体请参考应用深浅色适配

导入particleAbility、audio、camera、media、backgroundTaskManager模块导致应用崩溃问题。

问题现象

导入particleAbility、audio、camera、media、backgroundTaskManager后应用崩溃,FaultLog指向相关调用行。

报错对应的代码行如下:

原因

ArkTS卡片的FormExtensionAbility不支持加载上述模块,参考@ohos.app.form.FormExtensionAbility。强行加载得到的对象是undefined,使用时就会产生JS crash。

解决措施

检查 FormExtensionAbility 的导入链,将涉及上述模块的文件与 ArkTS 卡片使用的文件拆分,避免被 FormExtensionAbility 加载。