このページは Cloud Translation API によって翻訳されました。

Android 上の WebAPK

ユーザーが Android のホーム画面にプログレッシブウェブアプリを追加すると、Chrome によって APK（WebAPK と呼ばれることもあります）が自動的に生成されます。APK 経由でインストールすると、アプリをアプリランチャーや Android のアプリ設定に表示したり、一連のインテントフィルタを登録したりできます。

Pete LePage

Android で PWA をインストールすると、ユーザーのホーム画面にプログレッシブウェブアプリを追加するだけではありません。Chrome は、アプリの特別な APK を自動的に生成してインストールします。これを WebAPK と呼ぶこともあります。APK を介してインストールされるため、アプリをアプリランチャー、Android のアプリ設定に表示し、インテントフィルタのセットを登録できます。

WebAPK を生成するために、Chrome はウェブアプリマニフェストなどのメタデータを参照します。マニフェストの更新が検出されると、Chrome は新しい APK を生成する必要があります。

Android インテントフィルタ

プログレッシブウェブアプリが Android にインストールされると、アプリのスコープ内のすべての URL に対して一連のインテントフィルタが登録されます。ユーザーがアプリのスコープ内のリンクをクリックすると、ブラウザのタブではなくアプリが開きます。

次の部分的な manifest.json について考えてみましょう。

"start_url": "/",
"display": "standalone",

これを使用しているウェブアプリをアプリランチャーから起動すると、https://example.com/ がブラウザクロムなしのスタンドアロンアプリとして開きます。

WebAPK には次のインテントフィルタが含まれます。

<intent-filter>
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.DEFAULT" />
  <category android:name="android.intent.category.BROWSABLE" />
  <data
    android:scheme="https"
    android:host="example.com"
    android:pathPrefix="/" />
</intent-filter>

ユーザーがインストール済みのアプリ内のリンクをクリックして https://example.com/read に移動すると、そのリンクはインテントによってキャッチされ、Progressive Web App で開かれます。

`scope` を使用してインテントフィルタを制限する

プログレッシブウェブアプリでサイト内のすべての URL を処理しないようにするには、ウェブアプリマニフェストに scope プロパティを追加します。scope プロパティは、URL が origin + scope と一致する場合にのみウェブアプリを開くよう Android に指示します。これにより、アプリで処理される URL とブラウザで開く URL を制御できます。これは、アプリとアプリ以外のコンテンツが同じドメインにある場合に便利です。

次の部分的な manifest.json について考えてみましょう。

"scope": "/app/",
"start_url": "/app/",
"display": "standalone",

アプリランチャーから起動すると、https://example.com/app/ はブラウザ Chrome なしでスタンドアロンアプリとして開きます。

生成された WebAPK には、前回と同様にインテントフィルタが含まれますが、APK の AndroidManifest.xml に異なる android:pathPrefix 属性が含まれます。

<intent-filter>
  <action android:name="android.intent.action.VIEW" />
  <category android:name="android.intent.category.DEFAULT" />
  <category android:name="android.intent.category.BROWSABLE" />
  <data
    android:scheme="https"
    android:host="example.com"
    android:pathPrefix="/app/" />
</intent-filter>

例をいくつか見てみましょう。

すべきこと

https://example.com/app/ - /app/ 内

すべきこと

https://example.com/app/read/book - /app/ 以内

すべきでないこと

https://example.com/help/ - /app/ に含まれない

すべきでないこと

https://example.com/about/ - /app/ に含まれない

scope の詳細、設定しない場合の影響、アプリのスコープの定義に使用する方法については、scope をご覧ください。

権限の管理

権限は他のウェブアプリと同じように機能し、インストール時にリクエストすることはできません。代わりに、実行時にリクエストする必要があります。理想的には、本当に必要な場合にのみリクエストします。たとえば、初回読み込み時にカメラの権限をリクエストするのではなく、ユーザーが写真を撮ろうとするまで待機します。

ストレージとアプリの状態の管理

プログレッシブウェブアプリは APK でインストールされますが、Chrome は現在のプロファイルを使用してデータを保存し、分離されることはありません。これにより、ブラウザとインストール済みアプリ間でエクスペリエンスを共有できます。Cookie は共有され、アクティブになります。すべてのクライアントサイドストレージにアクセスでき、サービスワーカーがインストールされ、すぐに使用できるようになります。

WebAPK の更新

WebAPK の更新方法に関する情報は、Chrome でウェブアプリマニフェストの更新を処理する方法に移動しました。

よくある質問

スプラッシュ画面の生成に使用されるアイコンはどれですか？:: スプラッシュ画面には、192 ピクセルおよび 512 ピクセルのアイコンを 2 つ以上用意することをおすすめします。スプラッシュ画面のアイコンが小さすぎるというご意見をいただきましたChrome 71 以降で生成された WebAPK では、スプラッシュ画面に大きなアイコンが表示されます。推奨アイコンが指定されている限り、対応は必要ありません。
ユーザーがサイトのネイティブアプリをすでにインストールしている場合はどうなりますか？: 現在提供されている「ホーム画面に追加」機能と同様に、ユーザーはネイティブアプリに依存しないサイトを追加できます。ユーザーが両方をインストールする可能性がある場合は、サイトのアイコンや名前をネイティブアプリと区別することをおすすめします。
ユーザーが Chrome のキャッシュを消去すると、インストール済みのサイトのストレージも消去されますか？: はい。
新しいデバイスに切り替えると、アプリは再インストールされますか？: 現時点ではできませんが、重要な機能であると考えており、実現に向けて調査を進めています。
権限はどのように処理されますか？Chrome のプロンプトや Android のプロンプトは表示されますか？: 権限は、引き続き Chrome で管理されます。ユーザーには、権限を付与するための Chrome プロンプトが表示され、Chrome の設定で権限を編集できるようになります。
この機能はどのバージョンの Android で利用できますか？: プログレッシブウェブアプリは、Chrome for Android を実行するすべてのバージョンの Android（Jelly Bean 以降）にインストールできます。
WebView は使用されますか？: いいえ。サイトはユーザーが追加した Chrome のバージョンで開きます。
作成した APK を Google Play ストアにアップロードできますか？: いいえ。独自の APK をアップロードする場合は、Trusted Web Activities をご覧ください。
これらのアプリは Google Play ストアに登録されていますか？: いいえ。Google Play ストアに掲載する独自の APK をアップロードする場合は、信頼できるウェブアクティビティをご覧ください。
Android 版の別のブラウザのデベロッパーですが、このシームレスなインストールプロセスを利用できますか？:: 現在、解決に向けて取り組んでおります。Google は、Android のすべてのブラウザでこの機能を利用できるように取り組んでおります。詳細については、近日中に発表いたします。