アプリを Wear OS 4 での動作変更に対応させる

Wear OS 4 は Android 13（API レベル 33）をベースとしており、Android 13 には複数のバージョンがあります。 Wear OS 3 がベースとするバージョン（Android 11（API レベル 30））よりも高い。 そのため、Wear OS 4 向けに Wear OS アプリを準備する場合、以下を行う必要があります。 Android 12 のすべてのアプリに影響するシステム動作変更 Android 13。

このバージョンの Wear OS に対するアプリの互換性をさらに高めるには、 Android 13（API レベル 33）をターゲットとする。

権限に対する変更

権限に関連する次の変更は、 Wear OS 4 以降を搭載したデバイスの Wear OS アプリ。

通知権限

[許可] オプションがダイアログの最初のボタン
図 1. Wear OS アプリに対して通知の送信を許可するようユーザーに求めるシステム権限ダイアログ。ユーザーは [許可] または [許可しない] を選択できます。

ほとんどの場合、ユーザーはアプリに対して通知に関する実行時の権限を付与する必要があります。この通知には、アプリから送信される進行中のアクティビティの通知も含まれます。

注: 通知権限は、ブリッジ通知や、メディア セッション関連などの除外されている特定のユースケースには適用されません。

Wear OS 4 以降を搭載したデバイスにユーザーがアプリをインストールすると、 アプリの通知はデフォルトでオフになっています。ローカル通知を投稿する前に、 進行中のアクティビティを開始したり、アプリに投稿が許可されているかどうかを確認する areNotificationsEnabled() を呼び出して、通知を受け取ります。この方法で true が返された場合、アプリは通知を表示できます。アプリに 実行されていない場合、これらの通知は通知なく失敗します。 例外がスローされます。

アプリで POST_NOTIFICATIONS 権限をリクエストすると、図 1 のようなシステム権限ダイアログが表示されます。

バックグラウンド ボディセンサー権限

Wear OS 4 以降を搭載するデバイスでは、ユーザーがアプリに権限を付与する必要があります 心拍数などの一般的なボディセンサーから、 説明します。

詳しくは、ボディセンサー データへのバックグラウンドでのアクセスをリクエストするためのガイドをご覧ください。

おおよその位置情報の利用権限

Wear OS 4 以降を搭載したデバイスでは、ユーザーは おおよその位置情報のみを取得できます。これは、アプリが ACCESS_FINE_LOCATION の実行時の権限。

利用を許可されたのがおおよその位置情報だけでも、アプリの主なユースケース（ランニング ルートの表示など）に対応できることを確認します。特に、Wear OS でヘルスサービスを使用する場合は、位置の誤差を考慮してください。

詳しくは、ユーザーがおおよその位置情報の利用権限のみを許可できる方法をご覧ください。

アプリ コンポーネントとナビゲーションに対する変更

アプリ コンポーネントとナビゲーションに関連する次の変更は、可能性が高いといえます

インテント フィルタで一致しないインテントをブロックする

別のアプリのエクスポートされたコンポーネントにアプリがインテントを送信すると、 Android 13 以降をターゲットとしている場合、一致した場合にのみ、そのインテントが配信されます。 受信側アプリの <intent-filter> 要素

詳しくは、インテントと他のアプリのインテント フィルタを一致させる方法をご覧ください。

ルート ランチャー アクティビティの動作

ランチャー アクティビティで ACTION_MAIN と CATEGORY_LAUNCHER の両方を含むインテント フィルタを宣言している場合、それはタスクのルートにあります。

ユーザーがこの種のランチャー アクティビティから以前の画面に移動した場合、ランチャー アクティビティは終了せず、バックグラウンドに移ります。

この変更について詳しくは、ルート ランチャー アクティビティとアクティビティのライフサイクルをご覧ください。

Android アプリリンクの検証方法がいくつか変更されます。具体的には、特定のドメインの URL がアプリ内のコンテンツを直接開くように明示した場合、適用されるインテント フィルタ構文がより厳密になります。この変更によりアプリのリンク処理の信頼性が向上し、アプリ デベロッパーやエンドユーザーによる制御の幅が広がります。

宣言の信頼性をテストするには、ドメインの検証を手動で呼び出します。

システム アラート ウィンドウの UI の削除

Wear OS 4 では、SYSTEM_ALERT_WINDOWを付与するためのシステム UI が削除されます。 付与します。この UI は、Wear OS 3 以前を搭載した一部のデバイスで利用できます。

ACTION_MANAGE_OVERLAY_PERMISSION を使用してユーザーを設定ページに誘導し、他のアプリの上にアプリを表示できるようにする場合は、アプリのロジックを更新してください。たとえば、重要なメッセージの表示にシステム アラート ウィンドウを使用している場合は、代わりに通知を使用してください。

電源とデータの管理に対する変更

電源とデータの管理に関連する次の変更は、一般的に発生する可能性があります。 Wear OS 4 を搭載したデバイスの Wear OS アプリに影響するかどうかを確認します。

アプリ スタンバイ バケットの制限

アプリが長時間使用されていない場合、または大量のブロードキャストとバインディングが行われている場合、アプリは「制限付き」アプリ スタンバイ バケットに送られます。

アプリの休止状態

ユーザーが数か月間アプリを操作しなかった場合、そのアプリは休止状態になります。

バックアップと復元

Wear OS 4 以降では、特定の Wear OS デバイスがクラウド バックアップに対応している場合、 データをクラウドにバックアップしてそのデバイスからデータを転送できる。 クラウドからデータを復元して新しい Wear OS デバイスにデータを転送できる。