Jetpack XR SDK einrichten

Anwendbare XR‑Geräte
Dieser Leitfaden hilft Ihnen dabei, Erlebnisse für diese Arten von XR-Geräten zu entwickeln.
XR-Headsets
XR-Datenbrille mit Kabel
AI Glasses

Bevor Sie mit der Entwicklung beginnen können, müssen Sie das Jetpack XR SDK einrichten. Folgen Sie den Schritten in den einzelnen Abschnitten, um Ihre Entwicklungsumgebung mit dem SDK einzurichten.

Android SDK-Kompatibilität prüfen

Für das Jetpack XR SDK muss für Ihre App ein Android-minSdk von 24 und ein compileSdk von 34 oder höher verwendet werden.

Bibliotheksabhängigkeiten hinzufügen

Die Abhängigkeiten, die Ihre App benötigt, hängen von den Arten von Erlebnissen und XR-Geräten ab, für die Sie sie entwickeln. Weitere Informationen zum Hinzufügen der Abhängigkeiten für Ihre App finden Sie in den folgenden Abschnitten.

Bibliotheksabhängigkeiten für immersive Erlebnisse (XR‑Headsets und ‑Brillen) hinzufügen

Sehen Sie sich zuerst die folgenden Referenzanleitungen an, um die erforderlichen Abhängigkeiten und Kompatibilitätsprobleme für jede der erforderlichen Bibliotheken zu verstehen:

Fügen Sie dann der Datei build.gradle.kts Ihrer App die erforderlichen Abhängigkeiten hinzu:

Groovy

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

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

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

Kotlin

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

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

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

Code-Minifizierung aktivieren (optional)

Wenn Sie die Code-Minimierung und ‑Verschleierung mit ProGuard für Ihre Builds aktivieren möchten, müssen Sie auch eine Abhängigkeit von der Bibliothek „Android Extensions for XR“ hinzufügen. Dies ist für Projekte erforderlich, in denen Jetpack XR alpha05 oder höher verwendet wird.

Fügen Sie der Datei build.gradle.kts Ihres Moduls die folgende compileOnly-Abhängigkeit hinzu:

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

Bibliotheksabhängigkeiten für Augmented Reality-Funktionen (KI-Brille) hinzufügen

Sehen Sie sich zuerst die folgenden Referenzanleitungen an, um die erforderlichen Abhängigkeiten und Kompatibilitätsprobleme für jede der erforderlichen Bibliotheken zu verstehen:

Fügen Sie dann der Datei build.gradle.kts Ihrer App die erforderlichen Abhängigkeiten hinzu:

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha09"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha02"
    implementation "androidx.xr.projected:projected:1.0.0-alpha03"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha09"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha09")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha02")
    implementation("androidx.xr.proejcted:projected:1.0.0-alpha03")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha09")
}