Jetpack XR SDK einrichten

XR‑Geräte, für die der Leitfaden gilt
Dieser Leitfaden hilft Ihnen dabei, Erlebnisse für die folgenden Arten von XR-Geräten zu entwickeln.
XR-Headsets
Kabelgebundene XR-Datenbrille
Audio- und
Display-Brillen

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

Kompatibilität mit dem Android SDK prüfen

Für das Jetpack XR SDK muss Ihre App eine minSdk von 24 und eine compileSdk von 34 oder höher verwenden.

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 entwickeln. Weitere Informationen zum Hinzufügen der Abhängigkeiten für Ihre App finden Sie in den folgenden Abschnitten.

Bibliotheksabhängigkeiten für immersive Funktionen (XR‑Headsets und XR‑Datenbrillen) hinzufügen

Sehen Sie sich zuerst die folgenden Referenzleitfäden an, um die erforderlichen Abhängigkeiten und Kompatibilitätsprobleme für die einzelnen 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.1.0-alpha02"
    implementation "androidx.xr.scenecore:scenecore:1.1.0-alpha01"
    implementation "androidx.xr.compose:compose:1.0.0-beta02"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha17"
    implementation "androidx.xr.arcore:arcore:1.1.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
    implementation("androidx.xr.scenecore:scenecore:1.1.0-alpha01")
    implementation("androidx.xr.compose:compose:1.0.0-beta02")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha17")
    implementation("androidx.xr.arcore:arcore:1.1.0-alpha01")
}

Code-Minimierung aktivieren (optional)

Wenn Sie die Codeminimierung und ‑verschleierung mit ProGuard für Ihre Builds aktivieren möchten, müssen Sie auch eine Abhängigkeit von der Android-Erweiterungen für XR-Bibliothek hinzufügen. Dies ist für Projekte erforderlich, die Jetpack XR alpha05 oder höher verwenden.

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.4.0"
}

Kotlin

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

Bibliotheksabhängigkeiten für Augmented-Reality-Funktionen (Audio- und Display-Brillen) hinzufügen

Sehen Sie sich zuerst die folgenden Referenzleitfäden an, um die erforderlichen Abhängigkeiten und Kompatibilitätsprobleme für die einzelnen 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.1.0-alpha02"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha22"
    implementation "androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha22"
    implementation "androidx.xr.projected:projected:1.0.0-alpha14"
    implementation "androidx.xr.arcore:arcore:1.1.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.1.0-alpha02")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha22")
    implementation("androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha22")
    implementation("androidx.xr.projected:projected:1.0.0-alpha14")
    implementation("androidx.xr.arcore:arcore:1.1.0-alpha01")
}