photopicker

  
這個程式庫提供 Compose 和 Android Views 的整合功能，可嵌入相片挑選器。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2026 年 7 月 1 日 - - - 1.0.0-alpha02

宣告依附元件

如要新增 PhotoPicker 的依附元件，必須將 Google Maven 存放區新增至專案中。詳情請參閱 Google 的 Maven 存放區。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

Groovy

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

Kotlin

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

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 文件。

這個構件沒有任何版本資訊。

1.0 版本

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)
  • 更新 Embedded PhotoPicker 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 版包含這些修訂項目。

新功能

  • 內嵌相片挑選器的 androidx 實作項目 Alpha 版，可讓以 View 和 Compose 為基礎的應用程式輕鬆整合內嵌相片挑選器服務。

API 變更

  • 新增 EmbeddedPhotopicker 可組合項，做為以 Compose 為基礎的應用程式的進入點。
    • 可以使用 rememberEmbeddedPhotoPickerState (建議)，或應用程式可透過 EmbeddedPhotoPickerState 介面實作自己的狀態管理。
  • 新增 EmbeddedPhotopickerView 做為以檢視區塊為基礎的應用程式進入點。
    • EmbeddedPhotoPickerStateChangeListener 可用於接收 PhotoPicker 內狀態的相關回呼。
  • 新增 TestEmbeddedPhotoPickerProvider，讓應用程式測試依附於內嵌相片挑選器的流程。