photopicker

  
此库为嵌入式照片选择器提供了 Compose 和 Android View 的集成。
最近更新时间 稳定版 候选版 Beta 版 Alpha 版
2026 年 10 月 21 日 - - - 1.0.0-alpha03

声明依赖项

如需添加 PhotoPicker 的依赖项，您必须将 Google Maven 仓库添加到项目中。如需了解详情，请参阅 Google 的 Maven 代码库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

Groovy

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"
}

Kotlin

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")
}

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 Jetpack。如果您发现了新问题，或对此库有任何改进建议，请告诉我们。创建新问题前，请先查看此库中的现有问题。您可以点击星标按钮，为现有问题投票。

创建新问题

如需了解详情，请参阅问题跟踪器文档。

此工件没有版本说明。

版本 1.0

版本 1.0.0-alpha03

2026 年 10 月 21 日

发布了 androidx.photopicker:photopicker-*:1.0.0-alpha03。版本 1.0.0-alpha03 包含这些提交内容。

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)
  • 向 PickVisualMediaRequest 添加了 setLocationMetadataAccessRequested，以便在照片选择器请求中请求位置元数据访问权限。(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)

bug 修复

  • androidx.lifecycle:lifecycle-runtime 依赖项已更新至 2.10.0。此版本是捆绑的生命周期运行时 lint 检查在 AGP 9.5.0-alpha04 或更高版本中运行所必需的。（I99bfd、b/556807521）
  • compileSdk for Compose 库已更新至 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 包含这些提交内容。

API 变更

  • 将 androidx.photopicker:photopicker 和 androidx.photopicker:photopicker-compose 库的 minSdk 降至 23，但这些 API 仍需从 34 开始调用。（I94e42、b/524083018）
  • 更新了嵌入式照片选择器 Compose API（移除了 AbstractEmbeddedPhotoPickerState，重命名了 EmbeddedPhotoPickerState 中的一些字段并更改了其可见性）（Ie32c9、b/449786033）

bug 修复

  • 将 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 包含这些提交内容。

新功能

  • 嵌入式照片选择器的 androidx 实现的初始 Alpha 版，可让基于 View 和基于 Compose 的应用轻松与嵌入式照片选择器服务集成。

API 变更

  • 添加了 EmbeddedPhotopicker 可组合项，作为基于 Compose 的应用的入口点。
    • 可以使用 rememberEmbeddedPhotoPickerState（推荐），也可以使用 EmbeddedPhotoPickerState 接口实现应用自己的状态管理。
  • 添加了 EmbeddedPhotopickerView 作为基于视图的应用的入口点。
    • EmbeddedPhotoPickerStateChangeListener 可用于接收与照片选择器内状态相关的回调。
  • 添加了 TestEmbeddedPhotoPickerProvider，以便应用测试依赖于嵌入式照片选择器的流程。