すべてのプロダクト
Search
ドキュメントセンター

Mobile Platform as a Service:HTML5 コンテナー構成

最終更新日:Jan 17, 2025

HTML5 コンテナーには、多くのスイッチ構成があります。スイッチ構成を変更することで、コンテナーの特定の動作を変更できます。たとえば、オフラインパッケージの署名検証は、検証構成によってオンまたはオフにできます。

スイッチ構成を変更するには、次の 3 つの方法があります。

  • 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 を呼び出すときに新しいアクティビティを強制的に開始するかどうか。

YES は有効、その他の値は無効を意味します。

NO

mp_ta_showOptionMenu

ミニプログラムの右上隅にオプションメニューを表示するかどうか。

説明

この構成は、ミニプログラムのリリース時に右上のメニューを表示するかどうかを選択した場合にのみ有効です。

YES は表示、その他の値は非表示を意味します。

NO

mp_ta_showShareMenuItem

ミニプログラムの右上隅にあるオプションメニューに共有オプションを表示するかどうか。

YES は表示、その他の値は非表示を意味します。

NO

mp_ta_use_orginal_mini_nagivationbar

ミニプログラムの組み込みナビゲーションバーを使用するかどうか。

YES は使用、NO は不使用を意味します。

YES

h5_CORSWhiteList

ドメイン名ホワイトリスト。ドメイン名の下にあるオフラインリソースには、クロスドメインでアクセスできます。

説明

オンラインでリクエストされたリソースの場合、リソースサーバーで正しいクロスドメイン設定を有効にする必要があります。

コンテンツは JSON 配列で、特殊文字はエスケープする必要があります。例: { "value": "[\"oss-cn-hangzhou.aliyuncs.com\"]", "key": "h5_CORSWhiteList" }

Null

mp_h5_allow_mix_content

混在コンテンツモードを許可します。このモードを有効にすると、潜在的なセキュリティリスクがある可能性がありますので、注意して操作してください。

説明

このスイッチはバージョン 10.1.60 でのみサポートされています。

YES は許可、NO は不許可を意味します。

NO