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.
Informationen zu XR-Gerätetypen →
XR-Headsets
XR-Brillen mit Kabel
KI-Brillen
Informationen zu XR-Gerätetypen →

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

Android SDK-Kompatibilität prüfen

Für das Jetpack XR SDK muss Ihre App ein Android minSdk von 24 und ein 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 Erlebnisse hinzufügen (XR-Headsets und XR-Brillen)

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

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

Groovy

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

Kotlin

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

Code-Minifizierung aktivieren (optional)

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

Fügen Sie die folgende compileOnly-Abhängigkeit der Datei build.gradle.kts Ihres Moduls 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-Erlebnisse hinzufügen (KI-Brillen)

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

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

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha12"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha08"
    implementation "androidx.xr.projected:projected:1.0.0-alpha05"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha11"
}

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha12")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha08")
    implementation("androidx.xr.projected:projected:1.0.0-alpha05")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha11")
}
Zurück
Android XR-Projekt erstellen