Pierwsze kroki z pakietem Jetpack XR SDK

Ten przewodnik zawiera instrukcje tworzenia aplikacji na Androida XR przy użyciu 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:

• XR Runtime
• Jetpack SceneCore
• Jetpack Compose na potrzeby XR
• Material Design w przypadku XR
• ARCore w Jetpack XR

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

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha06"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha07"
    implementation "androidx.xr.compose:compose:1.0.0-alpha07"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha11"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha06"

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

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

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha06")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha07")
    implementation("androidx.xr.compose:compose:1.0.0-alpha07")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha11")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha06")

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

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

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:

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")
}

Utwórz nową aplikację w Android Studio, korzystając z 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 urządzenie Aktywność.
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.