スイッチ構成を変更して HTML5 コンテナーの動作を変更する - Mobile Platform as a Service

HTML5 コンテナーには多数のスイッチ構成があり、これらを変更することでコンテナーの動作をカスタマイズできます。たとえば、署名検証の構成を使用すると、オフラインパッケージの署名検証を有効化または無効化できます。

スイッチ構成は、以下の 3 つの方法のいずれかで変更できます：

ポータルプロジェクトまたはメインアプリケーションプロジェクトの assets ディレクトリ内にある config フォルダに、組み込みの custom_config.json ファイルを追加します。この方法はバージョン 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 のグローバルインスタンスは 1 つだけです。最後に設定されたインスタンスが優先されます。
H5Utils.setProvider(H5ExtConfigProvider.class.getName(), new H5ExtConfigProviderImpl());

MDS プラットフォームからスイッチ構成を配信します。詳細については、「スイッチ構成管理」をご参照ください。

コンテナースイッチのリスト

以下の表にあるスイッチを使用して、有効にする機能をカスタマイズします。

スイッチ名	目的	説明	デフォルト値
`h5_shouldverifyapp`	署名検証を有効または無効にします。オンライン環境ではこの機能を有効にしてください。デバイスがルート化されていると検出された場合、署名検証は強制的に有効になり、このスイッチ構成は無視されます。	YES に設定すると機能が有効になり、NO に設定すると無効になります。	YES
`TSBS`	没入型タイトルバーを使用するかどうかを指定します。このスイッチは Android にのみ適用されます。	`1` に設定すると使用し、`0` に設定すると使用しません。重要値の `1` と `0` は文字列です。	1
`h5_remote_debug_host`	リモートデバイスでのアプリのデバッグに使用するリモートサーバーアドレスです。	このスイッチを構成すると、リモートデバイスでのアプリのデバッグが有効になります。`h5_remote_debug_host` の値をデバッグに使用するサーバーアドレスに設定します。このスイッチを構成しない場合、リモートデバイスでのアプリのデバッグは無効になります。このスイッチにはデフォルト値はありません。	-
`androidFallbackNetwork`	mPaaS ネットワークライブラリを使用してフォールバックリソースを読み込むかどうかを指定します。	YES に設定すると mPaaS ネットワークライブラリを使用してフォールバックリソースを読み込み、NO に設定するとシステムネットワークライブラリを使用してフォールバックリソースを読み込みます。	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`	混合コンテンツモードを許可します。このモードを有効にすると、セキュリティリスクが生じます。注意して使用してください。説明このスイッチはバージョン 10.1.60 でのみサポートされています。	YES に設定するとモードが許可され、NO に設定すると許可されません。	NO