写真選択ツール

依存関係の宣言

PhotoPicker への依存関係を追加するには、Google の Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

dependencies {
    // For apps using Compose
    implementation "androidx.photopicker:photopicker-compose:1.0.0-alpha03"
    // For apps using Android views
    implementation "androidx.photopicker:photopicker:1.0.0-alpha03"
}
    

dependencies {
    // For apps using Compose
    implementation("androidx.photopicker:photopicker-compose:1.0.0-alpha03")
    // For apps using Android views
    implementation("androidx.photopicker:photopicker:1.0.0-alpha03")
}
    

依存関係について詳しくは、ビルド依存関係の追加をご覧ください。

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

このアーティファクトのリリースノートはありません。

バージョン 1.0

バージョン 1.0.0-alpha03

2026 年 10 月 21 日

androidx.photopicker:photopicker-*:1.0.0-alpha03 がリリースされました。バージョン 1.0.0-alpha03 に含まれる commit については、こちらをご覧ください。

API の変更

• PickVisualMedia に EXTRA_SYSTEM_FALLBACK_PICK_IMAGES_REQUEST_LOCATION_METADATA_ACCESS を追加し、システム フォールバック選択ツールで位置情報メタデータへのアクセスをリクエストできるようにしました。（Ie5917）
• アーティファクト androidx.photopicker:photopicker の名前を androidx.photopicker:photopicker-embedded（パッケージ androidx.photopicker.embedded）に、androidx.photopicker:photopicker-compose の名前を androidx.photopicker:photopicker-embedded-compose（パッケージ androidx.photopicker.embedded.compose）に、androidx.photopicker:photopicker-testing の名前を androidx.photopicker:photopicker-embedded-testing（パッケージ androidx.photopicker.embedded.testing）に変更しました。（I48b9b、b/537430760）
• EmbeddedPhotoPickerState をリファクタリングして surfacePackage と notifyVisibilityChanged を公開し、onError コールバックを追加しました。（Ifa4b0）
• setLocationMetadataAccessRequested を PickVisualMediaRequest に追加し、写真選択ツールのリクエストで位置情報メタデータへのアクセスをリクエストできるようにしました。（Idde80）
• PickVisualMedia と PickMultipleVisualMedia のコントラクト、および PickVisualMediaRequest を新しい photopicker-activity アーティファクトに移行しました。テストをコピーしました。（I2a201、b/530216959）
• rememberEmbeddedPhotoPickerState から inputs パラメータを削除しました。入力が変更されたときに状態をリセットするには、代わりに呼び出しを key ブロックでラップします。（I8a0c5）
• androidx.photopicker:photopicker ライブラリと androidx.photopicker:photopicker-compose ライブラリの minSdk を 23 に引き下げました。（I94e42、b/524083018）
• Revising Embedded PhotoPicker Compose APIs（Ie32c9）
• 写真選択ツールの新しいライブラリ（I0f52a）
• 写真選択ツール用の新しいテスト ライブラリ（I7c1ec）

バグの修正

• androidx.lifecycle:lifecycle-runtime の依存関係を 2.10.0 に更新しました。このバージョンは、バンドルされたライフサイクル ランタイム lint チェックを AGP バージョン 9.5.0-alpha04 以降で実行するために必要です。（I99bfd、b/556807521）
• Compose ライブラリの compileSdk を 37.1 に更新しました。 これには、Compose を使用するすべてのアプリとライブラリの compileSdk を推移的に更新する必要があります。（I05b0f）
• Compose の compileSdk を API 37 に更新しました。つまり、Compose を使用する場合は、AGP の最小バージョン 9.2.0 が必要です。（Id45cd）

バージョン 1.0.0-alpha02

2026 年 7 月 1 日

androidx.photopicker:photopicker:1.0.0-alpha02、androidx.photopicker:photopicker-compose:1.0.0-alpha02、androidx.photopicker:photopicker-testing:1.0.0-alpha02 がリリースされました。バージョン 1.0.0-alpha02 に含まれる commit については、こちらをご覧ください。

API の変更

• androidx.photopicker:photopicker ライブラリと androidx.photopicker:photopicker-compose ライブラリの minSdk を 23 に引き下げました。ただし、API は引き続き 34 以降から呼び出す必要があります。（I94e42、b/524083018）
• 埋め込み写真選択ツールの Compose API を更新しました（AbstractEmbeddedPhotoPickerState を削除し、EmbeddedPhotoPickerState の一部のフィールドの名前と公開設定を変更しました）。（Ie32c9、b/449786033）

バグの修正

• Compose の compileSdk を API 37 に更新しました。つまり、Compose を使用する場合は、AGP の最小バージョン 9.2.0 が必要です。（Ic748a、b/413674743）

バージョン 1.0.0-alpha01

2025 年 6 月 4 日

androidx.photopicker:photopicker:1.0.0-alpha01、androidx.photopicker:photopicker-compose:1.0.0-alpha01、androidx.photopicker:photopicker-testing:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

• 埋め込み写真選択ツールの androidx 実装の最初のアルファ版リリース。ビューベースと Compose ベースの両方のアプリケーションを埋め込み写真選択ツール サービスと簡単に統合できます。

API の変更

• Compose ベースのアプリケーションのエントリ ポイントとして EmbeddedPhotopicker コンポーザブルを追加しました。
  • rememberEmbeddedPhotoPickerState を使用することも（推奨）、アプリケーションで EmbeddedPhotoPickerState インターフェースを使用して独自の状態管理を実装することもできます。
• ビューベースのアプリのエントリ ポイントとして EmbeddedPhotopickerView を追加しました。
  • EmbeddedPhotoPickerStateChangeListener を使用すると、PhotoPicker 内の状態に関連するコールバックを受け取ることができます。
• TestEmbeddedPhotoPickerProvider を追加し、アプリが埋め込みの写真選択ツールに依存するフローをテストできるようにしました。