Konfigurowanie pakietu Jetpack XR SDK

Odpowiednie urządzenia XR

Ten przewodnik pomoże Ci tworzyć aplikacje na te typy urządzeń XR.

Więcej informacji o typach urządzeń z XR →

Więcej informacji o typach urządzeń z XR →

Zanim zaczniesz tworzyć aplikacje, musisz skonfigurować pakiet Jetpack XR SDK. Aby skonfigurować środowisko programistyczne za pomocą pakietu SDK, wykonaj czynności opisane w poszczególnych sekcjach.

Sprawdzanie zgodności z Androidem SDK

Pakiet Jetpack XR SDK wymaga, aby aplikacja korzystała z Androida minSdk w wersji 24 i compileSdk w wersji 34 lub nowszej.

Dodawanie zależności bibliotek

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

Dodawanie zależności bibliotek w przypadku aplikacji immersyjnych (gogle XR i okulary XR)

Najpierw zapoznaj się z tymi przewodnikami, aby dowiedzieć się więcej o niezbędnych zależnościach i problemach ze zgodnością w przypadku każdej z wymaganych bibliotek:

• XR Runtime
• Jetpack SceneCore
• Jetpack Compose for XR
• Material Design for XR
• ARCore for Jetpack XR

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

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha12"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha13"
    implementation "androidx.xr.compose:compose:1.0.0-alpha12"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha16"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha12"

    // For compatibility with guava, use these dependencies:
    implementation "androidx.xr.arcore:arcore-guava:1.0.0-alpha12"
    implementation "androidx.xr.runtime:runtime-guava:1.0.0-alpha12"
    implementation "androidx.xr.scenecore:scenecore-guava:1.0.0-alpha13"

    // For compatibility with rxjava3, use these dependencies:
    implementation "androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha12"
    implementation "androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha12"
}

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha12")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha13")
    implementation("androidx.xr.compose:compose:1.0.0-alpha12")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha16")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha12")

    // For compatibility with guava, use these dependencies:
    implementation("androidx.xr.arcore:arcore-guava:1.0.0-alpha12")
    implementation("androidx.xr.runtime:runtime-guava:1.0.0-alpha12")
    implementation("androidx.xr.scenecore:scenecore-guava:1.0.0-alpha13")

    // For compatibility with rxjava3, use these dependencies:
    implementation("androidx.xr.arcore:arcore-rxjava3:1.0.0-alpha12")
    implementation("androidx.xr.runtime:runtime-rxjava3:1.0.0-alpha12")
}

Włączanie minifikacji kodu (opcjonalnie)

Jeśli chcesz włączyć minifikację i zaciemnianie kodu za pomocą ProGuarda w swoich kompilacjach, musisz też dodać zależność od biblioteki Android Extensions for XR. Jest to wymagane w przypadku projektów korzystających z Jetpack XR alpha05 lub nowszego.

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

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

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

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

Najpierw zapoznaj się z tymi przewodnikami, aby dowiedzieć się więcej o niezbędnych zależnościach i problemach ze zgodnością w przypadku każdej z wymaganych bibliotek:

• XR Runtime
• ARCore for Jetpack XR
• Jetpack Compose Glimmer
• Jetpack Projected

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

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha12"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha11"
    implementation "androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha11"
    implementation "androidx.xr.projected:projected:1.0.0-alpha06"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha12"
}

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha12")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha11")
    implementation("androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha11")
    implementation("androidx.xr.projected:projected:1.0.0-alpha06")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha12")
}