問題
AndroidManifest.xmlの下記の行で警告が表示されます。
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
警告メッセージは以下の通りです。
Your app is currently not handling Selected Photos Access introduced in Android 14+ More... (⌘F1)
Inspection info:Selected Photo Access is a new ability for users to share partial access to their photo library when apps request access to their device storage on Android 14+. Instead of letting the system manage the selection lifecycle, we recommend you adapt your app to handle partial access to the photo library.
このエラーの原因と対策を調べました。
原因
この警告メッセージは、Android 14（APIレベル 33）で導入された「Selected Photos Access（選択した写真へのアクセス）」に対応していないことを指摘しています。
Android 14以降、ユーザーはアプリがデバイスのストレージにアクセスを要求する際に、写真ライブラリ全体へのアクセスを許可する代わりに、選択した写真への部分的なアクセスを共有する新しい機能を利用できます。
android.permission.READ_MEDIA_IMAGESパーミッションを使用することで、アプリはユーザーのデバイス上の画像にアクセスできますが、Android 14+では、ユーザーが選択した写真へのアクセスのみをアプリに許可するオプションが追加されています。この変更により、ユーザーのプライバシーがさらに強化され、アプリは必要な写真にのみアクセスできるようになります。
この警告に対処するためには、アプリを「Selected Photos Access」に対応させる必要があります。具体的には、アプリが選択した写真への部分的なアクセスを管理し、この新しいアクセス権限に適応するようにする必要があります。
Selected Photos Accessの特徴と動作
- 部分的なアクセス許可:ユーザーはアプリに対して、写真ライブラリ全体ではなく、選択した写真にのみアクセスを許可できます。これにより、ユーザーはプライバシーを保護しつつ、アプリの機能を利用できます。
-
動的なアクセス管理: ユーザーはいつでも設定を変更し、アプリがアクセスできる写真を追加または削除できます。アプリは、これらの変更をリアルタイムで反映する必要があります。
-
ユーザーインターフェースの調整: アプリは、選択された写真へのアクセスが許可された場合、ユーザーが新たにアクセスを許可した写真に簡単にアクセスできるようにユーザーインターフェースを調整する必要があります。
対応
Selected Photos Access を利用する
アプリで Selected Photos Access を利用するには、以下の手順が必要です。
- アプリのターゲット API レベルを 33 に設定します。
- アプリの manifest.xml ファイルに以下の権限を追加します。
<uses-permission android:name="android.permission.READ_MEDIA_VISUAL_USER_SELECTED" /> - アプリで PhotoPicker クラスを使用して、ユーザーが写真や動画を選択できるようにします。
PhotoPicker クラスの使用
PhotoPicker クラスは、ユーザーが写真や動画を選択するための UI を提供します。このクラスを使用するには、以下の手順が必要です。
- PhotoPicker.Builder クラスのインスタンスを作成します。
- Builder インスタンスに、ユーザーが選択できる写真や動画の種類を指定します。
- Builder インスタンスの build() メソッドを呼び出して、PhotoPicker インスタンスを作成します。
- PhotoPicker インスタンスの start() メソッドを呼び出して、写真選択画面を表示します。
ユーザーが選択した写真や動画へのアクセス
ユーザーが写真や動画を選択した後、アプリは PhotoPicker インスタンスの getSelectedPhotos() メソッドを使用して、選択された写真や動画への URI を取得できます。
Selected Photos Access の制限事項
Selected Photos Access には、以下の制限事項があります。
- ユーザーが選択した写真や動画のみアクセスできる
- ユーザーがアプリをアンインストールすると、アプリは選択された写真や動画へのアクセス権を失う