Sammendrag
Bruk Unity når bedriftsapplikasjonen din trenger interaktivt 3D-innhold, eller Android Studio når den trenger et nativt Android-grensesnitt. Oppsettet er fullført når de nødvendige verktøyene er installert, prosjektet består konfigurasjonskontrollene og testenheten eller emulatoren er tilgjengelig.
Instruksjonene følger den offisielle dokumentasjonen for Android XR. Aura-spesifikke utviklingsporter, fastvaremenyer og tillatelser må kontrolleres mot introduksjonsveiledningen som fulgte med enheten din. Denne veiledningen gir seg ikke ut for å bygge på fysisk testing av Aura.
Velg utviklingsvei
Velg Unity hvis prosjektet skal bruke 3D-modeller, interaktiv opplæring eller simulering, eller hvis utviklerne dine allerede jobber med Unity og C#. Unity gir deg et visuelt arbeidsområde for å plassere innhold og konfigurere XR-funksjoner. Du kan sette opp miljøet uten å skrive kode eller bygge en prototype.
Velg Android Studio hvis du utvider en Android-basert bedriftsapplikasjon eller lager native grensesnitt som arbeidsinstruksjoner, skjemaer eller oppgavepaneler. Det bruker Kotlin og Googles Jetpack XR-biblioteker. Begge veiene kan senere kobles til forretningssystemer via et API, en definert måte for programvare å utveksle informasjon på. Velg vei ut fra applikasjonsgrensesnittet og teamets kompetanse.
Hovededitor for utvikling:
- Unity-veien: Unity Editor, installert via Unity Hub
- Android Studio-veien: Android Studio
Språk for videre utvikling:
- Unity-veien: C#
- Android Studio-veien: Kotlin
Android-byggeverktøy:
- Unity-veien: Android Build Support, inkludert SDK, NDK og OpenJDK
- Android Studio-veien: Android SDK-verktøy, installert via SDK Manager
Grunnleggende XR-støtte:
- Unity-veien: OpenXR Plugin, installert via Unity Package Manager
- Android Studio-veien: Jetpack XR SDK-biblioteker, lastet ned via Gradle
Plattformspesifikk XR-støtte:
- Unity-veien: Pakken Unity OpenXR: Android XR
- Android Studio-veien: XR-prosjektmal og nødvendige Jetpack XR-biblioteker
Hva XR-verktøyene betyr:
- Unity-veien: OpenXR er et felles grensesnitt mellom en XR-app og enhetens runtime, systemprogramvaren som kjører XR-funksjonene
- Android Studio-veien: Jetpack XR SDK er Googles samling av biblioteker for native romlige grensesnitt og XR-funksjoner
Tilkobling og diagnostikk:
- Unity-veien: ADB, verktøyet Android Debug Bridge
- Android Studio-veien: ADB og Logcat i Android Studio, som viser diagnosemeldinger
Klargjør arbeidsstasjonen og utviklertilgangen
Klargjør en støttet utviklingsdatamaskin, stabil internettilgang for avhengigheter, en godkjent prosjektmappe i virksomheten og en USB-datakabel. Kravene til emulatoren er ikke de samme som kravene til editoren; sjekk Googles side om maskinvarekrav for XR-emulatoren før du baserer deg på en virtuell enhet. En virtuell enhet er en programvaresimulering av en Android-enhet. [4]
Bruk en Aura-enhet med autorisert utviklertilgang, den medfølgende brilletilkoblingen og utviklingstilkoblingen som XREAL har dokumentert. Bekreft regional tilgjengelighet og introduksjon til settet før du binder deg til en dato for en workshop. Gjeldende XREAL-sider og regionale sider kan oppgi ulik tilgjengelighet; en produktoppføring alene fastslår ikke leveringstidspunktet. [1]
For bedriftsbruk bør du bekrefte at organisasjonen din oppfyller kravene til Unity-lisens, og eventuelle relevante Industry-vilkår, før dere bruker Unity kommersielt. Bruk versjonskontroll som virksomheten kontrollerer, godkjente pakkekilder og testdata. Android Studio og Unity er utviklingsverktøy for profesjonelle applikasjoner; at du installerer dem, fastslår ikke at Aura støtter administrasjon på virksomhetsnivå.
Vei A: Sett opp utviklingsmiljøet i Unity
Denne veien installerer Unity og Unitys Android-verktøy, oppretter et tomt prosjekt og aktiverer støtte for Android XR. Den klargjør arbeidsområdet for videre utvikling.
Trinn 1 | Installer Unity-editoren
Unity Hub administrerer editorinstallasjonene dine; Unity Editor er arbeidsområdet der du konfigurerer prosjekter og senere utvikler applikasjonen.
Installer Unity Hub fra Unitys offisielle nettsted og åpne programmet. Gå til Installs og deretter Install Editor. Velg en støttet Unity 6.5-versjon (eller nyere) som er kompatibel med Android XR-pakken du skal bruke, for å få full støtte for inndata via styreflaten på puck-enheten og andre funksjoner. Googles oppsettside angir for øyeblikket 6000.0.58f2 eller nyere; krav fra nyere pakker gjelder også. [5]
Trinn 2 | Legg til Android-byggeverktøyene
Disse modulene gjør det mulig for Unity å gjøre prosjektet ditt om til en Android-applikasjon.
XREAL Aura kjører Android XR og trenger derfor en Android-applikasjon som operativsystemet kan installere og kjøre. Unity-prosjektet ditt inneholder redigerbare filer for utvikling; Android-byggeverktøyene pakker og kompilerer disse filene til en installerbar app, vanligvis en APK for testing på enheten.
Blant installasjonsmodulene velger du Android Build Support og tilhørende underelementer, og klikker deretter Continue og fullfører installasjonsdialogene. Verktøyene som må installeres:
· Android SDK (Software Development Kit)
· Android NDK (Native Development Kit): Gjør kode på lavere nivå om til en form som enhetens prosessor kan kjøre.
· JDK (Java Development Kit)
For en eksisterende editor går du tilbake til Unity Hub > Installs, åpner menyen for editoren, velger Add modules, markerer de samme elementene og klikker Installs.
Trinn 3 | Opprett et prosjekt
Et tomt prosjekt gir deg et sted å konfigurere utviklingsmiljøet for Android XR.
I Unity Hub åpner du Projects > New project. Velg den installerte editoren og velg Universal 3D. Gi prosjektet navnet AuraDevelopmentSetup, velg en mappe og velg Create project. Universal 3D bruker URP, Universal Render Pipeline, som tegner grafikken i applikasjonen.
Trinn 4 | Kontroller verktøystiene
Unity må vite hvor de kompatible Android-byggeverktøyene er installert.
I Unity Editor åpner du Edit > Preferences > External Tools (Unity > Settings eller Preferences på macOS). La SDK-en (Android-plattformverktøy), NDK-en (kompilatorverktøy for nativ kode) og JDK-en (Java-byggeverktøy) som følger med Unity, være valgt. Disse versjonene er tilpasset Unity-editoren din, noe som bidrar til å unngå byggefeil. Ikke bytt dem ut med urelaterte verktøyversjoner fra Android Studio bare fordi begge er installert.
Konfigurer utviklingsmiljøet for XREAL Aura i Unity
OpenXR er en åpen standard som hjelper XR-applikasjoner med å kommunisere med kompatible runtimes på enhetene. I Unity installerer du OpenXR Plugin for kjernetilkoblingen og Unity OpenXR: Android XR for Android XR-støtte via Package Manager. AR Foundation er Unitys felles grensesnitt for støttede AR-funksjoner, for eksempel forståelse av omgivelsene.
Trinn 1 | Velg Android XR som byggemål
Byggemålet forteller Unity hvilken plattform applikasjonen skal kjøre på.
Åpne File > Build Profiles. I Unity 6.1 eller nyere legger du til eller velger plattformprofilen Android XR og bytter til den. Ifølge Unitys dokumentasjon kan dette installere den kompatible Android XR-pakken automatisk. Hvis den støttede editoren din bruker Android-plattformen i stedet, velger du Android og konfigurerer OpenXR manuelt. [7]
Trinn 2 | Installer OpenXR-pakkene
Pakker legger til programvarekomponentene som kobler Unity-scenen din til Android XR.
Åpne Window > Package Management > Package Manager, eller Window > Package Manager i editorer med den eldre menystrukturen. Kontroller at OpenXR Plugin og Unity OpenXR: Android XR er installert. Hvis Android XR-pakken mangler, bruker du plussmenyen > Add package by name og skriver inn com.unity.xr.androidxr-openxr. Identifikatoren for kjernepakken for OpenXR er com.unity.xr.openxr. La Package Manager løse kompatible avhengigheter. [6]
Trinn 3 | Aktiver XR-leverandøren
Når du installerer en pakke, blir den tilgjengelig; når du aktiverer leverandøren, kan applikasjonen bruke den.
Åpne Edit > Project Settings > XR Plug-in Management. Aktiver OpenXR på Android-fanen. Åpne OpenXR-delen under og aktiver funksjonsgruppen Android XR. Aktiver Android XR: Session når du bruker AR Foundation-funksjoner. Aktiver Android XR: AR Session for versjon 1.0. Unngå å aktivere urelaterte leverandører for dette bygget. [8]
Trinn 4 | Valider prosjektet
Valideringen finner innstillinger som ville hindret et støttet XR-bygg.
Åpne XR Plug-in Management > Project Validation og velg Android. Gå gjennom og løs nødvendige problemer, og kontroller deretter på nytt. Pakkespesifikke valideringskrav går foran innstillinger kopiert fra en eldre veiledning.
Trinn 5 | Hold inndatakravene enkle
Aktiver bare funksjoner som den planlagte applikasjonen krever, og som målenheten støtter.
Vent med valgfrie inndatafunksjoner til utviklingsfasen for applikasjonen, med mindre prosjektet eller malen krever dem. Å aktivere en profil for blikksporing eller kontroller gir ikke Aura den maskinvaren. Gå gjennom eventuelle nødvendige interaksjonsinnstillinger i Project Validation før du fortsetter.
Googles Android XR Extensions for Unity er en tilleggspakke med ekstra funksjoner. Den er ikke det samme som Unity OpenXR: Android XR. Du trenger ikke legge den til bare fordi navnene ligner; legg den til når applikasjonen trenger en funksjon den tilbyr. [9]
Kontroller gjengivelses- og Android-byggeinnstillingene
Vulkan er grafikkgrensesnittet som brukes til å sende gjengivelsesarbeid til GPU-en. I Edit > Project Settings > Player velger du Android > Other Settings. Hvis Auto Graphics API er aktivert, fjerner du avmerkingen og plasserer Vulkan først. For et enkelt URP-utgangspunkt deaktiverer du HDR i URP-ressursen og etterbehandling (post-processing) i renderer-ressursen. Google anbefaler disse innstillingene for Android XR. [5]
I de samme Player-innstillingene angir du en unik pakkeidentifikator, for eksempel com.yourcompany.aurapilot. Under Configuration velger du IL2CPP og ARM64 for bygget til den fysiske enheten. IL2CPP konverterer C#-kode til nativ kode; ARM64 er prosessorarkitekturen bygget er rettet mot. Sjekk valideringen av de installerte pakkene og enhetskravene for eventuelle ytterligere begrensninger.
Google oppgir API 24 som minimum for OpenXR-loaderen, ikke som Auras operativsystemversjon. Bruk et minimumsnivå for API som også oppfyller kravene til alle installerte pakker, og en installert mål-SDK som støttes av editoren og distribusjonskravene dine. Konfigurer GameActivity som inngangspunkt for applikasjonen, fjern avmerkingen for Activity og aktiver Resizable Activity under Resolution and Presentation, slik Google angir. [5]
Vei B: Sett opp utviklingsmiljøet i Android Studio
Denne veien installerer Android Studio, laster ned Android-utviklingsverktøyene og oppretter et XR-prosjekt fra Googles mal. Den klargjør det native Android-arbeidsområdet for videre applikasjonsutvikling. Du kan også opprette en emulator for å kontrollere at prosjektet bygges og starter.
Oversikt over oppsettet: installer Android Studio → last ned Android-verktøy → opprett et XR-prosjekt → kontroller avhengigheter → klargjør et testmål.Android Studio er Googles utviklingsmiljø for Android-applikasjoner. Kotlin er programmeringsspråket som brukes her. Jetpack XR SDK tilbyr biblioteker for native romlige brukergrensesnitt og XR, mens Jetpack Compose beskriver grensesnitt i Kotlin-kode.
Trinn 1 | Installer en XR-kompatibel editor
Den anbefalte versjonen av Android Studio inneholder XR-verktøyene og -malene som brukes i denne veien.
Last ned Android Studio-versjonen som anbefales på Googles oppsettside for XR. Gjeldende veiledning anbefaler den nyeste Canary-versjonen; installer den ved siden av den vanlige stabile versjonen om nødvendig. Canary betyr en tidlig utviklingsversjon, så noter den nøyaktige versjonen teamet ditt bruker. [10]
Trinn 2 | Last ned Android-utviklingsverktøyene
SDK Manager installerer komponentene som trengs for å bygge, kjøre og inspisere applikasjonen.
På velkomstskjermen åpner du More Actions > SDK Manager. Under SDK Tools installerer eller oppdaterer du Android SDK Build-Tools, Android Emulator og Android SDK Platform-Tools, samt den versjonen av Layout Inspector som er oppgitt i Googles gjeldende instruksjoner. Klikk Apply og godta lisensene. [10]
Trinn 3 | Opprett XR-prosjektet
En XR-mal gir deg en startapplikasjon der den romlige strukturen allerede er på plass.
Åpne New Project. Velg XR i mallisten og deretter den immersive malen for XR-headset eller kablede XR-briller. Ikke velg en mal for lydbriller eller skjermbriller. Klikk Next, gi prosjektet navnet AuraBusinessPanel, angi et pakkenavn for virksomheten hvis du får muligheten, velg en lagringsmappe og klikk Finish. [11]
Trinn 4 | La prosjektet laste ned avhengigheter
Gradle sync klargjør bibliotekene og byggekonfigurasjonen før du redigerer applikasjonen.
Vent til Gradle sync er ferdig. Gradle er byggesystemet som laster ned avhengigheter og kompilerer appen. Åpne Project-panelet og finn app/build.gradle.kts, eller Gradle-filen for app-modulen. Behold malens innbyrdes kompatible versjoner; ikke oppgrader enkeltstående XR-biblioteker på måfå.
Trinn 5 | Kontroller kravene til Android API
API-innstillingene må oppfylle kravene til malen og alle bibliotekene du bruker.
Sammenlign oppsettsiden for Jetpack XR SDK med malen din. Det publiserte utgangspunktet er minSdk 24 og compileSdk 34 eller høyere; bruk høyere verdier når bibliotekene eller malen du har valgt, krever det. compileSdk er Android-API-et som brukes ved kompilering, mens minSdk angir det eldste Android-API-et som støttes. [12]
Oppsettsiden for SDK-et lister opp avhengighetene Runtime, SceneCore, Compose for XR, Material Design for XR og ARCore for Jetpack XR. Legg bare til det applikasjonen bruker. SceneCore håndterer romlig innhold; ARCore for Jetpack XR gir støttede persepsjonsfunksjoner. Forhåndsversjoner kan endres, så bruk malen og versjonsmerknadene sammen i stedet for å lime inn en gammel avhengighetsblokk.
Hvis malen din ikke inkluderer de grunnleggende XR-bibliotekene automatisk, må du sørge for at app/build.gradle.kts inneholder følgende grunnleggende avhengigheter:
android {
compileSdk = 34 // eller den høyere verdien malen din angir
defaultConfig {
minSdk = 24
}
}
dependencies {
// Kjerneavhengigheter for Jetpack XR SDK
implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
implementation("androidx.xr.scenecore:scenecore:1.1.0-alpha01")
implementation("androidx.xr.compose:compose:1.0.0-beta02")
implementation("androidx.xr.compose.material3:material3:1.0.0-alpha17")
}
På undersøkelsestidspunktet krever Compose for XR 1.0.0-beta02 (21-10-2026) Kotlin 2.2, og ifølge versjonsmerknadene er den avhengig av SceneCore 1.0.0-rc01, som har en kjent minnelekkasje; løsningen er å deklarere SceneCore 1.0.0 eller nyere selv, noe avhengighetsblokken ovenfor allerede gjør. Dette er én grunn til å dokumentere hele avhengighetssettet i stedet for å beskrive en hvilken som helst nyeste installasjon som klar for produksjon. [13]
Kjør på en XR-emulator før maskinvaren er tilgjengelig
Trinn 1 | Opprett en virtuell XR-enhet
Emulatoren lar deg kontrollere programvaren før en fysisk Aura-enhet er tilgjengelig.
Åpne Tools > Device Manager, og deretter Add a new device > Create Virtual Device. Velg XR som formfaktor og velg XR Glasses for arbeidsflyten med kablede briller. [4]
Trinn 2 | Installer det nødvendige systembildet
Systembildet gir den virtuelle enheten operativmiljøet for Android XR.
Velg forhåndsversjonen av systembildet som Googles veiledning krever for XR Glasses, last det ned hvis du blir bedt om det, og fullfør opprettelsen av den virtuelle enheten. Start den fra Device Manager.
Trinn 3 | Kjør applikasjonen
Android Studio bygger prosjektet og installerer det på den valgte virtuelle enheten.
I verktøylinjen øverst i Android Studio velger du kjørekonfigurasjonen app og den kjørende virtuelle XR-enheten. Klikk Run. La Android Studio bygge og installere den uendrede malen. Du trenger ikke tilpasse grensesnittet for denne kontrollen av miljøet.
Trinn 4 | Kontroller resultatet
Et vellykket bygg og en vellykket oppstart bekrefter at de installerte verktøyene kan behandle malen.
Kontroller at malen åpnes uten bygge- eller oppstartsfeil. Dette validerer det grunnleggende programvareoppsettet, ikke Auras optikk, fysiske sporing, ytelse eller produksjonsklarhet.
Koble XREAL Aura til utviklingsdatamaskinen
ADB, forkortelse for Android Debug Bridge, lar en utviklingsdatamaskin installere applikasjoner og lese diagnoselogger fra en Android-enhet. Både Unity og Android Studio kan bruke det.
Ifølge XREALs FAQ for Aura støtter begge USB-C-portene på beregningsenheten (compute puck) standard ADB-feilsøking med Android Studio, men spesifikasjonstabellen oppgir full ADB-støtte bare for Glasses Port, så bruk helst den porten. Hold brillene tilkoblet som anvist. Speiling via DisplayPort og en autorisert ADB-tilkobling er forskjellige funksjoner, så selv om du ser skjermen til den bærbare datamaskinen i brillene, beviser ikke det at utviklingstilkoblingen fungerer.
Trinn 1 | Aktiver autorisert feilsøking
Feilsøking gjør det mulig for utviklingsdatamaskinen å installere og inspisere testapplikasjoner.
Åpne Settings i Android XR-systemet og aktiver Developer options og USB debugging ved hjelp av instruksjonene for fastvaren din. I standard Android blir Developer options vanligvis synlig når du velger Build number gjentatte ganger, men den nøyaktige menystien på Aura ble ikke fastslått i de offentlige kildene som ble gjennomgått. Bruk stien fra den medfølgende introduksjonsveiledningen hvis den er annerledes. [14]
Trinn 2 | Koble til og autoriser datamaskinen
En USB-datatilkobling og godkjenning på enheten kreves for denne arbeidsflyten for kablet feilsøking.
Koble til vertsmaskinen med en USB-datakabel og den dokumenterte utviklingsporten. Godkjenn forespørselen om feilsøkingsautorisasjon for datamaskinen på enheten. På Windows installerer du produsentens ADB-driver hvis systemet krever det. [14]
Trinn 3 | Kontroller at ADB ser enheten
Enhetslisten bekrefter at tilkoblingen er klar før du forsøker å bygge og kjøre.
I Android Studio åpner du SDK Manager og noterer Android SDK Location. Åpne platform-tools-mappen for dette SDK-et i terminalen, og kjør riktig kommando nedenfor.
# Windows PowerShell, i platform-tools
.\adb.exe devices -l
# macOS eller Linux, i platform-tools
./adb devices -l
Forventet resultat: serienummeret til enheten etterfølges av device. Hvis det står unauthorized, godkjenner du forespørselen. Hvis listen er tom, kontrollerer du kabelen, porten på vertsmaskinen, feilsøkingsinnstillingen og driveren. Hvis mer enn én enhet eller emulator er tilkoblet, velger du det tiltenkte målet eksplisitt.
Bekreft at utviklingsmiljøet er klart
Klarhetskontroller for Unity
Trinn 1 | Kontroller byggeprofilen
Kontroller oppsettet før du starter applikasjonsutviklingen.
Åpne File > Build Profiles og bekreft at Android XR, eller Android-profilen som er konfigurert for XR, er aktiv. Bekreft at de nødvendige Android-byggemodulene er tilgjengelige for denne editoren.
Trinn 2 | Kontroller pakker og validering
Prosjektet må ha de nødvendige XR-pakkene installert og aktivert.
I Package Manager kontrollerer du OpenXR Plugin og Unity OpenXR: Android XR. I Project Settings > XR Plug-in Management bekrefter du Android OpenXR-leverandøren og funksjonsgruppen Android XR. Løs nødvendige problemer under Project Validation.
Trinn 3 | Kontroller målenheten
En gjenkjent enhet fullfører tilkoblingsdelen av oppsettet.
I Build Profiles oppdaterer du Run Device og kontrollerer at den autoriserte Aura-enheten din vises. Hvis den ikke gjør det, kontrollerer du ADB-tilkoblingen og stiene under External Tools i Unity. Du kan konfigurere prosjektet før maskinvaren er tilgjengelig, men validering av utrulling på fysisk enhet må vente til du har en enhet.
Klarhetskontroller for Android Studio
Bekreft at Gradle sync fullføres uten feil, at SDK Manager har de nødvendige verktøyene installert, og at XR-emulatoren eller den autoriserte Aura-enheten vises i målvelgeren. Kjør den uendrede XR-malen hvis et testmål er tilgjengelig. Åpne View > Tool Windows > Logcat for å undersøke oppstartsfeil. Logcat viser diagnosemeldinger fra Android.
Slik fungerer Unity og Android Studio sammen
Unity kan bygge Android-applikasjoner med sine egne støttede verktøy, så Android Studio er ikke nødvendig for å konfigurere et Unity-prosjekt. Android Studio kan likevel være nyttig til administrasjon av emulatorer og Android-diagnostikk som Logcat. Det er verdt å påpeke at AndroidXR-emulatoren ikke støtter simulering av apper bygget med Unity, Godot, Unreal Engine eller OpenXR, så Unity-bygg krever en fysisk Aura. For en nativ Kotlin-applikasjon er Android Studio hovedarbeidsområdet ditt, og Unity er unødvendig.
For senere tilpasning av Android-bygget kan Unity eksportere et Gradle-prosjekt til Android Studio. Du trenger ikke dette trinnet for det første oppsettet. Behold Unitys egne støttede byggeverktøy som valgt, med mindre integrasjonen din spesifikt krever en eksportbasert arbeidsflyt.
Feilsøking i det første oppsettet
- Android-byggemålet er ikke tilgjengelig: Legg til Android Build Support i nøyaktig den Unity-editorinstallasjonen det gjelder
- Android XR-gruppen mangler: Kontroller pakkeidentifikatoren, kompatibiliteten og fanen for Android-målet
- Gradle sync mislykkes: Les den første byggefeilen; kontroller SDK-installasjonen og at avhengighetsversjonene samsvarer
- Nødvendige pakker eller funksjoner mangler: Kontroller Package Manager, det aktive Android-målet og funksjonsgruppen Android XR
- Project Validation viser feil: Gå gjennom hvert nødvendige problem og bruk løsningen for den installerte pakkeversjonen
- Enheten er ikke autorisert: Godkjenn feilsøkingsforespørselen på enheten
- Installasjonen mislykkes på emulatoren: Kontroller at APK-arkitekturen samsvarer med emulatorens systembilde
Konklusjon
Å sette opp et utviklingsmiljø for XREAL Aura innebærer å installere kompatible verktøy, klargjøre et Android XR-prosjekt, aktivere riktig plattformstøtte og kontrollere tilkoblingen til enheten. Unity egner seg for prosjekter som skal bruke interaktivt 3D-innhold, mens Android Studio egner seg for native Android-grensesnitt. Et tydelig oppsett som kan gjentas, hjelper bedrifter med å redusere konfigurasjonsproblemer og gir utviklere et pålitelig grunnlag for å bygge og teste applikasjoner.
Planlegger du utvikling for XREAL Aura? Snakk med VR Expert om tilgang til maskinvare, programvarekrav og støtte ved utrulling.
Utforsk XR-maskinvare og støtte for bedrifter på: https://ai.vr-expert.com/

























