# 注意事项

真机调试需要使用Z6A/Z6S,本框架基于快应用 IDE 开发,但是底层实现上与快应用本身有一定区别,接入时要多看框架介绍文档及 demo 示例代码,不能参照快应用官方文档,会造成误解

真机与模拟器有一定的表现差异,完成某个功能、模块或页面后及时在真机运行阶段性测试下:避免开发了一大段代码,模拟器能正常运行,真机上却打不开、逻辑或布局异常的情况

# 打包

快应用 IDE 新版本打包出来的 rpk,里面代码没压缩,而且带着.map 文件会导致 rpk 增大,并且没压缩的文件如果超过 200k 会打不开。用 npm run release 命令打包可以避免

# 真机与模拟器差异

持续更新中

# 组件

  • image:新增了 qrcode 属性可生成二维码,模拟器不支持。
  • image-animator:模拟器不支持。
  • progress:新增了弧形进度条,type 为 horizontal 时设置样式 radius,可变为弧形进度条,模拟器不支持。
  • marquee:scrollamount 值的滚动速度和模拟器会有差别。

# CSS

  • justify-content/align-items 在真机上默认为 flex-start,模拟器默认 center
  • animation 动画存在问题,会导致元素错位,请暂时先用帧动画组件代替。

# JS

  • 真机获取的时间戳是以秒为单位,后三位全是零

# 接口

  • 音频:audio.ontimeupdate 在回调数据中获取 currentTime,而模拟器是通过 audio.currentTime 获取
  • 定时器:真机中使用定时器在应用退出时必须要有清除操作 clearTimeout/clearInterval,或者在未退出之前就已清除
  • 弹窗:message 必须为字符串,不支持其他类型包括数字。

# 框架限制

  • storage 存储:不能超过 128 字节
  • 单个图片大小限制:100KB(超过下载失败),最多会缓存 70 张图,超过会循环缓存,会删除最早缓存的一张
  • 单个文件大小限制:Z6A 10M
  • 文件下载个数限制:不超过 70 个
  • 编译后单个文件不能超过 200KB
  • rpk 安装包不能超过 1M
  • 页面轮询请求的间隔限制 3s 以上