全部產品
Search
文件中心

Mobile Platform as a Service:建立 H5 離線包

更新時間:Jul 13, 2024

在建立 H5 離線包資源時,您需要填寫基本資料和配置資訊。

前置任務

您已經在組態管理頁面,完成 H5 離線包相關配置。詳細資料,參見 配置離線包

關於此任務

您可以選擇單個建立 H5 離線包,也可以選擇以大量匯入 H5 離線包檔案的方式一次建立多個離線包。

在首次上傳一個 H5App 的離線包時,您必須選擇離線包的類型。一旦選擇完成不可更改,每個 H5App 有且只有一個離線包類型。

操作步驟

建立單個離線包

進入 mPaaS 控制台,完成以下步驟:

  1. 點擊左側導覽列的 即時發布 > 離線包管理

  2. 在開啟的離線包管理頁面,點擊 建立 H5App。(如果您已建立 H5App,可忽略此步。)

  3. 建立 H5App 視窗,填寫 H5App ID H5App 名稱,點擊 確定。(如果您已建立 H5App,可忽略此步。)

    重要
    • H5App ID 為 8 位元字。

    • 20000196、66666692、68687029、68687209 是 SDK 內建的離線包 ID,H5App ID 建議不要使用,否則會發生衝突。

    • H5App ID 建議不要使用以 666666 或者 20000 開頭的數字。

  4. 在 H5App 列表中,選擇 H5App,然後點擊離線包列表的右上方的 添加離線包 按鈕,建立離線包。

  5. 基本資料 欄,完成以下配置:

    • 資源套件類型:選擇 全域資源套件普通資源套件

      說明

      若使用全域資源套件需要在全域資源套件中將二級目錄名稱修改為 mcube-prod.mpaascloud.com,否則將無法使用即時發布對接的加速能力。

    • 離線包版本號碼:填寫離線包的版本號碼,例如 1.0.0.1。

    • 檔案:上傳離線包資源檔,檔案格式為 .zip

    • 用戶端生效範圍:選擇 App 對應的用戶端類型,並設定版本範圍。只有在此版本範圍內的用戶端,才能夠得到推送的新版本離線包。

      說明
      • 至少選擇一個用戶端類型。若同時選擇 Android 及 iOS,用戶端最高版本原則需保持一致,即兩個用戶端均採用系統預設,或者均輸入自訂值。

      • 最高版本為系統預設時表示支援後續所有新版本,建議採用系統預設,以免在用戶端升級後版本高於填寫的最高版本而使得離線包不生效。

      • iOS 用戶端版本需低於用戶端工程的 info.plist 檔案中的 Product Version 欄位。

  6. 配置資訊 欄,完成以下配置:

    • 主入口 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 網路功能時會消耗使用者流量自動下載,慎用。

    • 安裝時機:選擇使用者安裝該離線包的時機。

      • 若選擇 不預先載入,則只有進入離線包或小程式頁面時才安裝。

      • 若選擇 預先載入,則離線包或小程式下載完成後自動安裝。

  7. 勾選 已確認以上資訊準確,點擊 提交,完成離線包建立。

大量匯入離線包

如果需要建立多個離線包,為避免多個離線包配置時資訊配置出錯,提升發布效率,可選擇以大量匯入的方式進行建立。

  • 匯入後,若離線包所屬的 App 在系統中不存在,將預設建立一個 H5App。

  • 匯入後,若離線包所屬的 App 在系統中已存在,配置完成後,離線包將添加至該 H5App。

進入 mPaaS 控制台,完成以下步驟:

  1. 從左側導覽列進入 即時發布 > 離線包管理 頁面,點擊 大量匯入 H5 離線包

  2. 大量匯入 H5 離線包 視窗中,根據提示上傳 H5 離線包檔案(.zip)。

    說明
    • 大量匯入的離線包檔案大小不能超過 300 MB,且離線包個數不能超過 100。

    • 每個離線包資源檔需以離線包 ID 命名。離線包 ID 為 8 位元字。

  3. 匯入結果頁以列表的形式顯示成功載入的離線包,在匯入結果頁面,點擊 操作 列的 編輯 按鈕,編輯離線包的基本資料。具體配置項解釋,請參考 建立單個離線包

    匯入結果頁面,離線包版本號碼預設遵循以下規則,您可以進行編輯。

    • 若離線包所屬的 App 在系統中不存在,匯入離線包的版本號碼預設為 0.0.0.1。

    • 若離線包所屬的 App 在系統中已存在,匯入離線包的版本號碼預設為最高版本的基礎上 +1。

  4. 編輯完成所有離線包後,勾選 以上資訊提交後不再支援修改,點擊 提交。系統會對提交的離線包資訊進行校正。若校正不通過,頁面會出現錯誤提示;若校正通過,則 H5 離線包管理頁面會展示相應的 H5 離線包資訊,即表示離線包建立成功。

後續步驟

發布離線包