Pierwsza konfiguracja środowiska programistycznego dla XREAL Aura

Pierwsza konfiguracja środowiska programistycznego dla XREAL Aura

Streszczenie

Wybierz Unity, jeśli Twoja aplikacja biznesowa wymaga interaktywnych treści 3D, lub Android Studio, jeśli potrzebuje natywnego interfejsu Androida. Konfiguracja jest zakończona, gdy wymagane narzędzia są zainstalowane, projekt przechodzi kontrole konfiguracji, a urządzenie testowe lub emulator jest dostępny.

Instrukcje opierają się na oficjalnej dokumentacji Android XR. Porty programistyczne, menu oprogramowania układowego i uprawnienia specyficzne dla Aura należy sprawdzić w instrukcjach wdrożeniowych dostarczonych z urządzeniem. Niniejszy poradnik nie twierdzi, że był testowany na fizycznym urządzeniu Aura.

Wybierz ścieżkę programistyczną

Wybierz Unity, jeśli Twój projekt będzie wykorzystywać modele 3D, interaktywne szkolenia lub symulacje albo jeśli Twoi programiści już pracują z Unity i C#. Unity zapewnia wizualną przestrzeń roboczą do rozmieszczania treści i konfigurowania funkcji XR. Środowisko możesz skonfigurować bez pisania kodu i budowania prototypu.

Wybierz Android Studio, jeśli rozbudowujesz biznesową aplikację na Androida lub tworzysz natywne interfejsy, takie jak instrukcje stanowiskowe, formularze czy panele zadań. To środowisko korzysta z języka Kotlin i bibliotek Jetpack XR od Google. Każda z tych ścieżek może później połączyć się z systemami biznesowymi przez API, czyli zdefiniowany sposób wymiany informacji między programami; ścieżkę wybierz na podstawie interfejsu aplikacji i umiejętności swojego zespołu.

Główny edytor programistyczny:

  • Ścieżka Unity: Unity Editor instalowany przez Unity Hub
  • Ścieżka Android Studio: Android Studio

Język do dalszego programowania:

  • Ścieżka Unity: C#
  • Ścieżka Android Studio: Kotlin

Narzędzia do budowania na Androida:

  • Ścieżka Unity: Android Build Support, w tym SDK, NDK i OpenJDK
  • Ścieżka Android Studio: narzędzia Android SDK instalowane przez SDK Manager

Podstawowa obsługa XR:

  • Ścieżka Unity: OpenXR Plugin instalowany przez Unity Package Manager
  • Ścieżka Android Studio: biblioteki Jetpack XR SDK pobierane przez Gradle

Obsługa XR specyficzna dla platformy:

  • Ścieżka Unity: pakiet Unity OpenXR: Android XR
  • Ścieżka Android Studio: szablon projektu XR i wymagane biblioteki Jetpack XR

Co oznaczają narzędzia XR:

  • Ścieżka Unity: OpenXR to wspólny interfejs między aplikacją XR a środowiskiem uruchomieniowym urządzenia (runtime), czyli oprogramowaniem systemowym obsługującym funkcje XR
  • Ścieżka Android Studio: Jetpack XR SDK to zbiór bibliotek Google do tworzenia natywnych interfejsów przestrzennych i funkcji XR

Połączenie i diagnostyka:

  • Ścieżka Unity: ADB, czyli narzędzie Android Debug Bridge
  • Ścieżka Android Studio: ADB oraz Logcat w Android Studio, który wyświetla komunikaty diagnostyczne

Przygotuj stację roboczą i dostęp programistyczny

Przygotuj obsługiwany komputer programistyczny, niezawodne połączenie z internetem do pobierania zależności, zatwierdzony firmowy folder projektu oraz kabel USB do transmisji danych. Wymagania emulatora różnią się od wymagań edytora; zanim zaczniesz polegać na urządzeniu wirtualnym, sprawdź stronę Google z wymaganiami sprzętowymi emulatora XR. Urządzenie wirtualne to programowa symulacja urządzenia z Androidem. [4]

Użyj urządzenia Aura z autoryzowanym dostępem programistycznym, dołączonym połączeniem okularów oraz połączeniem programistycznym opisanym w dokumentacji XREAL. Zanim ustalisz termin warsztatów, potwierdź dostępność w swoim regionie i proces wdrożenia zestawu. Aktualne strony XREAL i strony regionalne mogą podawać różne informacje o dostępności; sama obecność produktu w ofercie nie przesądza o terminie dostawy. [1]

W zastosowaniach biznesowych, zanim zaczniesz komercyjnie korzystać z Unity, potwierdź, czy Twoja organizacja kwalifikuje się do licencji Unity, i sprawdź ewentualne warunki dotyczące wersji Industry. Korzystaj z kontrolowanego przez firmę systemu kontroli wersji, zatwierdzonych źródeł pakietów i danych testowych. Android Studio i Unity to narzędzia programistyczne do tworzenia profesjonalnych aplikacji; ich instalacja nie oznacza, że Aura obsługuje zarządzanie urządzeniami w przedsiębiorstwie.

Ścieżka A: konfiguracja środowiska programistycznego Unity

Ta ścieżka obejmuje instalację Unity i narzędzi Androida, utworzenie pustego projektu oraz włączenie obsługi Android XR. Przygotowuje przestrzeń roboczą do dalszego programowania.

Krok 1 | Zainstaluj edytor Unity

Unity Hub zarządza instalacjami edytora; Unity Editor to przestrzeń robocza, w której konfigurujesz projekty, a później tworzysz aplikację.

Zainstaluj Unity Hub z oficjalnej strony Unity i uruchom go. Przejdź do Installs, a następnie Install Editor. Wybierz obsługiwaną wersję Unity 6.5 (lub nowszą) zgodną z pakietem Android XR, którego będziesz używać, aby uzyskać pełną obsługę wejścia z gładzika modułu obliczeniowego (puck) i innych funkcji. Strona konfiguracji Google obecnie wymaga wersji 6000.0.58f2 lub nowszej; obowiązują też wymagania nowszych pakietów. [5]

Krok 2 | Dodaj narzędzia do budowania na Androida

Te moduły pozwalają Unity przekształcić projekt w aplikację na Androida.

XREAL Aura działa pod kontrolą Android XR, więc potrzebuje aplikacji na Androida, którą jej system operacyjny może zainstalować i uruchomić. Projekt Unity zawiera edytowalne pliki robocze; narzędzia do budowania na Androida pakują i kompilują te pliki do postaci instalowalnej aplikacji, zwykle pliku APK do testów na urządzeniu.

W modułach instalacji zaznacz Android Build Support wraz z elementami podrzędnymi, a następnie kliknij Continue i wykonaj kolejne kroki instalatora. Wymagane narzędzia to:

· Android SDK (Software Development Kit)

· Android NDK (Native Development Kit): przekształca kod niższego poziomu do postaci, którą może wykonać procesor urządzenia.

· JDK (Java Development Kit)

W przypadku istniejącego edytora wróć do Unity Hub > Installs, otwórz menu edytora, wybierz Add modules, zaznacz te same elementy i kliknij Installs.

Krok 3 | Utwórz projekt

Pusty projekt daje miejsce do skonfigurowania środowiska programistycznego Android XR.

W Unity Hub otwórz Projects > New project. Wybierz zainstalowany edytor i szablon Universal 3D. Nadaj projektowi nazwę AuraDevelopmentSetup, wybierz folder i kliknij Create project. Szablon Universal 3D korzysta z URP (Universal Render Pipeline), który renderuje grafikę aplikacji.

Krok 4 | Sprawdź ścieżki narzędzi

Unity musi wiedzieć, gdzie są zainstalowane zgodne narzędzia do budowania na Androida.

W Unity Editor otwórz Edit > Preferences > External Tools (w systemie macOS: Unity > Settings lub Preferences). Pozostaw zaznaczone dostarczone z Unity SDK (narzędzia platformy Android), NDK (narzędzia kompilatora kodu natywnego) i JDK (narzędzia do budowania w Javie). Te wersje są dopasowane do Twojego edytora Unity, co pomaga uniknąć błędów kompilacji. Nie zastępuj ich niezwiązanymi wersjami narzędzi z Android Studio tylko dlatego, że oba programy są zainstalowane.

Skonfiguruj środowisko programistyczne XREAL Aura w Unity

OpenXR to otwarty standard, który ułatwia aplikacjom XR komunikację ze zgodnymi środowiskami uruchomieniowymi urządzeń. W Unity zainstaluj OpenXR Plugin (podstawowe połączenie) oraz Unity OpenXR: Android XR (obsługa Android XR) za pomocą narzędzia Package Manager. AR Foundation to wspólny interfejs Unity dla obsługiwanych funkcji AR, takich jak rozpoznawanie otoczenia.

Krok 1 | Wybierz platformę docelową Android XR

Platforma docelowa (build target) informuje Unity, na jakiej platformie ma działać aplikacja.

Otwórz File > Build Profiles. W Unity 6.1 lub nowszym dodaj albo wybierz profil platformy Android XR i przełącz się na niego. Według dokumentacji Unity może to automatycznie zainstalować zgodny pakiet Android XR. Jeśli Twój obsługiwany edytor korzysta zamiast tego z platformy Android, wybierz Android i skonfiguruj OpenXR ręcznie. [7]

Krok 2 | Zainstaluj pakiety OpenXR

Pakiety dodają komponenty oprogramowania, które łączą scenę Unity z Android XR.

Otwórz Window > Package Management > Package Manager lub Window > Package Manager w edytorach ze starszym układem menu. Sprawdź, czy pakiety OpenXR Plugin i Unity OpenXR: Android XR są zainstalowane. Jeśli brakuje pakietu Android XR, użyj menu plus > Add package by name i wpisz com.unity.xr.androidxr-openxr. Identyfikator podstawowego pakietu OpenXR to com.unity.xr.openxr. Pozwól, aby Package Manager rozwiązał zgodne zależności. [6]

Krok 3 | Włącz dostawcę XR

Instalacja pakietu sprawia, że jest on dostępny; włączenie dostawcy pozwala aplikacji z niego korzystać.

Otwórz Edit > Project Settings > XR Plug-in Management. Na karcie Android włącz OpenXR. Otwórz znajdującą się poniżej sekcję OpenXR i włącz grupę funkcji Android XR. Jeśli korzystasz z funkcji AR Foundation, włącz Android XR: Session. W wersji 1.0 włącz Android XR: AR Session. Nie włączaj niezwiązanych dostawców dla tej kompilacji. [8]

Krok 4 | Zweryfikuj projekt

Walidacja wskazuje ustawienia, które uniemożliwiłyby utworzenie obsługiwanej kompilacji XR.

Otwórz XR Plug-in Management > Project Validation i wybierz Android. Przejrzyj i rozwiąż wymagane problemy, a następnie sprawdź ponownie. Wymagania walidacji konkretnego pakietu mają pierwszeństwo przed ustawieniami skopiowanymi ze starszego samouczka.

Krok 5 | Ogranicz wymagania dotyczące wejścia do minimum

Włączaj tylko funkcje wymagane przez planowaną aplikację i obsługiwane przez urządzenie docelowe.

Opcjonalne funkcje wejścia pozostaw na etap tworzenia aplikacji, chyba że wymaga ich projekt lub szablon. Włączenie profilu śledzenia wzroku lub kontrolera nie dodaje tego sprzętu do Aura. Zanim przejdziesz dalej, przejrzyj wymagane ustawienia interakcji w sekcji Project Validation.

Android XR Extensions for Unity od Google to dodatkowy pakiet z dodatkowymi funkcjami. Nie jest tym samym co Unity OpenXR: Android XR. Nie musisz go dodawać tylko dlatego, że nazwy brzmią podobnie; dodaj go, gdy Twoja aplikacja potrzebuje funkcji, którą zapewnia. [9]

Sprawdź ustawienia renderowania i kompilacji na Androida

Vulkan to interfejs graficzny służący do przekazywania zadań renderowania do GPU. W Edit > Project Settings > Player wybierz Android > Other Settings. Jeśli opcja Auto Graphics API jest włączona, wyłącz ją i umieść Vulkan na pierwszym miejscu. Aby uzyskać prostą konfigurację bazową URP, wyłącz HDR w zasobie URP oraz postprocessing w powiązanym z nim zasobie renderera. Google zaleca te ustawienia dla Android XR. [5]

W tych samych ustawieniach Player ustaw unikalny identyfikator pakietu, np. com.yourcompany.aurapilot. W sekcji Configuration wybierz IL2CPP i ARM64 dla kompilacji na fizyczne urządzenie. IL2CPP przekształca kod C# w kod natywny; ARM64 to architektura procesora, dla której przeznaczona jest kompilacja. Sprawdź walidację zainstalowanych pakietów i wymagania urządzenia pod kątem dodatkowych ograniczeń.

Google podaje API 24 jako minimum dla loadera OpenXR, a nie jako wersję systemu operacyjnego Aura. Użyj minimalnego poziomu API, który spełnia także wymagania wszystkich zainstalowanych pakietów, oraz zainstalowanego docelowego SDK obsługiwanego przez Twój edytor i zgodnego z wymaganiami dystrybucji. Skonfiguruj GameActivity jako punkt wejścia aplikacji, odznacz Activity i włącz Resizable Activity w sekcji Resolution and Presentation, zgodnie z zaleceniami Google. [5]

Ścieżka B: konfiguracja środowiska programistycznego Android Studio

Ta ścieżka obejmuje instalację Android Studio, pobranie narzędzi programistycznych Androida i utworzenie projektu XR na podstawie szablonu Google. Przygotowuje natywną przestrzeń roboczą Androida do dalszego tworzenia aplikacji. Możesz też utworzyć emulator, aby sprawdzić, czy projekt się kompiluje i uruchamia.

Przegląd konfiguracji: zainstaluj Android Studio → pobierz narzędzia Androida → utwórz projekt XR → sprawdź zależności → przygotuj cel testowy.

Android Studio to środowisko programistyczne Google do tworzenia aplikacji na Androida. Kotlin to używany tutaj język programowania. Jetpack XR SDK udostępnia natywne biblioteki przestrzennego interfejsu użytkownika i XR, a Jetpack Compose pozwala opisywać interfejsy w kodzie Kotlin.

Krok 1 | Zainstaluj edytor zgodny z XR

Zalecana wersja Android Studio zawiera narzędzia i szablony XR używane w tej ścieżce.

Pobierz kompilację Android Studio zalecaną na stronie Google poświęconej konfiguracji XR. Obecne wytyczne zalecają najnowszą wersję Canary; w razie potrzeby zainstaluj ją obok zwykłej wersji stabilnej. Canary oznacza wczesną wersję rozwojową, dlatego zapisz dokładny numer wersji używanej przez zespół. [10]

Krok 2 | Pobierz narzędzia programistyczne Androida

SDK Manager instaluje komponenty potrzebne do kompilowania, uruchamiania i analizowania aplikacji.

Na ekranie powitalnym otwórz More Actions > SDK Manager. W zakładce SDK Tools zainstaluj lub zaktualizuj Android SDK Build-Tools, Android Emulator i Android SDK Platform-Tools, a także wersję Layout Inspector wskazaną w aktualnych instrukcjach Google. Kliknij Apply i zaakceptuj licencje. [10]

Krok 3 | Utwórz projekt XR

Szablon XR zapewnia aplikację startową z gotową strukturą przestrzenną.

Otwórz New Project. Na liście szablonów wybierz XR, a następnie szablon immersyjny dla gogli XR lub przewodowych okularów XR. Nie wybieraj szablonu dla okularów audio ani okularów z wyświetlaczem. Kliknij Next, nazwij projekt AuraBusinessPanel, ustaw firmową nazwę pakietu, jeśli jest taka opcja, wybierz folder zapisu i kliknij Finish. [11]

Krok 4 | Pozwól projektowi pobrać zależności

Gradle sync przygotowuje biblioteki i konfigurację kompilacji, zanim zaczniesz edytować aplikację.

Poczekaj, aż Gradle sync się zakończy. Gradle to system kompilacji, który pobiera zależności i kompiluje aplikację. Otwórz panel Project i znajdź plik app/build.gradle.kts lub plik Gradle modułu app. Zachowaj wzajemnie zgodne wersje z szablonu; nie aktualizuj na chybił trafił pojedynczej biblioteki XR.

Krok 5 | Sprawdź wymagania dotyczące API Androida

Ustawienia API muszą spełniać wymagania szablonu i każdej używanej biblioteki.

Porównaj stronę konfiguracji Jetpack XR SDK ze swoim szablonem. Opublikowane minimum to minSdk 24 i compileSdk 34 lub wyższe; użyj wyższych wartości, jeśli wymagają tego wybrane biblioteki lub szablon. compileSdk to API Androida używane podczas kompilacji, a minSdk określa najstarsze obsługiwane API Androida. [12]

Strona konfiguracji SDK wymienia zależności Runtime, SceneCore, Compose for XR, Material Design for XR i ARCore for Jetpack XR. Dodaj tylko te, z których korzysta aplikacja. SceneCore zarządza treściami przestrzennymi; ARCore for Jetpack XR zapewnia obsługiwane funkcje percepcji. Wersje zapoznawcze mogą się zmieniać, dlatego korzystaj jednocześnie z szablonu i informacji o wersji, zamiast wklejać stary blok zależności.

Jeśli szablon nie zawiera automatycznie podstawowych bibliotek XR, upewnij się, że plik app/build.gradle.kts zawiera następujące bazowe zależności:

android {

compileSdk = 34 // lub wyższa wartość ustawiona przez szablon

defaultConfig {

minSdk = 24

}

}

dependencies {

// Podstawowe zależności 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")

}

W dniu przygotowania tego opracowania Compose for XR 1.0.0-beta02 (21-10-2026) wymaga Kotlina 2.2, a według informacji o wersji zależy od SceneCore 1.0.0-rc01, w którym występuje znany wyciek pamięci; obejściem jest samodzielne zadeklarowanie SceneCore 1.0.0 lub nowszego, co powyższy blok zależności już robi. To jeden z powodów, by zapisywać pełny zestaw zależności, zamiast opisywać dowolną najnowszą instalację jako gotową do produkcji. [13]

Uruchom aplikację w emulatorze XR, zanim sprzęt będzie dostępny

Krok 1 | Utwórz wirtualne urządzenie XR

Emulator pozwala sprawdzić oprogramowanie, zanim fizyczne urządzenie Aura będzie dostępne.

Otwórz Tools > Device Manager, a następnie Add a new device > Create Virtual Device. Jako format urządzenia wybierz XR, a w przypadku pracy z okularami przewodowymi wybierz XR Glasses. [4]

Krok 2 | Zainstaluj wymagany obraz systemu

Obraz systemu zapewnia środowisko systemu operacyjnego Android XR dla urządzenia wirtualnego.

Wybierz obraz systemu w wersji zapoznawczej wymagany dla XR Glasses zgodnie z poradnikiem Google, pobierz go, jeśli pojawi się monit, i dokończ tworzenie urządzenia wirtualnego. Uruchom je z poziomu Device Manager.

Krok 3 | Uruchom aplikację

Android Studio kompiluje projekt i instaluje go na wybranym urządzeniu wirtualnym.

Na górnym pasku narzędzi Android Studio wybierz konfigurację uruchomieniową app oraz działające wirtualne urządzenie XR. Kliknij Run. Pozwól Android Studio skompilować i zainstalować niezmodyfikowany szablon. Na potrzeby tej kontroli środowiska nie musisz dostosowywać jego interfejsu.

Krok 4 | Sprawdź wynik

Udana kompilacja i uruchomienie potwierdzają, że zainstalowane narzędzia potrafią przetworzyć szablon.

Sprawdź, czy szablon otwiera się bez błędów kompilacji lub uruchamiania. Potwierdza to podstawową konfigurację oprogramowania, ale nie optykę Aura, fizyczne śledzenie, wydajność ani gotowość produkcyjną.

Podłącz XREAL Aura do komputera programistycznego

ADB, czyli Android Debug Bridge, pozwala komputerowi programistycznemu instalować aplikacje i odczytywać logi diagnostyczne z urządzenia z Androidem. Mogą z niego korzystać zarówno Unity, jak i Android Studio.

Według FAQ XREAL dotyczącego Aura oba porty USB-C w module obliczeniowym (compute puck) obsługują standardowe debugowanie ADB z Android Studio, ale tabela specyfikacji wymienia pełną obsługę ADB tylko przy porcie Glasses Port, dlatego w miarę możliwości korzystaj z tego portu. Pozostaw okulary podłączone zgodnie z instrukcją. Wyświetlanie lustrzane przez DisplayPort i autoryzowane połączenie ADB to różne funkcje, więc widoczny w okularach ekran laptopa nie dowodzi, że połączenie programistyczne działa.

Krok 1 | Włącz autoryzowane debugowanie

Debugowanie pozwala komputerowi programistycznemu instalować i analizować aplikacje testowe.

W systemie Android XR otwórz Settings i włącz Developer options oraz USB debugging, korzystając z instrukcji dla swojej wersji oprogramowania układowego. W standardowym Androidzie Developer options zwykle odblokowuje się, wielokrotnie wybierając Build number, ale w przejrzanych publicznych źródłach nie udało się ustalić dokładnej ścieżki menu w Aura. Jeśli dostarczona instrukcja wdrożeniowa podaje inną ścieżkę, skorzystaj z niej. [14]

Krok 2 | Podłącz i autoryzuj komputer

W tym przewodowym procesie debugowania wymagane są połączenie USB do transmisji danych i zatwierdzenie na urządzeniu.

Podłącz komputer hosta kablem USB do transmisji danych do udokumentowanego portu programistycznego. Na urządzeniu zatwierdź monit o autoryzację debugowania z tego komputera. W systemie Windows zainstaluj sterownik ADB producenta, jeśli system go wymaga. [14]

Krok 3 | Sprawdź, czy ADB widzi urządzenie

Lista urządzeń potwierdza, że połączenie jest gotowe, zanim spróbujesz skompilować i uruchomić aplikację.

W Android Studio otwórz SDK Manager i zanotuj wartość Android SDK Location. W terminalu przejdź do folderu platform-tools tego SDK i uruchom odpowiednie polecenie poniżej.

# Windows PowerShell, w folderze platform-tools

.\adb.exe devices -l

# macOS lub Linux, w folderze platform-tools

./adb devices -l

Oczekiwany wynik: po numerze seryjnym urządzenia widnieje słowo device. Jeśli widnieje unauthorized, zatwierdź monit. Jeśli lista jest pusta, sprawdź kabel, port komputera, ustawienie debugowania i sterownik. Jeśli podłączonych jest więcej urządzeń lub emulatorów, jawnie wskaż właściwe urządzenie docelowe.

Sprawdź, czy środowisko programistyczne jest gotowe

Kontrola gotowości w Unity

Krok 1 | Sprawdź profil kompilacji

Sprawdź konfigurację przed rozpoczęciem tworzenia aplikacji.

Otwórz File > Build Profiles i potwierdź, że aktywny jest profil Android XR lub profil Android skonfigurowany pod XR. Upewnij się, że wymagane moduły kompilacji Androida są dostępne dla tego edytora.

Krok 2 | Sprawdź pakiety i walidację

Projekt musi mieć zainstalowane i włączone wymagane pakiety XR.

W Package Manager sprawdź pakiety OpenXR Plugin i Unity OpenXR: Android XR. W Project Settings > XR Plug-in Management potwierdź, że włączony jest dostawca OpenXR dla Androida oraz grupa funkcji Android XR. Rozwiąż wymagane problemy w sekcji Project Validation.

Krok 3 | Sprawdź urządzenie docelowe

Rozpoznane urządzenie kończy część konfiguracji dotyczącą połączenia.

W Build Profiles odśwież listę Run Device i sprawdź, czy pojawia się na niej Twoje autoryzowane urządzenie Aura. Jeśli nie, sprawdź połączenie ADB oraz ścieżki w External Tools w Unity. Projekt możesz skonfigurować, zanim sprzęt będzie dostępny, ale weryfikacja wdrożenia na fizycznym urządzeniu musi poczekać na urządzenie.

Kontrola gotowości w Android Studio

Upewnij się, że Gradle sync kończy się bez błędów, SDK Manager ma zainstalowane wymagane narzędzia, a emulator XR lub autoryzowane urządzenie Aura pojawia się w selektorze urządzeń docelowych. Jeśli masz dostępny cel testowy, uruchom niezmodyfikowany szablon XR. Otwórz View > Tool Windows > Logcat, aby sprawdzić błędy uruchamiania. Logcat wyświetla komunikaty diagnostyczne Androida.

Jak Unity i Android Studio ze sobą współpracują

Unity może kompilować aplikacje na Androida przy użyciu własnych obsługiwanych narzędzi, więc Android Studio nie jest potrzebne do konfiguracji projektu Unity. Android Studio może jednak pomóc w zarządzaniu emulatorami i diagnostyce Androida, np. za pomocą Logcat. Warto podkreślić, że emulator Android XR nie obsługuje symulacji aplikacji zbudowanych w Unity, Godot, Unreal Engine ani OpenXR, dlatego kompilacje z Unity wymagają fizycznego urządzenia Aura. W przypadku natywnej aplikacji w Kotlinie Android Studio jest główną przestrzenią roboczą, a Unity nie jest potrzebne.

Na potrzeby późniejszego dostosowywania kompilacji na Androida Unity może wyeksportować projekt Gradle do Android Studio. Na etapie początkowej konfiguracji ten krok nie jest potrzebny. Pozostaw wybrane własne obsługiwane narzędzia kompilacji Unity, chyba że Twoja integracja wyraźnie wymaga procesu eksportu.

Rozwiązywanie problemów przy pierwszej konfiguracji

  • Platforma docelowa Android jest niedostępna: dodaj Android Build Support do właściwej instalacji edytora Unity
  • Brak grupy Android XR: sprawdź identyfikator pakietu, zgodność i kartę platformy Android
  • Gradle sync kończy się niepowodzeniem: przeczytaj pierwszy błąd kompilacji; sprawdź instalację SDK i dopasowanie wersji zależności
  • Brakuje wymaganych pakietów lub funkcji: sprawdź Package Manager, aktywną platformę Android i grupę funkcji Android XR
  • Project Validation pokazuje błędy: przejrzyj każdy wymagany problem i zastosuj poprawkę właściwą dla zainstalowanej wersji pakietu
  • Urządzenie ma status unauthorized: zatwierdź monit debugowania na urządzeniu
  • Instalacja w emulatorze kończy się niepowodzeniem: sprawdź, czy architektura APK pasuje do obrazu systemu emulatora

Podsumowanie

Konfiguracja środowiska programistycznego XREAL Aura obejmuje instalację zgodnych narzędzi, przygotowanie projektu Android XR, włączenie odpowiedniej obsługi platformy i sprawdzenie połączenia z urządzeniem. Unity sprawdza się w projektach wykorzystujących interaktywne treści 3D, a Android Studio – w natywnych interfejsach Androida. Przejrzysta, powtarzalna konfiguracja pomaga firmom ograniczyć problemy konfiguracyjne i daje programistom solidną podstawę do tworzenia i testowania aplikacji.

Planujesz tworzenie oprogramowania dla XREAL Aura? Porozmawiaj z VR Expert o dostępie do sprzętu, wymaganiach dotyczących oprogramowania i wsparciu przy wdrożeniu.

Poznaj sprzęt XR dla firm i ofertę wsparcia na stronie: https://ai.vr-expert.com/

João Noronha

Napisane przez

João Noronha

Specjalista ds. XR i treści immersyjnych w VR Expert

João Noronha jest specjalistą ds. XR i treści immersyjnych w VR Expert, z dużym zainteresowaniem technologiami przyszłości i ich praktycznymi zastosowaniami. Skupia się na przekształcaniu złożonych osiągnięć w dziedzinie VR, AR, okularów AI i technologii immersyjnych w jasne, praktyczne treści dla firm i specjalistów odkrywających branżę XR.

Często zadawane pytania

Ten artykuł

Nie. Wybierz Unity w przypadku ścieżki 3D lub Android Studio w przypadku ścieżki natywnej. Android Studio nadal przydaje się do diagnostyki i zarządzania emulatorami, gdy głównym edytorem jest Unity.

Udokumentowanym punktem wyjścia jest Android XR z pakietami Android XR dla Unity lub Jetpack XR. Komponent konkretnego producenta dodaj tylko wtedy, gdy wymaga tego aktualna dokumentacja Aura. Nie zakładaj, że starsze SDK XREAL można stosować zamiennie ze stosem Android XR.

Tak. Emulator XR Glasses w Android Studio pozwala zweryfikować działanie obsługiwanego oprogramowania. Według Google emulator nie obsługuje aplikacji zbudowanych w Unity, Godot, Unreal Engine ani OpenXR, więc te ścieżki wymagają fizycznego urządzenia Aura. Do zatwierdzenia wydajności urządzenia, śledzenia i użyteczności nadal potrzebny jest fizyczny sprzęt.

Nie. OpenXR zapewnia wspólne interfejsy, ale poszczególne rozszerzenia, czujniki, metody wprowadzania i uprawnienia nadal zależą od urządzenia. Przed włączeniem zaawansowanych funkcji sprawdź ich obsługę w środowisku uruchomieniowym.

Do zainstalowania narzędzi, skonfigurowania Android XR i sprawdzenia połączenia z urządzeniem nie jest potrzebny własny kod. Android Studio może skompilować niezmodyfikowany szablon XR w ramach kontroli konfiguracji. Kod aplikacji dodasz, gdy zaczniesz implementować funkcje biznesowe.