mam

概述

mam模块提供版本更新、云修复、自定义事件上报等功能。

对于版本更新，模块默认会自动检测和提示，如果想手动检测更新，可以在config.xml里配置autoUpdate为false，使用checkUpdate方法检测更新。

对于云修复，如果config.xml里面配置smartUpdate为true，那么模块将自动完成云修复的检测和修复过程。如果想手动检测，可以配置smartUpdate为false，使用checkSmartUpdate方法检测更新，检测到更新后使用startSmartUpdate方法来完成更新。

checkUpdate

检测当前版本是否有更新或者被强制关闭

checkUpdate(callback(ret, err))

ret：

  • 类型：JSON 对象

内部字段：

err：

内部字段：

  2.     msg:””    //错误描述
  3. }

示例代码

  1. var mam = api.require('mam');
  2. mam.checkUpdate(function(ret, err){
  3.     if (ret) {
  4.         alert(JSON.stringify(ret));
  5.     } else {
  6.         alert(JSON.stringify(err));
  7.     }
  8. });

补充说明

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

checkSmartUpdate

检测是否有云修复更新，只在config.xml里面配置smartUpdate为false有效

checkSmartUpdate(callback(ret, err))

ret：

  • 类型：JSON 对象

内部字段：

  1. {
  3.         incNo:,            //云修复包序号
  4.         silent:,            //是否是静默更新，布尔类型
  5.         extra:,            //更新备注，字符串类型
  6.     }]
  7. }

示例代码

  1. var mam = api.require('mam');
  2.     if (ret) {
  3.         alert(JSON.stringify(ret));
  4.     } else {
  5.         alert(JSON.stringify(err));
  7. });

可用性

iOS系统，Android系统

可提供的1.0.1及更高版本

startSmartUpdate

开始云修复更新，更新完成后建议调用api.rebootApp方法热重启。只在config.xml里面配置smartUpdate为false有效

callback(ret, err)

ret：

  • 类型：JSON 对象

内部字段：

  1. var mam = api.require('mam');
  2. mam.startSmartUpdate(function(ret, err){
  3.     if (ret) {
  4.         alert(JSON.stringify(ret));
  5.     } else {
  6.         alert(JSON.stringify(err));
  7.     }
  8. });

可用性

iOS系统，Android系统

可提供的1.0.1及更高版本

addEvent

添加自定义事件，用于后端统计

addEvent({params})

params

name：

  • 类型：字符串
  • 默认值：无
  • 描述：事件名称，不能为空

示例代码

  1. var mam = api.require('mam');
  2. mam.addEvent({
  3. });

iOS系统，Android系统

可提供的1.0.0及更高版本