相片挑選工具

宣告依附元件

如要新增 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 版包含這些修訂版本。

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)

修正錯誤

• androidx.lifecycle:lifecycle-runtime 依附元件已更新至 2.10.0。如要搭配 AGP 9.5.0-alpha04 以上版本執行套裝生命週期執行階段 Lint 檢查，則必須使用這個版本。(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 版包含這些修訂項目。

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 可用於接收與相片挑選工具內部狀態相關的回呼。
• 新增 TestEmbeddedPhotoPickerProvider，讓應用程式測試依賴嵌入式相片挑選工具的流程。