photopicker

  
이 라이브러리는 내장된 사진 선택 도구의 Compose 및 Android 뷰 통합을 제공합니다.
최근 업데이트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
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")
}
    

종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.

의견

제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 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)
  • surfacePackage 및 notifyVisibilityChanged를 노출하도록 EmbeddedPhotoPickerState를 리팩터링하고 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 이상에서 실행하는 데 필요합니다. (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)
  • 내장된 사진 선택 도구 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 구현의 초기 알파 버전으로, 뷰 기반 애플리케이션과 Compose 기반 애플리케이션 모두 삽입된 사진 선택 도구 서비스와 쉽게 통합할 수 있습니다.

API 변경사항

  • Compose 기반 애플리케이션의 진입점으로 EmbeddedPhotopicker 컴포저블을 추가했습니다.
    • rememberEmbeddedPhotoPickerState를 사용하거나 (권장) 애플리케이션에서 EmbeddedPhotoPickerState 인터페이스를 사용하여 자체 상태 관리를 구현할 수 있습니다.
  • 뷰 기반 애플리케이션의 진입점으로 EmbeddedPhotopickerView를 추가했습니다.
    • EmbeddedPhotoPickerStateChangeListener를 사용하여 사진 선택 도구 내의 상태에 대한 관련 콜백을 수신할 수 있습니다.
  • 앱이 삽입된 사진 선택 도구를 사용하는 흐름을 테스트할 수 있도록 TestEmbeddedPhotoPickerProvider를 추가했습니다.