在創建 H5 離線包資源時,您需要填寫基本信息和配置信息。
前置任務
您已經在配置管理頁面,完成 H5 離線包相關配置。詳細信息,參見 配置離線包。
關于此任務
您可以選擇單個創建 H5 離線包,也可以選擇以批量導入 H5 離線包文件的方式一次創建多個離線包。
在首次上傳一個 H5App 的離線包時,您必須選擇離線包的類型。一旦選擇完成不可更改,每個 H5App 有且只有一個離線包類型。
操作步驟
創建單個離線包
進入 mPaaS 控制臺,完成以下步驟:
點擊左側導航欄的 實時發布 > 離線包管理。
在打開的離線包管理頁面,點擊 新建 H5App。(如果您已創建 H5App,可忽略此步。)
在 新建 H5App 窗口,填寫 H5App ID 和 H5App 名稱,點擊 確定。(如果您已創建 H5App,可忽略此步。)
重要H5App ID 為 8 位數字。
20000196、66666692、68687029、68687209 是 SDK 內置的離線包 ID,H5App ID 建議不要使用,否則會發生沖突。
H5App ID 建議不要使用以 666666 或者 20000 開頭的數字。
在 H5App 列表中,選擇 H5App,然后點擊離線包列表的右上方的 添加離線包 按鈕,創建離線包。
在 基本信息 欄,完成以下配置:
資源包類型:選擇 全局資源包 或 普通資源包。
說明若使用全局資源包需要在全局資源包中將二級目錄名稱修改為 mcube-prod.mpaascloud.com,否則將無法使用實時發布對接的加速能力。
離線包版本號:填寫離線包的版本號,例如 1.0.0.1。
文件:上傳離線包資源文件,文件格式為
.zip
。客戶端生效范圍:選擇 App 對應的客戶端類型,并設置版本范圍。只有在此版本范圍內的客戶端,才能夠得到推送的新版本離線包。
說明至少選擇一個客戶端類型。若同時選擇 Android 及 iOS,客戶端最高版本策略需保持一致,即兩個客戶端均采用系統默認,或者均輸入自定義值。
最高版本為系統默認時表示支持后續所有新版本,建議采用系統默認,以免在客戶端升級后版本高于填寫的最高版本而使得離線包不生效。
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 網絡時會消耗用戶流量自動下載,慎用。
安裝時機:選擇用戶安裝該離線包的時機。
若選擇 不預加載,則只有進入離線包或小程序頁面時才安裝。
若選擇 預加載,則離線包或小程序下載完成后自動安裝。
勾選 已確認以上信息準確,點擊 提交,完成離線包創建。
批量導入離線包
如果需要創建多個離線包,為避免多個離線包配置時信息配置出錯,提升發布效率,可選擇以批量導入的方式進行創建。
導入后,若離線包所屬的 App 在系統中不存在,將默認創建一個 H5App。
導入后,若離線包所屬的 App 在系統中已存在,配置完成后,離線包將添加至該 H5App。
進入 mPaaS 控制臺,完成以下步驟:
從左側導航欄進入 實時發布 > 離線包管理 頁面,點擊 批量導入 H5 離線包。
在 批量導入 H5 離線包 窗口中,根據提示上傳 H5 離線包文件(.zip)。
說明批量導入的離線包文件大小不能超過 300 MB,且離線包個數不能超過 100。
每個離線包資源文件需以離線包 ID 命名。離線包 ID 為 8 位數字。
導入結果頁以列表的形式顯示成功加載的離線包,在導入結果頁面,點擊 操作 列的 編輯 按鈕,編輯離線包的基本信息。具體配置項解釋,請參考 創建單個離線包。
導入結果頁面,離線包版本號默認遵循以下規則,您可以進行編輯。
若離線包所屬的 App 在系統中不存在,導入離線包的版本號默認為 0.0.0.1。
若離線包所屬的 App 在系統中已存在,導入離線包的版本號默認為最高版本的基礎上 +1。
編輯完成所有離線包后,勾選 以上信息提交后不再支持修改,點擊 提交。系統會對提交的離線包信息進行校驗。若校驗不通過,頁面會出現錯誤提示;若校驗通過,則 H5 離線包管理頁面會展示相應的 H5 離線包信息,即表示離線包創建成功。