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

Mobile Platform as a Service:HTML5 オフラインパッケージの作成

最終更新日:Feb 05, 2026

HTML5 オフラインパッケージを作成するには、基本情報と構成情報を入力する必要があります。

前提条件

構成管理ページで HTML5 オフラインパッケージを設定しておく必要があります。詳細については、「オフラインパッケージの設定」をご参照ください。

このタスクについて

HTML5 オフラインパッケージは、個別に作成することも、一括インポート機能を使用して一度に複数のパッケージを作成することもできます。

H5App のオフラインパッケージを初めてアップロードするときは、パッケージタイプを選択する必要があります。この選択は後で変更することはできません。各 H5App は 1 つのパッケージタイプしか持つことができません。

操作手順

単一のオフラインパッケージの作成

mPaaS コンソールにログインし、次の手順を実行します。

  1. 左側のナビゲーションウィンドウで、[Mobile Delivery Service] > [オフラインパッケージ管理] を選択します。

  2. [オフラインパッケージ管理] ページで、[HTML5 アプリの作成] をクリックします。(すでに H5App を作成している場合は、このステップをスキップしてください)。

  3. [HTML5 アプリの作成] ウィンドウで、[HTML5 App ID][HTML5 App 名] を入力し、[OK] をクリックします。(すでに H5App を作成している場合は、このステップをスキップしてください)。

    重要
    • H5App ID は 8 桁の数字である必要があります。

    • ID 20000196、66666692、68687029、68687209 はソフトウェア開発キット (SDK) に組み込まれています。競合を避けるため、これらの ID を H5App に使用しないでください。

    • 666666 または 20000 で始まる H5App ID は使用しないでください。

  4. HTML5 アプリリストから目的の HTML5 アプリを選択し、右側の [オフラインパッケージの追加] をクリックします。

  5. [基本情報] セクションで、次のパラメーターを設定します。

    • リソースパッケージタイプ[グローバルリソースパッケージ] または [通常リソースパッケージ] を選択します。

      説明

      グローバルリソースパッケージを使用する場合、リアルタイムリリースドッキングの高速化機能を利用できなくなるため、グローバルリソースパッケージ内の第 2 レベルディレクトリの名前を mcube-prod.mpaascloud.com に変更する必要があります。

    • HTML5 アプリバージョン: オフラインパッケージのバージョン (例: 1.0.0.1) を入力します。

    • ファイル: オフラインパッケージファイルを .zip フォーマットでアップロードします。

    • クライアントバージョン: クライアントのタイプを選択し、バージョン範囲を設定します。バージョン範囲内のクライアントのみが新しいオフラインパッケージを受信できます。

      説明
      • 少なくとも 1 つのクライアントタイプが必要です。Android と iOS の両方を選択した場合は、両方のクライアントが最新バージョンで同じ戦略を採用するようにする必要があります。具体的には、両方のクライアントの最新バージョンを空 (システムデフォルト) にするか、同じ値に設定する必要があります。

      • 最新バージョンを空のままにすると、将来のすべてのバージョンがサポートされます。アップグレードされたクライアントのバージョンが以前に指定されたバージョンよりも高くなった場合にオフラインパッケージが無効になるのを防ぐため、デフォルトに設定することを推奨します。

      • iOS クライアントのバージョンは、プロジェクトの info.plist ファイルの [Product Version] フィールドの値より古い必要があります。

  6. [構成情報] セクションで、次のパラメーターを設定します。

    • メインエントリの URL: オプション。オフラインパッケージのホームページです。

      説明

      /www/index.html のような完全なパスが必要です。ここで、/www はカスタマイズした第 2 レベルディレクトリの名前です。

    • 仮想ドメイン: オフラインパッケージを設定する際に入力した仮想ドメイン名が自動的に表示されます。

    • 拡張情報: オプション。ページの読み込みパラメーターをキーと値 (KV) 形式で入力します。複数の KV ペアはカンマ (,) で区切ります。

      mPaaS プラットフォームでは、HTML5 オフラインパッケージのリクエスト間隔を設定できます。この設定は、単一のオフラインパッケージに適用することも、グローバルに適用することもできます。

      • 単一パッケージの設定: 現在のオフラインパッケージにのみ適用されます。[拡張情報] フィールドに {"asyncReqRate":"1800"} と入力してリクエスト間隔を設定できます。ここで、1800 は間隔を示します。間隔は秒単位で測定され、0 から 86400 秒 (0 から 24 時間) の範囲です。値 0 はリクエスト間隔に制限がないことを示します。

      • グローバル設定: すべてのオフラインパッケージに適用されます。このパラメーターはクライアントコードで指定されます。詳細については、「クイックスタート」および「クイックスタート」をご参照ください。

    • ダウンロード時間: ユーザーがオフラインパッケージをダウンロードする時間を選択します。

      • [Wi-Fi のみ] を選択した場合、オフラインパッケージは Wi-Fi 接続時のみバックグラウンドで自動的にダウンロードされます。

      • [すべてのネットワーク] を選択した場合、Wi-Fi 以外のネットワークでも、ユーザーのモバイルデータを消費してオフラインパッケージが自動的にダウンロードされます。そのため、慎重に設定してください。

    • インストール時間: オフラインパッケージをインストールする時間を選択します。

      • [プリロードしない] を選択した場合、オフラインパッケージは開かれたときにのみインストールされます。

      • [プリロード] を選択した場合、オフラインパッケージはダウンロードされた後、自動的にインストールされます。

  7. [上記の情報が正確であることを確認します] チェックボックスを選択し、[送信] をクリックしてオフラインパッケージの作成を完了します。

オフラインパッケージの一括インポート

一度に複数のオフラインパッケージを作成するには、一括でインポートできます。この方法により、リリース効率が向上し、設定エラーを防ぐことができます。

  • インポート後、オフラインパッケージが属する H5App が存在しない場合、デフォルトで新しい H5App が作成されます。

  • オフラインパッケージが属する H5App がすでに存在する場合、設定後にその H5App にオフラインパッケージが追加されます。

mPaaS コンソールにログインし、次の手順を実行します。

  1. 左側のナビゲーションウィンドウで、[Mobile Delivery Service] > [オフラインパッケージ管理] を選択し、[HTML5 アプリの一括インポート] をクリックします。

  2. [HTML5 アプリの一括インポート] ウィンドウで、プロンプトに従って HTML5 オフラインパッケージファイル (.zip) をアップロードします。

    説明
    • インポートされるオフラインパッケージファイルの合計サイズは 300 MB を超えることはできず、パッケージの数は 100 を超えることはできません。

    • 各オフラインパッケージのリソースファイルには、対応する 8 桁のオフラインパッケージ ID で名前を付ける必要があります。

  3. インポート結果ページには、正常に読み込まれたオフラインパッケージが一覧表示されます。このページで、[操作] 列の [編集] をクリックして、オフラインパッケージの基本情報を編集します。設定項目の説明については、「単一のオフラインパッケージの作成」をご参照ください。

    インポート結果ページでは、オフラインパッケージのバージョン番号はデフォルトで次のルールに従います。バージョン番号は編集できます。

    • オフラインパッケージの H5App が存在しない場合、インポートされたパッケージのバージョン番号はデフォルトで 0.0.0.1 になります。

    • オフラインパッケージの H5App がすでに存在する場合、インポートされたパッケージのバージョン番号は、既存の最高バージョンに基づいて次の増分バージョン番号にデフォルトで設定されます。

  4. すべてのオフラインパッケージの編集が完了したら、[送信後に情報は変更できません] チェックボックスを選択し、[送信] をクリックします。システムは送信された情報を検証します。検証に失敗すると、エラーメッセージが表示されます。検証に合格すると、HTML5 オフラインパッケージ情報が [オフラインパッケージ管理] ページに表示され、パッケージが正常に作成されたことを示します。

次のステップ

オフラインパッケージのリリース