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 →

Informationen zu XR-Gerätetypen →

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.

Android SDK-Kompatibilität prüfen

Für das Jetpack XR SDK muss Ihre App das Android-minSdk 24 und das compileSdk 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 (XR‑Headsets und XR‑Datenbrillen) 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:

• XR-Laufzeit
• Jetpack SceneCore
• Jetpack Compose für XR
• Material Design für XR
• ARCore für Jetpack XR

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

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha13"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha14"
    implementation "androidx.xr.compose:compose:1.0.0-alpha13"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha16"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha13"
}

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha13")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha14")
    implementation("androidx.xr.compose:compose:1.0.0-alpha13")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha16")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha13")
}

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:

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

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:

• XR-Laufzeit
• ARCore für Jetpack XR
• Jetpack Compose Glimmer
• Jetpack Projected

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

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha13"
    implementation "androidx.xr.glimmer:glimmer:1.0.0-alpha12"
    implementation "androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha12"
    implementation "androidx.xr.projected:projected:1.0.0-alpha07"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha13"
}

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha13")
    implementation("androidx.xr.glimmer:glimmer:1.0.0-alpha12")
    implementation("androidx.xr.glimmer:glimmer-google-fonts:1.0.0-alpha12")
    implementation("androidx.xr.projected:projected:1.0.0-alpha07")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha13")
}