본문으로 건너뛰기

개발자 시작 가이드

개발을 위해 XREAL AURA를 설정합니다.

사전 준비​

시작하기 전에 다음을 준비하세요.

  • XREAL AURA(글래스 + Compute Puck)
  • 개발용 컴퓨터(Windows, macOS 또는 Linux)
  • Android Studio 설치(최신 안정 버전)
  • USB-C 케이블(고품질, 데이터 전송 지원)
  • Play 스토어 및 서비스용 Google 계정

1단계: Android Studio 설정​

Android XR SDK 설치​

  1. Android Studio를 엽니다.
  2. SDK Manager로 이동합니다(Tools > SDK Manager).
  3. SDK Platforms 탭을 선택합니다.
  4. Android 15(API 35) 이상을 선택합니다.
  5. SDK Tools 탭을 선택합니다.
  6. 다음을 설치합니다.
    • Android SDK Build-Tools
    • Android Emulator
    • Android XR 확장 기능(사용 가능한 경우)

XR 에뮬레이터 프로필 설치​

하드웨어 없이 테스트하려면:

  1. Android Studio에서 Device Manager를 엽니다.
  2. 새 가상 기기를 만듭니다.
  3. XR 기기 프로필을 선택합니다.
  4. Android XR 시스템 이미지를 선택합니다.
  5. XREAL 시뮬레이션을 위한 OST 설정을 구성합니다.

2단계: 기기에서 개발자 모드 활성화​

XREAL AURA에서:

  1. 설정으로 이동합니다(런처 열기 > 설정).
  2. 기기 정보로 이동합니다.
  3. 빌드 번호를 7번 누릅니다.
  4. "개발자 모드가 활성화되었습니다"가 표시됩니다.
  5. 설정으로 돌아갑니다.
  6. 새로운 개발자 옵션 메뉴를 엽니다.
  7. USB 디버깅을 활성화합니다.

3단계: 기기를 컴퓨터에 연결​

  1. 글래스를 Compute Puck 오른쪽의 글래스 포트에 연결된 상태로 유지합니다.
  2. 컴퓨터에서 Compute Puck 왼쪽의 충전 포트로 USB-C 케이블을 연결합니다.
important

글래스 포트와 충전 포트 모두 전체 ADB 디버깅 기능을 지원합니다. 충전 포트를 사용하면 글래스로 화면을 보면서 동시에 유선 디버깅을 수행할 수 있습니다.

4단계: 첫 앱 빌드 및 배포​

새 프로젝트 만들기​

  1. Android Studio에서 New Project를 선택합니다
  2. XR Activity 템플릿(사용 가능한 경우) 또는 Empty Activity를 선택합니다
  3. 최소 SDK를 API 35로 설정합니다
  4. 프로그래밍 언어로 Kotlin을 선택합니다

XR 종속성 구성​

build.gradle.kts 파일에서:

android {
    defaultConfig {
        minSdk = 35
        targetSdk = 35
    }
}

dependencies {
    // Add XR dependencies
    implementation("androidx.xr:xr-compose:1.0.0")
    // ... other dependencies
}

기기에 배포​

  1. 기기 드롭다운에서 연결된 기기를 선택합니다
  2. Run(녹색 재생 버튼)을 클릭합니다
  3. 빌드 및 설치가 완료될 때까지 기다립니다
  4. 글래스를 착용하고 실행 중인 앱을 확인합니다

다음 단계​

문제 해결​

문제해결 방법
기기가 인식되지 않음케이블을 확인하고 다른 USB 포트를 사용해 보세요
상태에 "Unauthorized" 표시기기의 USB 디버깅 메시지에서 "허용"을 누르세요
빌드 실패Android Studio 및 SDK 플랫폼 도구를 업데이트하세요
앱 실행 시 충돌logcat에서 오류 상세 정보와 스택 트레이스를 확인하세요
글래스 화면이 보이지 않음ADB 세션 종료 후 글래스를 다시 연결하세요

도움이 더 필요하면 XREAL 개발자 Discord를 방문하세요.