ウェブアプリマニフェストがインストール可能性の要件を満たしていない

公開日 更新日

翻訳先言語: English, Español, Português, 한국어, 中文, Pусский

インストール可能性は、プログレッシブウェブアプリ (PWA) の基本的な要件です。ユーザーに PWA のインストールを促すことで、ユーザーが PWA をホーム画面に追加できるようにします。ユーザーは、ホーム画面に追加するアプリをそれ以外のアプリよりも頻繁に利用します。

ウェブアプリマニフェストには、アプリをインストール可能にするための重要な情報が含まれています。

Lighthouse によるウェブアプリマニフェスト監査が失敗する原因

Lighthouse は、インストール可能性の最低要件を満たすウェブアプリマニフェストがないページをフラグします。

ユーザーがホーム画面からウェブアプリをインストールできないことを示す Lighthouse 監査

以下のプロパティがないページのマニフェストは、監査は失敗します。

  • short_name または name プロパティ
  • 192x192 ピクセルと 512x512 ピクセルのアイコンを含む icons プロパティ
  • start_url プロパティ
  • fullscreenstandalone、または minimal-ui に設定された display プロパティ
  • true 以外の値に設定された prefer_related_applications プロパティ。
Caution

アプリをインストール可能にするには、ウェブアプリマニフェストが必要ですが、それだけでは不十分です。インストール可能性の全要件を満たす方法については、Discover what it takes to be installable (インストール可能にする方法について) と題した記事を参照してください。

In the Lighthouse report UI the full PWA badge is given when you pass all of the audits in all of the PWA subcategories (Fast and reliable, Installable, and PWA optimized).

PWA をインストール可能にする方法

上述した要件を満たすマニフェストがアプリにあることを確認してください。 PWA の作成について詳しくは、Installable コレクションを参照してください。

PWA がインストール可能であることを確認する方法

Chrome の場合

アプリがインストール可能性の最低要件を満たしている場合、Chrome はbeforeinstallprompt イベントを発生させます。このイベントを使用して、ユーザーに PWA のインストールを促すことができます。

Codelab

Chrome でアプリをインストール可能にする方法については、コードラボの Make it installable で紹介されています。

他のブラウザの場合

他のブラウザは、インストールの条件および beforeinstallprompt イベントをトリガーする条件が異なります。完全な詳細については、それぞれのサイトを確認してください。

リソース

最終更新日: 記事を改善する

We serve cookies on this site to analyze traffic, remember your preferences, and optimize your experience.