全部產品
Search
文件中心

Mobile Platform as a Service:配置 H5 容器

更新時間:Jul 26, 2024

H5 容器內有許多開關配置,通過修改開關配置,能夠改變容器的特定行為,比如可以通過驗簽配置來開啟或關閉離線包簽名校正。

修改開關配置有以下三種方式:

  • 內建 custom_config.json 至 portal 工程或應用主工程 assets 目錄下的 config 檔案夾,該方法僅適用於 10.1.60 及以上版本。custom_config.json 的檔案格式如下:

    [
    {
      "value": "NO",
      "key": "h5_shouldverifyapp"
    },
    {
      "value": "0",
      "key": "TSBS"
    }
    ]
  • 使用 H5ExtConfigProvider 在代碼中配置開關,該方法僅適用於 10.1.60 以下版本。H5ExtConfigProvider 使用說明如下:

    public class H5ExtConfigProviderImpl implements H5ExtConfigProvider {
      @Override
      public String getConfig(String key) {
          if ("h5_shouldverifyapp".equalsIgnoreCase(key)) {
              return "YES";
          } else if ("TSBS".equalsIgnoreCase(key)) {
              return "0";
          }
          return null;
      }
    }
    // 建議在啟動時調用,全域只生效一個 H5ExtConfigProvider 的執行個體,以最後設定的執行個體為準
    H5Utils.setProvider(H5ExtConfigProvider.class.getName(), new H5ExtConfigProviderImpl());
  • 通過 MDS 平台下發開關配置,參見 開關組態管理

容器開關列表

您可通過下表中的開關,來自訂是否使用對應功能。

開關名稱

用途

說明

預設值

h5_shouldverifyapp

開啟或關閉驗簽。建議線上開啟,當手機被認為是 root 手機時,會強制開啟驗簽,此時開關配置不生效。

YES 表示開啟,NO 表示關閉。

YES

TSBS

是否使用沈浸式標題列,僅適用於 Android。

“1”表示使用,“0”表示不使用。

重要

此處的“1”和“0”為字串形式。

1

h5_remote_debug_host

真機調試遠程伺服器位址。

  • 如果配置,表示開啟了遠程真機調試。調試用伺服器位址需要配置給 h5_remote_debug_host

  • 如果不配置,即在代碼中不體現,表示不使用遠程真機進行調試,也無預設值。

-

androidFallbackNetwork

是否採用 mPaaS 網路程式庫方式載入 fallback 資源。

YES 表示使用 mpaas 網路程式庫載入 fallback 資源,NO 表示使用系統網路程式庫載入 fallback 資源。

YES

mp_h5_push_window_use_activity

調用 pushWindow 時是否強制啟動新的 Activity。

YES 表示啟用, 其他值表示不啟用。

NO

mp_ta_showOptionMenu

是否顯示小程式右上方選項菜單。

說明

此配置僅在發布小程式時選擇是否顯示右上方菜單時有效。

YES 表示顯示,其他值表示不顯示。

NO

mp_ta_showShareMenuItem

是否顯示小程式右上方選項菜單中的分享選項。

YES 表示顯示,其他值表示不顯示。

NO

mp_ta_use_orginal_mini_nagivationbar

小程式是否使用內建導覽列。

YES 表示使用,其他值表示不使用。

YES

h5_CORSWhiteList

網域名稱白名單,該網域名稱下的離線資源可被跨域訪問。

說明

對於線上請求的資源,仍需資源服務端開啟正確的跨網域設定。

內容格式為 JSON 數組,特殊字元要求轉義,樣本:{ "value": "[\"oss-cn-hangzhou.aliyuncs.com\"]", "key": "h5_CORSWhiteList" }

mp_h5_allow_mix_content

允許 Mixed Content 模式,開啟此模式有安全風險,請謹慎考慮先。

說明

此開關僅在 10.1.60 版本中支援。

YES 表示允許, NO 表示不允許。

NO