在创建离线包资源时,您需要填写基本信息和配置信息。
前置任务
您已经在配置管理界面,完成离线包相关配置。详细信息,参见 配置离线包。
关于此任务
在首次上传一个 H5App 的离线包时,您必须选择离线包的类型。一旦选择完成不可更改,每个 H5App 有且只有一个离线包类型。
操作步骤
进入 mPaaS 控制台,完成以下步骤:
- 点击左侧导航栏的 实时发布 > 离线包管理。
- 在打开的离线包列表页,点击 创建 H5App。(如果您已创建 H5App,可忽略此步。)
- 在 新增 H5App 窗口,填写 H5App ID 和 H5App 名称,点击 提交。(如果您已创建 H5App,可忽略此步。)
说明:H5App ID 为 8 位数字。
- 在离线包列表上方,点击 添加离线包,以创建新的离线包。
-
在 基本信息 栏,完成以下配置:
- 资源包类型:选择 全局资源包 或 普通资源包。
- 离线包版本号:填写离线包的版本号,例如 1.0.0.1。
- 文件:上传离线包资源文件,文件格式为
.zip
。 - 客户端范围:选择客户端类型,并填入最低版本和最高版本。
说明:至少选择一个客户端类型。只有在此版本范围内的客户端,才能够得到推送的新版本离线包。iOS 客户端版本需低于客户端工程的 info.plist 文件中的 Product Version 字段。
-
在 配置信息 栏,完成以下配置:
- 主入口 URL:选填,离线包的首页。
说明:需要填写完整的路径名,如:
/www/index.html
,其中,
/www
为您自定义的二级目录的名称。 - 虚拟域名:自动显示配置离线包时填写的虚拟域名。
- 扩展信息:选填,填写页面加载参数,格式为 KV,用逗号(,)分隔多个 KV。
说明:mPaaS 支持配置 H5 离线包的请求时间间隔,可单个配置或全局配置。
- 单个配置:即只对当前离线包配置。可在 扩展信息 中填入
{"asyncReqRate":"1800"}
来设置请求时间间隔。其中1800
代表间隔时长,单位为秒,设置范围为 0 ~ 86400 秒(即 0 ~ 24 小时,0 代表无请求间隔限制)。 - 全局配置:全局配置需在客户端代码中进行配置,请参见 接入 Android 及 接入 iOS。
- 单个配置:即只对当前离线包配置。可在 扩展信息 中填入
- 下载时机:选择用户下载该离线包的时机。
- 若选择 仅 Wi-Fi,则只有在 Wi-Fi 网络时会在后台自动下载离线包。
- 若选择 所有网络都下载,则在非 Wi-Fi 网络时会消耗用户流量自动下载,慎用。
- 安装时机:选择用户安装该离线包的时机。
- 若选择 不预加载,则只有进入离线包或小程序页面时才安装。
- 若选择 预加载,则离线包或小程序下载完成后自动安装。
- 主入口 URL:选填,离线包的首页。
- 点击 提交,完成离线包创建。