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 平台下發開關配置,參見 開關組態管理。
容器開關列表
您可通過下表中的開關,來自訂是否使用對應功能。
開關名稱 | 用途 | 說明 | 預設值 |
| 開啟或關閉驗簽。建議線上開啟,當手機被認為是 root 手機時,會強制開啟驗簽,此時開關配置不生效。 | YES 表示開啟,NO 表示關閉。 | YES |
| 是否使用沈浸式標題列,僅適用於 Android。 | “1”表示使用,“0”表示不使用。 重要 此處的“1”和“0”為字串形式。 | 1 |
| 真機調試遠程伺服器位址。 |
| - |
| 是否採用 mPaaS 網路程式庫方式載入 fallback 資源。 | YES 表示使用 mpaas 網路程式庫載入 fallback 資源,NO 表示使用系統網路程式庫載入 fallback 資源。 | YES |
| 調用 pushWindow 時是否強制啟動新的 Activity。 | YES 表示啟用, 其他值表示不啟用。 | NO |
| 是否顯示小程式右上方選項菜單。 說明 此配置僅在發布小程式時選擇是否顯示右上方菜單時有效。 | YES 表示顯示,其他值表示不顯示。 | NO |
| 是否顯示小程式右上方選項菜單中的分享選項。 | YES 表示顯示,其他值表示不顯示。 | NO |
| 小程式是否使用內建導覽列。 | YES 表示使用,其他值表示不使用。 | YES |
| 網域名稱白名單,該網域名稱下的離線資源可被跨域訪問。 說明 對於線上請求的資源,仍需資源服務端開啟正確的跨網域設定。 | 內容格式為 JSON 數組,特殊字元要求轉義,樣本: | 空 |
| 允許 Mixed Content 模式,開啟此模式有安全風險,請謹慎考慮先。 說明 此開關僅在 10.1.60 版本中支援。 | YES 表示允許, NO 表示不允許。 | NO |