Shrnutí
Tento návod ukazuje, jak v Android Studiu vytvořit firemní aplikaci pro XREAL Aura pomocí Kotlinu a Jetpack XR SDK. Vytvoříte projekt, přidáte knihovnu pro prostorové rozhraní, vložíte krátký příklad panelu s úkoly a spustíte jej v emulátoru XR Glasses, než jej otestujete na hardwaru Aura.
Příklad zobrazuje pracovní pokyny a umožňuje uživatelům potvrdit každý úkol. Jde o výchozí bod pro firemní aplikaci, bez trvalých pracovních záznamů a bez ověření, že byl fyzický úkol skutečně proveden. Kód vychází z prověřené dokumentace, ale nebyl zkompilován ani otestován na hardwaru Aura.
Úvod
Vývoj firemní aplikace pro XREAL Aura začíná v Android Studiu, kde píšete kód v Kotlinu a pomocí Jetpack XR SDK přidáváte prostorové rozhraní. Tento návod vás provede od vytvoření projektu přes jeho spuštění v emulátoru až po testování na zařízení Aura. Jako jednoduchý příklad vytvoříte panel, který zobrazuje pracovní pokyny a umožňuje uživateli potvrdit každý úkol.
XREAL Aura kombinuje kabelově připojené brýle s výpočetní jednotkou (puckem) se systémem Android XR. Postupujte podle pracovního postupu Android XR pro kabelové XR brýle, nikoli podle samostatného postupu pro audio a displejové brýle s projekcí z telefonu. Informace o hardwaru najdete v přehledu XREAL Aura od VRX a na oficiální stránce Aura od společnosti XREAL. [1]
Než začnete
· Pro úvodní stahování použijte počítač schválený vaší firmou s přístupem k internetu
· Zkontrolujte systémové požadavky XR emulátoru od Googlu, které v současnosti pokrývají podporované konfigurace Windows a macOS [2]
· Pro testování na fyzickém zařízení si opatřete brýle Aura, jejich výpočetní jednotku a pokyny k vývojářskému připojení dodávané se sadou
Dostupnost: Regionální dostupnost si ověřte u VR Expert. Aktuální stránka XREAL upřednostňuje USA, Kanadu, Japonsko a Jižní Koreu; starší seznamy rezervací by neměly být považovány za potvrzení dodávek do Evropy. [1]
Krok 1 Nainstalujte Android Studio a nástroje SDK
Začněte instalací Android Studia a nástrojů SDK, které slouží k sestavení aplikace, spuštění simulovaného XR zařízení a připojení k hardwaru.
Google pro XR doporučuje Android Studio Canary. Canary je předběžná verze s novějšími nástroji a potenciálně nedokončenými funkcemi; můžete ji nainstalovat vedle stávajícího Android Studia.
· Otevřete stránku Android Studio Preview, stáhněte příslušný instalační program a dokončete průvodce instalací.
· Na úvodní obrazovce Android Studia vyberte More Actions > SDK Manager. Pokud je už otevřený projekt, použijte v horní nabídce Tools > SDK Manager.
· V okně nastavení SDK Manager najdete nad seznamem instalovatelných balíčků karty SDK Platforms a SDK Tools. Obě karty jsou součástí stejného okna SDK Manager.
· Vyberte SDK Tools. Zaškrtněte Android SDK Build-Tools, Android Emulator a Android SDK Platform-Tools. Pokud jsou již nainstalované, nechte je vybrané a nainstalujte dostupné aktualizace. Build-Tools připravují instalační soubor aplikace, Emulator spouští simulovaná zařízení a Platform-Tools obsahují nástroj ADB pro připojení zařízení.
· Klikněte na Apply, zkontrolujte vybraná stahování, přijměte požadované licence a počkejte na dokončení instalace. Okno zavřete kliknutím na OK.
Karta SDK Platforms instaluje platformu Android, s níž se aplikace kompiluje. Požadovaná verze vyplývá z konfigurace projektu. V kroku 2 vytvořte projekt a podle jeho nastavení compileSdk pak vyberte odpovídající platformu. Krok 6 se zabývá systémovým obrazem XR emulátoru, který poskytuje operační systém pro simulované zařízení.
Kontrolní bod: Všechny tři nástroje SDK jsou nainstalované. Nyní můžete vytvořit projekt. [3, 13]
Krok 2 Vytvořte projekt firemní aplikace pro XREAL Aura
Šablona projektu XR vytvoří výchozí soubory aplikace a konfiguraci sestavení. Postupujte podle pokynů Googlu k projektům Android XR pro vaši nainstalovanou verzi Studia. [4]
· V Android Studiu se vraťte na úvodní obrazovku a klikněte na New Project, nebo zvolte File > New > New Project.
· V seznamu šablon vyberte XR a poté šablonu pro XR headsety a kabelové XR brýle. Stránka Googlu o projektech už názvy šablon neuvádí (pouze doporučuje zvolit šablonu odpovídající typu XR zařízení, pro které chcete vyvíjet) a názvy se mohou mezi vydáními Canary měnit, proto přesný název pro snímek obrazovky převezměte z IDE. Nevybírejte šablonu pro audio nebo displejové brýle, která vytváří prostředí promítané z telefonu.
· Klikněte na Next. Zadejte AuraTaskPanel do pole Name. Do pole Package name zadejte com.example.aurataskpanel (pro účely tohoto návodu). Pokud se zobrazí volba jazyka, vyberte Kotlin. Název balíčku identifikuje kód aplikace a lze jej přizpůsobit vaší organizaci. V Android Studiu se zadává jako identifikátor oddělený tečkami, bez https:// a bez cesty webové adresy.
Poté ponechte nastavení sestavení vygenerovaná šablonou a klikněte na Finish. Počkejte na dokončení první synchronizace Gradle. Při synchronizaci Android Studio načte konfiguraci sestavení a vyřeší její závislosti.
Otevřete View > Tool Windows > Project a v přepínači zobrazení panelu vyberte Android. Budete pracovat s těmito soubory:
· MainActivity.kt: app > kotlin+java > com.example.aurataskpanel. Obsahuje vstupní bod a rozhraní aplikace; v některých verzích je zdrojová složka označena java
· AndroidManifest.xml: app > manifests. Deklaruje vstupní bod aplikace, oprávnění a nastavení spouštění
· build.gradle.kts (Module :app): Gradle Scripts. Konfiguruje sestavení aplikace a knihovny
Nainstalujte platformu, kterou projekt vyžaduje
Nastavení compileSdk říká Android Studiu, kterou sadu Android API má při sestavování aplikace použít. Nainstalujte odpovídající platformu SDK; nevybírejte ji jen podle značky brýlí.
· V panelu Project v Android Studiu otevřete Gradle Scripts > build.gradle.kts (Module :app). V bloku android vyhledejte compileSdk. Hodnota jako compileSdk = 36 znamená, že projekt potřebuje Android API 36. Toto číslo je pouze příklad, nikoli povinná hodnota pro každý projekt Aura.
· Pokud hodnota odkazuje na položku katalogu, například libs.versions.compileSdk, otevřete Gradle Scripts > libs.versions.toml a přečtěte odkazovanou hodnotu. Pokud šablona používá název předběžné verze nebo vnořenou konfiguraci compileSdk, toto nastavení zachovejte a použijte odpovídající platformu.
· Otevřete Tools > SDK Manager > SDK Platforms. Vyberte řádek, jehož hodnota API Level odpovídá nastavení projektu. Klikněte na Apply, dokončete stahování a poté klikněte na OK.
· Vraťte se do projektu a vyberte File > Sync Project with Gradle Files, případně Sync Now, pokud ho nabízí lišta s upozorněním. Synchronizace Gradle načte nastavení sestavení a stáhne knihovny, které projekt vyžaduje.
Ponechte nastavení platformy ze šablony. Pokud Android Studio hlásí chybějící platformu, nainstalujte ji, místo abyste snižovali compileSdk jen kvůli tomu, abyste se vyhnuli stahování. Obraz XR zařízení používaný k testování se vybírá samostatně v kroku 6. [13]
Kontrolní bod: Požadovaná platforma SDK je nainstalovaná a okno nástroje Build nebo Sync neobsahuje žádné nevyřešené chyby.
Krok 3 Přidejte knihovnu XR a zkontrolujte kompatibilitu Kotlinu
Přidejte Jetpack Compose for XR, aby aplikace získala komponenty prostorových panelů, a zkontrolujte kompatibilitu Kotlinu, aby projekt mohl tuto knihovnu sestavit bez chyb verzí. Tento příklad používá XR Compose 1.0.0-beta02 (21-10-2026, stále nejnovější vydání), která podle poznámek k vydání od Googlu vyžaduje Kotlin 2.2. Podle stejných poznámek závisí beta02 na SceneCore 1.0.0-rc01, která obsahuje známý únik paměti, proto k řádku Compose v kroku 3 přidejte implementation (“androidx.xr.scenecore:1.0.0”) nebo novější verzi.
Jednorázová kontrola verze Kotlinu
· V Android Studiu rozbalte Gradle Scripts a kliknutím otevřete libs.versions.toml. Tento soubor, pokud existuje, představuje centrální seznam verzí knihoven a pluginů projektu.
· V sekci [versions] vyhledejte položku Kotlin, obvykle kotlin = "2.2.0" nebo jinou verzi 2.2.x. Ponechte kompatibilní verzi dodanou aktuální šablonou.
· Pokud projekt používá plugin org.jetbrains.kotlin.plugin.compose, jeho verze musí odpovídat Kotlinu. Šablony obvykle nechávají oba odkazovat na stejnou položku verze Kotlinu; toto propojení zachovejte.
· Pokud položka Kotlin nebo katalog chybí, zkontrolujte, zda soubor build.gradle.kts nejvyšší úrovně obsahuje explicitně deklarované pluginy Kotlinu. Některé novější konfigurace sestavení spravují Kotlin prostřednictvím nástrojů pro sestavení Androidu. V takovém případě ponechte vygenerovanou konfiguraci, a pokud se objeví chyba sestavení, zkontrolujte kompatibilitu Kotlinu se sadou nástrojů; nepřidávejte druhý plugin Kotlinu jen kvůli vytvoření položky verze.
Pokud šablona již obsahuje kompatibilní nástroje Kotlinu, nic neměňte. Pokud sestavení hlásí, že Kotlin je pro knihovnu XR příliš starý, aktualizujte nástroje Kotlinu v projektu společně s případným odpovídajícím pluginem kompilátoru Compose a použijte podporovanou konfiguraci pro danou šablonu. Neměňte nesouvisející nastavení sestavení.
Přidejte závislost pro prostorové rozhraní
· Otevřete Gradle Scripts > build.gradle.kts (Module :app).
· Najděte existující blok dependencies { ... }.
· Vyhledejte závislost XR Compose, zapsanou buď přímo, nebo prostřednictvím aliasu, například implementation(libs.androidx.xr.compose). Pokud alias již existuje, nastavte v libs.versions.toml jím odkazovanou verzi XR Compose na 1.0.0-beta02. Nepřidávejte stejnou knihovnu dvakrát.
· Pokud XR Compose chybí, přidejte do existujícího bloku dependencies tento řádek:
implementation("androidx.xr.compose:compose:1.0.0-beta02")Ostatní závislosti ze šablony ponechte. Níže uvedený kód používá zejména běžnou knihovnu Material 3, která poskytuje jeho tlačítka, text a motiv, a Activity Compose, která hostuje obsah Compose v aktivitě Androidu.
Synchronizace a další postup
Klikněte na Sync Now na liště editoru, nebo použijte File > Sync Project with Gradle Files. Počkejte, až se dokončí stahování a konfigurace.
Kontrolní bod: Synchronizace proběhne bez chyb závislostí nebo kompatibility Kotlinu. Po úspěšné synchronizaci ponechte ostatní vygenerovaná nastavení sestavení a otevřete MainActivity.kt, kam přidáte rozhraní. Pokud synchronizace hlásí chybu závislosti, porovnejte uvedenou komponentu se stránkou Googlu o nastavení Jetpack XR SDK. [6]
Krok 4 Vytvořte panel úkolů v Kotlinu
Rozhraní zobrazuje text úkolu s tlačítkem Mark complete a tlačítkem Restart demo. Ukázkové pokyny lze později nahradit schváleným pracovním postupem.
Ve stejném souboru MainActivity.kt v Android Studiu ponechte řádek package, pokud se váš balíček liší, a zbytek souboru nahraďte níže uvedeným kódem. Odstraňte z tohoto souboru staré ukázkové funkce a funkce náhledu ze šablony, aby v něm zůstala jen jedna MainActivity. Activity je vstupní bod Androidu, který hostuje rozhraní. Níže uvedený příklad obsahuje Activity i její importy.
package com.example.aurataskpanel
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.foundation.layout.*
import androidx.compose.foundation.rememberScrollState
import androidx.compose.foundation.verticalScroll
import androidx.compose.material3.*
import androidx.compose.runtime.*
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
import androidx.compose.ui.unit.sp
import androidx.xr.compose.platform.LocalSpatialCapabilities
import androidx.xr.compose.spatial.Subspace
import androidx.xr.compose.subspace.SpatialPanel
import androidx.xr.compose.subspace.layout.SubspaceModifier
import androidx.xr.compose.subspace.layout.height
import androidx.xr.compose.subspace.layout.width
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
MaterialTheme(colorScheme = darkColorScheme()) {
TaskApp()
}
}
}
}
@Composable
private fun TaskApp() {
val steps = listOf(
"Check that the training area is clear.",
"Confirm the training device is charged.",
"Open the approved training application."
)
var completed by rememberSaveable { mutableIntStateOf(0) }
val content: @Composable () -> Unit = {
TaskPanel(
steps = steps,
completed = completed,
onComplete = {
if (completed < steps.size) completed++
},
onRestart = { completed = 0 }
)
}
if (LocalSpatialCapabilities.current.isSpatialUiEnabled) {
Subspace {
SpatialPanel(
modifier = SubspaceModifier
.width(640.dp)
.height(540.dp)
) {
content()
}
}
} else {
content()
}
}
@Composable
private fun TaskPanel(
steps: List<String>,
completed: Int,
onComplete: () -> Unit,
onRestart: () -> Unit
) {
val finished = completed >= steps.size
Surface(modifier = Modifier.fillMaxSize()) {
Column(
modifier = Modifier
.fillMaxSize()
.verticalScroll(rememberScrollState())
.padding(24.dp),
verticalArrangement = Arrangement.spacedBy(16.dp)
) {
Text("Training station preparation", fontSize = 28.sp)
Text("Demo procedure v1.0", fontSize = 18.sp)
Text(
"$completed of ${steps.size} tasks acknowledged",
fontSize = 20.sp
)
Text(
if (finished) "Checklist complete"
else "Task ${completed + 1}: ${steps[completed]}",
fontSize = 26.sp
)
Text(
"Your confirmation does not verify physical work.",
fontSize = 18.sp
)
Button(
onClick = onComplete,
enabled = !finished,
modifier = Modifier
.fillMaxWidth()
.heightIn(min = 64.dp)
) {
Text("Mark complete", fontSize = 22.sp)
}
OutlinedButton(
onClick = onRestart,
modifier = Modifier
.fillMaxWidth()
.heightIn(min = 64.dp)
) {
Text("Restart demo", fontSize = 22.sp)
}
}
}
}Co kód dělá
· steps obsahuje text pokynů
· completed počítá potvrzení a brání posunu za poslední úkol
· rememberSaveable uchovává tuto malou hodnotu při podporovaném opětovném vytvoření obrazovky a obnovení stavu v Androidu; nejde o trvalé úložiště
· LocalSpatialCapabilities ověřuje, zda je k dispozici prostorové UI [7]
· Subspace vytváří oblast pro prostorový obsah a SpatialPanel do ní umisťuje rozhraní [8]
· Záložní větev zobrazuje stejný obsah v běžném okně, když prostorové UI není k dispozici
Jednotka dp přizpůsobuje rozměry rozvržení hustotě obrazovky; sp přizpůsobuje velikost textu a respektuje předvolby velikosti písma. Posuvný kontejner zajišťuje, že delší pokyny zůstanou dostupné. Velikost panelu berte jako výchozí bod a čitelnost ověřte na zařízení Aura.
Kontrolní bod: Android Studio rozpozná importy a nehlásí žádné syntaktické chyby Kotlinu. Pokud vámi nainstalovaná knihovna vyžaduje opt-in experimentálního API, použijte přesně tu anotaci, kterou uvádí diagnostika kompilátoru, a zkontrolujte referenční dokumentaci API pro dané vydání.
Krok 5 Zkontrolujte, jak se aplikace spouští v Android XR
Nakonfigurujte režim spuštění tak, aby Android XR mohl aplikaci otevřít s prostorovým rozvržením použitým v tomto příkladu.
Na brýlích Aura jsou režimy Home Space a Full Space již součástí Android XR a určují, jak se spuštěné aplikace zobrazují. Emulátor XR Glasses tyto režimy poskytuje pro vývoj, takže není nutná žádná samostatná instalace.
V panelu Project v Android Studiu otevřete app > manifests > AndroidManifest.xml a prohlédněte si položku MainActivity. Ponechte její intent filtr MAIN a LAUNCHER, nastavení exported a vygenerovaný motiv. Pro Full Space spravovaný přes Compose je příslušná vlastnost uvedena níže. Pokud šablona již deklaruje vlastnost spuštění na úrovni aplikace nebo aktivity, upravte příslušnou existující hodnotu, místo abyste ji duplikovali. [9]
<!-- Inside the existing MainActivity element -->
<property
android:name="android.window.PROPERTY_XR_ACTIVITY_START_MODE"
android:value="XR_ACTIVITY_START_MODE_FULL_SPACE_MANAGED" />Spravovaný režim Full Space znamená, že prostorovou scénu pro aktivitu spravuje Android. Hodnota UNMANAGED je určena pro aplikace, které vykreslují prostřednictvím OpenXR, multiplatformního rozhraní pro XR; tento příklad v Compose ji nepoužívá. Při porovnávání šablon si prohlédněte referenční přehled konstant manifestu. [9]
V existujícím elementu application také ponechte nebo přidejte android:enableOnBackInvokedCallback="true", aby prostorový panel přijímal události tlačítka Zpět, jak uvádí průvodce panely od Googlu; jeho příklad tento atribut nastavuje u elementu activity, platný je však i u elementu application. Pro tento statický kontrolní seznam nepřidávejte oprávnění ke kameře, mikrofonu ani k porozumění scéně. Aplikace nesnímá místnost ani nerozpoznává objekty. [8]
Krok 6 Vytvořte emulátor XR brýlí a spusťte aplikaci
Před připojením zařízení Aura spusťte aplikaci na simulovaných XR brýlích. Emulátor simuluje zařízení na vašem počítači; AVD je jeho uložená konfigurace.
· V Android Studiu otevřete Tools > Device Manager. Klikněte na ovládací prvek pro přidání zařízení a zvolte Create Virtual Device.
· V části Form Factor zvolte XR a poté XR Glasses. Klikněte na Next.
· Vyberte systémový obraz Preview API požadovaný pro profil XR Glasses a po výzvě jej stáhněte. Zvolte podporovanou architekturu obrazu odpovídající vašemu počítači. Dokončete konfiguraci.
· Spusťte AVD pomocí jeho tlačítka pro přehrávání. Počkejte, až se prostředí Android XR plně načte.
· Na horním panelu nástrojů Android Studia vyberte konfiguraci spuštění aplikace a spuštěné zařízení XR Glasses. Klikněte na Run (zelený trojúhelník).
Emulátor aplikaci nainstaluje a otevře. Pomocí jeho ovládacích prvků vstupu aktivujte Mark complete. Pokud panel zůstane v režimu Home Space, zkontrolujte před úpravou rozvržení v Kotlinu manifest a ovládací prvky Full Space v prostředí. Viz oficiální pokyny k AVD.
Proveďte tuto akceptační kontrolu:
· První obrazovka ukazuje nula ze tří potvrzených úkolů a první pokyn
· Každá aktivace Mark complete posune přesně o jeden pokyn
· Třetí aktivace zobrazí Checklist complete a deaktivuje Mark complete
· Restart demo obnoví první pokyn a nulový počet potvrzení
· Delší text zůstává dostupný posouváním
· Obsah se zobrazí i tehdy, když prostorové UI není k dispozici
Úspěšný test v emulátoru ověřuje část aplikační logiky a rozvržení. Neověřuje optiku Aura, spolehlivost vstupu ani vhodnost pro pracoviště.
Krok 7 Nasazení na autorizovaný hardware Aura
Následující kroky odpovídají standardnímu postupu ladění v Androidu. Nabídky a možnosti připojení zařízení Aura se mohou lišit podle verze softwaru, proto se tam, kde se liší, řiďte pokyny pro konkrétní sadu.
Připojení zařízení Aura a spuštění aplikace
· Spusťte Aura s připojenými brýlemi a otevřete na něm Settings (aplikaci Nastavení)
· Na zařízení Aura v rozhraní nastavení povolte Developer options a ladění podle pokynů k sadě; pokud tyto ovládací prvky nejsou k dispozici, vyžádejte si průvodce nastavením pro vývojáře
· Připojte počítač k nabíjecímu portu (Charging Port, levá strana) výpočetní jednotky pomocí datového kabelu USB a brýle nechte připojené k portu pro brýle (Glasses Port, pravá strana); pokud to nefunguje, zapojte kabel do portu na pravé straně pro plnou podporu ADB.
· Potvrďte výzvu k autorizaci ladění na zařízení; spravované zařízení může vyžadovat schválení administrátorem
· Na horním panelu nástrojů Android Studia vyberte v rozbalovacím seznamu zařízení Aura a klikněte na Run
· Na zařízení Aura zopakujte kontroly panelu úkolů z kroku 6, včetně posouvání úkolů a restartování kontrolního seznamu
Řešení potíží s připojením zařízení
Pokud se Aura nezobrazuje ve výběru cílového zařízení v Android Studiu, ověřte připojení pomocí ADB:
- V Android Studiu otevřete View > Tool Windows > Terminal.
- Spusťte následující příkaz:
adb devices -lZkontrolujte výstup:
· Pokud je vaše zařízení uvedeno se stavem device, je připojené a autorizované.
· Pokud se zobrazuje unauthorized, nasaďte si brýle a potvrďte výzvu k ladění přes USB na obrazovce.
· Pokud je seznam prázdný, znovu zkontrolujte datový kabel USB, ujistěte se, že je výpočetní jednotka zapnutá, a ověřte, že ladění přes USB zůstává v nastavení povolené.
Závěr
Vývoj první firemní aplikace pro XREAL Aura začíná s Android Studiem, Kotlinem a Jetpack XR SDK a postupuje od jednoduchého panelu s pracovními pokyny přes testování v emulátoru až po nasazení na autorizovaný hardware. Tento přístup dává firmám cílený způsob, jak ověřit, zda prostorové pokyny zlepšují reálný pracovní postup, ještě než investují do integrací a plošného zavedení. Jakmile je panel čitelný, použitelný a ověřený na zařízení Aura, dalším krokem je propojení schválených postupů a spolehlivých pracovních záznamů se systémy společnosti.
Proberte s VR Expert dostupnost Aura a požadavky na hardware, vývoj softwaru a podporu pro váš firemní pilotní projekt.

























