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 |