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

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

最終更新日:Jan 17, 2025

さまざまな要件に基づいて、異なるビジネスをオフラインパッケージにカプセル化し、リリースプラットフォームを介してパッケージを配布して、クライアント側リソースを更新できます。

オフラインパッケージの生成には、主に次の 2 つのステップが含まれます。

  1. フロントエンド .zip パッケージを作成する

  2. オンラインで .amr パッケージを生成する

フロントエンド .zip パッケージを作成する

オフラインパッケージが使用されるシナリオに応じて、構成パスは次の 2 つのタイプに分けられます。

説明
  • グローバルリソースパッケージと通常のリソースパッケージは、同じ H5 オフラインパッケージに共存できません。

  • オフラインパッケージ ID(つまり、以下で説明する最上位ディレクトリ)は 8 桁の数字である必要があります。

グローバルリソースパッケージ

他の通常のリソースパッケージによって参照される共通リソースは、グローバルリソースパッケージに配置できます。パッケージ内のリソースパスは、次のルールで指定する必要があります。

  • 第 1 レベルのディレクトリ:グローバルリソースパッケージの ID。例:77777777

  • 第 2 レベルのディレクトリ:リソースにアクセスできるサーバー ドメイン名アドレスを指します。

    • パブリッククラウドの場合:パブリッククラウドでは、第 2 レベルのディレクトリはmcube-prod.mpaascloud.com として固定する必要があります。そうしないと、MDS ドッキングのアクセラレーション機能を使用できません。

    • プライベートクラウドの場合:プライベートクラウドにデプロイされている mdsweb サーバーのドメイン名アドレスを問い合わせてください。

  • 第 3 レベルのディレクトリ:appId_workspaceId。例:53E5279071442_test

  • 第 3 レベル以降のディレクトリは、ビジネスでカスタマイズされたパブリックリソースファイルです。パブリックリソースファイルのフォルダ名、ファイル名、およびファイルには、特殊文字を使用しないでください。特殊文字とは、urlencode 関数によって変換される文字です。

上記のルールに従ってリソースファイルを整理した後、次の形式でリソースファイルのパスをすばやく見つけることができます。

  • パブリッククラウド上のリソースファイル:http://ドメイン名/appID_workspace/リソースファイルパス

  • プライベートクラウド上のリソースファイル:http://ドメイン名/mcube/appID_workspace/リソースファイルパス

    重要

    プライベートクラウド上のリソースファイルの場合、ファイルパス内の第 2 レベルのディレクトリ(サーバー ドメイン名)の後に/mcube を追加する必要があります。

    プライベートクラウドでは、第 2 レベルのディレクトリは、プライベートクラウドにデプロイされている mdsweb サーバーのドメイン名です。mdsweb-outer.alipay.net を例にとると、リソースファイルcommon.js のパスはhttps://mdsweb-outer.alipay.net/mcube/53E5279071442_test/common.js です。

    image.png

説明
  • パブリックリソースの絶対長は 100 文字を超えてはなりません。超えると、クライアントがリソースの読み込みに失敗し、ページが空白になる可能性があります。

  • サーバーはグローバルリソースパッケージのバージョンを制御しません。実際のニーズに応じて、第 3 レベルのディレクトリの後にファイルディレクトリ構造を追加することで、バージョンをカスタマイズできます。

  • プライベートクラウドで、サーバーが使用するファイルストレージ形式が HDFS または AFS の場合、上記の第 3 レベルのディレクトリの前にディレクトリを追加する必要があります。新しいディレクトリ名は、mdsweb サーバーのストレージスペース(バケット)の名前です。

  • パブリックリソースを参照するには、通常のオフラインパッケージを介してグローバルリソースパッケージのコンテンツにアクセスすることを意味するため、アクセス パスは絶対パスである必要があります。例:https://mcube-prod.oss-cn-hangzhou.aliyuncs.com/53E5279071442_test/common.js

image.png

通常のリソースパッケージ

ビジネスに基づいて、HTML、CSS、JavaScript などの関連するフロントエンドリソースをオフラインパッケージに配置できます。ディレクトリ構造は次のとおりです。

  • 第 1 レベルのディレクトリ:通常のリソースパッケージの ID。例:20171228

  • 第 2 レベル以降のディレクトリは、ビジネスでカスタマイズされたリソースファイルです。すべてのフロントエンドファイルを/www などの統一ディレクトリに保存し、現在のオフラインパッケージでデフォルトで開かれるメインエントリファイルを/www/index.html などに設定することをお勧めします。

    image.png

.zip パッケージを生成する

リソースパッケージのパスを構成した後、appId が配置されているディレクトリ全体を.zip パッケージに直接圧縮できます。

image.png

オンラインで .amr パッケージを生成する

mPaaS コンソールにログインし、モバイル配信サービスオフライン パッケージを管理する.zip.amrモバイル配信サービス > オフラインパッケージを作成する > に移動し、前のステップで生成した パッケージを MDS プラットフォームにアップロードして、 パッケージを生成します。詳細な手順については、「」をご参照ください。

重要
  • オフライン パッケージを作成する場合、iOS クライアントの最小バージョンは、info.plist ファイルの [製品バージョン] フィールドよりも低い必要があります。iOS クライアントの最小バージョンを 1.0.0 に設定することをお勧めします。

  • 製品バージョンinfo.plist ファイルの バンドル バージョン文字列(短縮形) は、 の値と一致している必要があります。そうでない場合、オフラインパッケージが有効にならない可能性があります。