Zum Hauptinhalt springen

Erste Schritte für Entwickler

Richten Sie XREAL AURA für die Entwicklung ein.

Voraussetzungen​

Stellen Sie vor Beginn sicher, dass Sie Folgendes haben:

  • XREAL AURA (Brille + Compute Puck)
  • Einen Entwicklungscomputer (Windows, macOS oder Linux)
  • Installiertes Android Studio (aktuelle stabile Version)
  • Hochwertiges USB-C-Kabel mit Datenübertragung
  • Google-Konto für Play Store und Dienste

Schritt 1: Android Studio einrichten​

Android XR SDK installieren​

  1. Öffnen Sie Android Studio.
  2. Öffnen Sie SDK Manager (Tools > SDK Manager).
  3. Wählen Sie die Registerkarte SDK Platforms.
  4. Aktivieren Sie Android 15 (API 35) oder neuer.
  5. Wählen Sie die Registerkarte SDK Tools.
  6. Installieren Sie Folgendes:
    • Android SDK Build-Tools
    • Android Emulator
    • Android-XR-Erweiterungen (sofern verfügbar)

XR-Emulatorprofil installieren​

Zum Testen ohne Hardware:

  1. Öffnen Sie Device Manager in Android Studio.
  2. Erstellen Sie ein neues Virtual Device.
  3. Wählen Sie das XR-Geräteprofil.
  4. Wählen Sie das Android-XR-Systemabbild.
  5. Konfigurieren Sie die OST-Einstellungen für die XREAL-Simulation.

Schritt 2: Entwicklermodus aktivieren​

Auf Ihrem XREAL AURA:

  1. Öffnen Sie Einstellungen (Launcher öffnen > Einstellungen).
  2. Öffnen Sie Über das Gerät.
  3. Tippen Sie 7-mal auf Build-Nummer.
  4. Es erscheint „Entwicklermodus aktiviert“.
  5. Kehren Sie zu Einstellungen zurück.
  6. Öffnen Sie das neue Menü Entwickleroptionen.
  7. Aktivieren Sie USB-Debugging.

Schritt 3: Gerät mit dem Computer verbinden​

  1. Lassen Sie die Brille angeschlossen am Brillenanschluss auf der rechten Seite des Compute Puck.
  2. Verbinden Sie ein USB-C-Kabel vom Computer mit dem Ladeanschluss auf der linken Seite des Compute Puck.
important

Sowohl der Brillenanschluss als auch der Ladeanschluss unterstützen sämtliche ADB-Debugging-Funktionen. Über den Ladeanschluss können Sie kabelgebunden debuggen und gleichzeitig die Anzeige in der Brille sehen.

Schritt 4: Erste App erstellen und bereitstellen​

Neues Projekt erstellen​

  1. Wählen Sie in Android Studio New Project
  2. Wählen Sie XR Activity als Vorlage (falls verfügbar) oder Empty Activity
  3. Setzen Sie das minimale SDK auf API 35
  4. Wählen Sie Kotlin als Programmiersprache

XR-Abhängigkeiten konfigurieren​

In Ihrer Datei build.gradle.kts:

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

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

Auf dem Gerät bereitstellen​

  1. Wählen Sie das angeschlossene Gerät aus der Geräteliste
  2. Klicken Sie auf Run (grüne Wiedergabetaste)
  3. Warten Sie, bis Build und Installation abgeschlossen sind
  4. Setzen Sie die Brille auf, um Ihre laufende App zu sehen

Nächste Schritte​

Fehlerbehebung​

ProblemLösung
Gerät wird nicht erkanntPrüfen Sie das Kabel und versuchen Sie einen anderen USB-Anschluss
Status zeigt „Unauthorized“Tippen Sie im USB-Debugging-Dialog des Geräts auf „Zulassen“
Build schlägt fehlAktualisieren Sie Android Studio und die SDK-Plattformtools
App stürzt beim Start abPrüfen Sie logcat auf Fehlerdetails und Stacktraces
Brillenanzeige nicht sichtbarSchließen Sie die Brille nach Ende der ADB-Sitzung erneut an

Benötigen Sie weitere Hilfe? Besuchen Sie XREAL Developer Discord.