离线包管理

进入APP开放平台 > APP管理,点击一个APP,进入实时发布的离线包管理页面。

添加离线包

点击“添加离线包”按钮,在弹框中填写离线包的ID、名称,并选择一个离线包类型,离线包的类型可以是H5、JSN、LIGHTWEB和MP,点击“确定”,即可新增一个离线包。

离线包的使用

在离线包的列表中有一列地址信息,该地址是根据离线包ID自动生成的,现在可以通过这个地址来访问离线包。APP开发的时候,在native插件的配置文件中做如下配置,APP打包安装后便可以访问到离线包的信息。离线包的版本如果有更新,APP也可以及时收到更新。

module.exports = {
views:{
"index":{
url:"123456.vhost.light.com/index.html"
}
}
};

添加更新包

离线包添加成功后,点击列表中操作列的“发布”按钮,进入到离线包发布详情页面。

点击“添加更新包”,在侧滑框中填写以下信息:

版本号:离线包的版本号,建议格式为x.x.x或x.x.x.x。

更新包上传:离线包的资源文件。

版本范围:至少选择一个客户端类型(iOS或Android),填写APP对应的客户端最低版本和最高版本,只有在此版本范围内的客户端,才能收到新版本离线包,若只填写了最低版本,则大于该版本的APP都可更新到离线包。

更新时机:用户的APP下载离线包的时机,包括仅WIFI下和全部网络,选择全部网络时要注意用户的流量负担,谨慎使用。

最后,勾选“确认信息无误,提交后无法修改”,点击“提交”,即可完成离线包版本的创建。

JSAPI管理

只有在APP的开发设置的JSAPI管理中开启了JSAPI权限控制的APP在添加更新包时才需要选择JSAPI进行授权。
先打开JSAPI管理标签页,为离线包开启授权的JSAPI,再打开发布详情标签页添加更新包,此时只有开启授权的JSAPI才能在该离线包中访问。

离线包发布任务

点击离线包发布详情列表中的“创建发布任务”按钮,成功提交发布信息后,即可完成离线包的发布。一个版本下,同时只能进行一个任务。若要创建新的发布任务,请结束该版本已有的任务。

发布类型

  • 灰度发布:可在表单中配置灰度类型、高级规则,只有符合灰度规则的APP才能接收到该离线包的更新。
  • 正式发布:所有的App都能收到该离线包的更新。

更新策略

  • 异步更新:在启动APP(或将在后台运行的APP切回至前台)时,离线包开始更新,更新完成后再次打开APP才可生效;
  • 同步更新:在启动APP(或将在后台运行的APP切回至前台)时会获取当前平台已发布所有离线包最新版本的信息,打开页面时会判断当前是否有更新,如果有页面会进入加载中状态,更新完成后可显示更新后的正常页面。

发布任务列表如下图,已发布的任务可以暂停或结束。