Konfigurowanie pakietu Jetpack XR SDK

Odpowiednie urządzenia XR
Te wskazówki pomogą Ci tworzyć aplikacje na te typy urządzeń XR.
Gogle XR
Okulary XR z przewodem
Okulary audio i
wyświetlacz

Zanim zaczniesz tworzyć aplikację, musisz skonfigurować pakiet Jetpack XR SDK. Wykonaj czynności opisane w każdej sekcji, aby skonfigurować środowisko programistyczne za pomocą pakietu SDK.

Sprawdzanie zgodności pakietu Android SDK

Pakiet SDK Jetpack XR wymaga, aby aplikacja korzystała z interfejsu API Androida w wersji minSdkcompileSdk w wersji 34 lub nowszej.

Dodawanie zależności biblioteki

Zależności wymagane przez aplikację zależą od typów środowisk i urządzeń XR, dla których tworzysz aplikację. Więcej informacji o dodawaniu zależności do aplikacji znajdziesz w kolejnych sekcjach.

Dodawanie zależności bibliotek w przypadku treści immersyjnych (gogli XR i okularów XR)

Najpierw zapoznaj się z tymi przewodnikami, aby poznać niezbędne zależności i problemy ze zgodnością w przypadku każdej z wymaganych bibliotek:

Następnie dodaj niezbędne zależności do pliku build.gradle.kts aplikacji:

Dynamiczny

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha15"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha16"
    implementation "androidx.xr.compose:compose:1.0.0-alpha15"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha17"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha15"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha15")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha16")
    implementation("androidx.xr.compose:compose:1.0.0-alpha15")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha17")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha15")
}

Włącz minifikację kodu (opcjonalnie)

Jeśli chcesz włączyć minifikację i zaciemnianie kodu za pomocą ProGuard w przypadku kompilacji, musisz też dodać zależność od biblioteki rozszerzeń Androida dla XR. Jest to wymagane w przypadku projektów korzystających z Jetpack XR w wersji alpha05 lub nowszej.

Dodaj do pliku build.gradle.kts modułu tę zależność compileOnly:

Dynamiczny

dependencies {
    // ... other dependencies
    compileOnly "com.android.extensions.xr:extensions-xr:1.3.0"
}

Kotlin

dependencies {
    // ... other dependencies
    compileOnly("com.android.extensions.xr:extensions-xr:1.3.0")
}

Dodawanie zależności bibliotek w przypadku funkcji rozszerzonych (okulary z AI)

Najpierw zapoznaj się z tymi przewodnikami, aby poznać niezbędne zależności i problemy ze zgodnością w przypadku każdej z wymaganych bibliotek:

Następnie dodaj niezbędne zależności do pliku build.gradle.kts aplikacji:

Dynamiczny

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha15"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha13"
    implementation "androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha13"
    implementation "androidx.xr.projected:projected:1.0.0-alpha08"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha14"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha15")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha13")
    implementation("androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha13")
    implementation("androidx.xr.projected:projected:1.0.0-alpha08")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha14")
}