XR 투영

  
연결된 XR 기기의 고유한 기능을 활용하는 환경을 빌드하세요.
최근 업데이트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
2026년 9월 23일 - - - 1.0.0-alpha13

종속 항목 선언

xr projected의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소를 읽어보세요.

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.

Groovy

dependencies {
    // Use to implement xr projecteds
    implementation "androidx.xr.projected:projected:1.0.0-alpha13"
}

Kotlin

dependencies {
    // Use to implement xr projecteds
    implementation("androidx.xr.projected:projected:1.0.0-alpha13")

    // Use to implement xr projected complications
    implementation "androidx.xr.projected:projected-complications-data-source:1.0.0-alpha13"
    // (Kotlin-specific extensions)
    implementation "androidx.xr.projected:projected-complications-data-source-ktx:1.0.0-alpha13"

    // Use to implement a projected style and complication editor
    implementation("androidx.xr.projected:projected-editor:1.0.0-alpha13")

    // Can use to render complications.
    // This library is optional and projecteds may have custom implementation for rendering
    // complications.
    implementation "androidx.xr.projected:projected-complications-rendering:1.0.0-alpha13"
}

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

의견

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

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

버전 1.0

버전 1.0.0-alpha13

2026년 9월 23일

androidx.xr.projected:projected:1.0.0-alpha13, androidx.xr.projected:projected-binding:1.0.0-alpha13 및 androidx.xr.projected:projected-testing:1.0.0-alpha13이 출시되었습니다. 버전 1.0.0-alpha13에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • 앱이 디스플레이가 없는 기기에서 시스템 시작 포커스 이동이 발생할 때 다시 시작되고 입력 포커스를 수신해야 하는 구성요소를 정확하게 지정할 수 있도록 ProjectedActivityCompat.setActivityAsInputReceiver 및 clearActivityAsInputReceiver가 추가되었습니다. (Id21e5)

버전 1.0.0-alpha12

2026년 9월 9일

androidx.xr.projected:projected:1.0.0-alpha12, androidx.xr.projected:projected-binding:1.0.0-alpha12 및 androidx.xr.projected:projected-testing:1.0.0-alpha12이 출시되었습니다. 버전 1.0.0-alpha12에는 이러한 커밋이 포함되어 있습니다.

버그 수정

  • ProjectedActivity.requestPermissions 호출을 처리하지 못하도록 하는 ProjectedTestRule 관련 문제를 해결했습니다. (I3923f, I25f36)

버전 1.0.0-alpha11

2026년 8월 12일

androidx.xr.projected:projected:1.0.0-alpha11, androidx.xr.projected:projected-binding:1.0.0-alpha11 및 androidx.xr.projected:projected-testing:1.0.0-alpha11이 출시되었습니다. 버전 1.0.0-alpha11에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • 지원 중단된 androidx.xr.projected.permissions.* API를 삭제했습니다. (I77f8b)

버그 수정

  • 절전 모드 또는 대기 모드 후 애플리케이션을 재개할 때 발생하는 ANR 및 서비스 바인딩 해제 비정상 종료 문제를 수정했습니다. (Idac0c)

버전 1.0.0-alpha10

2026년 7월 15일

androidx.xr.projected:projected:1.0.0-alpha10, androidx.xr.projected:projected-binding:1.0.0-alpha10 및 androidx.xr.projected:projected-testing:1.0.0-alpha10이 출시되었습니다. 버전 1.0.0-alpha10에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • ProjectedPermissionsResultContract가 지원 중단되었습니다. 대신 ProjectedActivityCompat.requestPermissions()를 사용합니다. (I141d5, b/515699436)
  • ProjectedActivityCompat에 requestPermissions() API를 추가했습니다. (I2edb5, b/433523713, b/508189550)

버전 1.0.0-alpha09

2026년 6월 17일

androidx.xr.projected:projected:1.0.0-alpha09, androidx.xr.projected:projected-binding:1.0.0-alpha09 및 androidx.xr.projected:projected-testing:1.0.0-alpha09이 출시되었습니다. 버전 1.0.0-alpha09에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • ProjectedTestRule에 배터리 상태 지원이 추가되었습니다. (I6b28e)
  • ProjectedDeviceController (If8966)에 배터리 상태 변경사항 수신 추가
  • ProjectedTestRule에 오디오 기기 지원 추가 (I5d1c9)
  • ProjectedDeviceController에 오디오 기기 지원이 추가되었습니다 (I7681d).

버전 1.0.0-alpha08

2026년 5월 19일

androidx.xr.projected:projected:1.0.0-alpha08, androidx.xr.projected:projected-binding:1.0.0-alpha08 및 androidx.xr.projected:projected-testing:1.0.0-alpha08이 출시되었습니다. 버전 1.0.0-alpha08에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • 단위 테스트를 지원하기 위해 ProjectedTestRule를 추가했습니다. (I69db5)

알려진 문제

  • compileSdk이 API 37로 잘못 상향되었습니다. 즉, 이 출시에는 최소 AGP 버전 9.2.0이 필요합니다. 다음 버전에서는 36으로 줄어듭니다. (Id45cd)

버전 1.0.0-alpha07

2026년 5월 6일

androidx.xr.projected:projected:1.0.0-alpha07, androidx.xr.projected:projected-binding:1.0.0-alpha07 및 androidx.xr.projected:projected-testing:1.0.0-alpha07이 출시되었습니다. 버전 1.0.0-alpha07에는 이러한 커밋이 포함되어 있습니다.

버전 1.0.0-alpha06

2026년 3월 25일

androidx.xr.projected:projected:1.0.0-alpha06, androidx.xr.projected:projected-binding:1.0.0-alpha06 및 androidx.xr.projected:projected-testing:1.0.0-alpha06이 출시되었습니다. 버전 1.0.0-alpha06에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • ProjectedActivityCompat에 새로운 create(activity: Activity) 메서드가 추가되었습니다. (If4773, b/479214966)

버전 1.0.0-alpha05

2026년 2월 25일

androidx.xr.projected:projected:1.0.0-alpha05, androidx.xr.projected:projected-binding:1.0.0-alpha05 및 androidx.xr.projected:projected-testing:1.0.0-alpha05이 출시되었습니다. 버전 1.0.0-alpha05에는 이러한 커밋이 포함되어 있습니다.

버전 1.0.0-alpha04

2026년 1월 28일

androidx.xr.projected:projected:1.0.0-alpha04 및 androidx.xr.projected:projected-binding:1.0.0-alpha04이 출시되었습니다. 버전 1.0.0-alpha04에는 이러한 커밋이 포함되어 있습니다.

버전 1.0.0-alpha03

2025년 12월 3일

androidx.xr.projected:projected:1.0.0-alpha03이 출시되었습니다. 버전 1.0.0-alpha03에는 이러한 커밋이 포함되어 있습니다.

API 변경사항

  • PresentationMode를 가져오는 실험용 API를 추가했습니다. (I2dc0b)
  • ProjectedInputEvent 수집을 위한 실험용 API 추가 (I78ef8)
  • ProjectedDeviceController 및 기능 API 추가 (If7d2d)

버전 1.0.0-alpha02

2025년 11월 19일

androidx.xr.projected:projected:1.0.0-alpha02이 출시되었습니다. 버전 1.0.0-alpha02에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • Projected 라이브러리의 초기 알파 버전입니다.

버전 1.0.0-alpha01

2025년 10월 22일

androidx.xr.projected:projected:1.0.0-alpha01이 출시되었습니다. 버전 1.0.0-alpha01에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

  • 프로젝션된 XR 라이브러리 추가 (Ieedea7)