Pierwsze kroki z pakietem Jetpack XR SDK

Ten przewodnik zawiera instrukcje tworzenia aplikacji na Androida XR za pomocą pakietu Jetpack XR SDK. Obejmuje on niezbędne zależności i konfigurację projektu w Android Studio na potrzeby tworzenia wciągających rozwiązań XR.

Zgodność

Pakiet Jetpack XR SDK wymaga minSdk na poziomie 24 i musi być kompilowany w wersji SDK 34 lub nowszej.

Dodawanie zależności

Zapoznaj się z tymi przewodnikami, aby dowiedzieć się więcej o niezbędnych zależnościach i problemach ze zgodnością w przypadku poszczególnych bibliotek w pakiecie Jetpack XR SDK:

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

Groovy

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

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

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

Kotlin

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

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

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

Zobacz przykładową aplikację Hello Android XR.

Włącz minimalizację kodu (opcjonalnie)

Jeśli chcesz włączyć minifikację i zaciemnianie kodu za pomocą ProGuard w przypadku kompilacji, musisz dodać zależność od biblioteki Android Extensions for 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:

Groovy

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

Kotlin

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

Tworzenie nowej aplikacji w Android Studio za pomocą szablonu podstawowej aktywności zestawu słuchawkowego

Aby utworzyć nowy projekt, który zawiera Jetpack Compose na potrzeby XR, wykonaj te czynności:

  1. Jeśli jesteś w oknie Witamy w Android Studio, kliknij Rozpocznij nowy projekt w Android Studio. Jeśli masz już otwarty projekt Android Studio, na pasku menu wybierz Plik > Nowy.
  2. Wybierz XR w opcjach Szablon, a potem Podstawowe gogle XR.
  3. W oknie Skonfiguruj projekt wykonaj te czynności:
    1. Ustaw nazwę aplikacji.
    2. Wybierz lokalizację projektu dla próbki.
  4. Kliknij Zakończ.
  5. Sprawdź, czy plik build.gradle projektu jest prawidłowo skonfigurowany, zgodnie z opisem w sekcji Pliki właściwości Gradle.