Passa al contenuto principale

Primi passi per sviluppatori

Prepara XREAL AURA per lo sviluppo.

Prerequisiti​

Prima di iniziare, prepara:

  • XREAL AURA (occhiali + Compute Puck)
  • Un computer di sviluppo Windows, macOS o Linux
  • Android Studio installato, nell’ultima versione stabile
  • Un cavo USB-C di qualità con supporto dati
  • Un account Google per Play Store e servizi

Passaggio 1: configurare Android Studio​

Installare Android XR SDK​

  1. Apri Android Studio.
  2. Apri SDK Manager da Tools > SDK Manager.
  3. Seleziona la scheda SDK Platforms.
  4. Seleziona Android 15 (API 35) o successivo.
  5. Seleziona la scheda SDK Tools.
  6. Installa questi elementi:
    • Android SDK Build-Tools
    • Android Emulator
    • Estensioni Android XR, quando disponibili

Installare il profilo dell’emulatore XR​

Per testare senza hardware:

  1. Apri Device Manager in Android Studio.
  2. Crea un nuovo dispositivo virtuale.
  3. Seleziona un profilo di dispositivo XR.
  4. Scegli un’immagine di sistema Android XR.
  5. Configura le impostazioni OST per simulare XREAL.

Passaggio 2: attivare la modalità sviluppatore​

Su XREAL AURA:

  1. Apri Impostazioni dal launcher delle app.
  2. Vai a Informazioni sul dispositivo.
  3. Tocca 7 volte il numero build.
  4. Compare il messaggio «Modalità sviluppatore attivata».
  5. Torna alle impostazioni.
  6. Apri il nuovo menu Opzioni sviluppatore.
  7. Attiva il debug USB.

Passaggio 3: collegare il dispositivo al computer​

  1. Mantieni gli occhiali collegati alla porta degli occhiali, sul lato destro del Compute Puck.
  2. Collega il computer alla porta di ricarica, sul lato sinistro del Compute Puck, con un cavo USB-C.
important

Sia la porta degli occhiali sia la porta di ricarica supportano tutte le funzioni di debug ADB. Usare la porta di ricarica permette il debug cablato mentre continui a vedere lo schermo negli occhiali.

Passaggio 4: compilare e distribuire la prima app​

Creare un progetto​

  1. In Android Studio, seleziona New Project
  2. Scegli il modello XR Activity, se disponibile, oppure Empty Activity
  3. Imposta l’SDK minimo su API 35
  4. Scegli Kotlin come linguaggio

Configurare le dipendenze XR​

Nel file build.gradle.kts:

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

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

Distribuire sul dispositivo​

  1. Seleziona il dispositivo collegato dall’elenco dei dispositivi
  2. Fai clic su Run, il pulsante verde di riproduzione
  3. Attendi il completamento di compilazione e installazione
  4. Indossa gli occhiali per vedere l’app in esecuzione

Passaggi successivi​

Risoluzione dei problemi​

ProblemaSoluzione
Dispositivo non riconosciutoControlla il cavo e prova un’altra porta USB
Stato «Unauthorized»Tocca «Consenti» nella richiesta di debug USB sul dispositivo
Compilazione non riuscitaAggiorna Android Studio e gli strumenti della piattaforma SDK
App che si chiude all’avvioConsulta logcat per errori e tracce dello stack
Schermo degli occhiali non visibileRicollega gli occhiali al termine della sessione ADB

Serve aiuto? Visita il Discord sviluppatori XREAL.