在建立 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 離線包資訊,即表示離線包建立成功。