Gerekli bağımlılıkları ekleme

Bu kılavuzda, Jetpack XR SDK'sını kullanarak Android XR uygulaması oluşturmayla ilgili talimatlar verilmektedir. Bu makalede, Android Studio'da etkileyici XR deneyimleri oluşturmak için gerekli bağımlılıklar ve proje kurulumu ele alınmaktadır.

Uyumluluk

Jetpack XR SDK'sı için 24 minSdk gerekir ve SDK 34 veya daha yeni bir sürüme derlenmelidir.

Bağımlılıklar ekleme

Jetpack XR SDK'sındaki kitaplıkların her biri için gerekli bağımlılıkları ve uyumluluk sorunlarını anlamak üzere aşağıdaki referans kılavuzlarına bakın.

Örnek

Merhaba Android XR örneğindeki aşağıdaki snippet'te, tüm Jetpack XR SDK bağımlılıklarını içeren örnek bir build.gradle dosyası gösterilmektedir:

dependencies {
    val composeBom = platform(libs.androidx.compose.bom)
    implementation(composeBom)
    implementation(libs.impress)
    implementation(libs.androidx.arcore)
    implementation(libs.androidx.scenecore)
    implementation(libs.androidx.compose)
    implementation(libs.kotlinx.coroutines.guava)

    implementation(libs.material)
    implementation(libs.androidx.compose.material3)
    implementation(libs.androidx.adaptive.android)
    implementation(libs.androidx.concurrent.futures)
    implementation(libs.androidx.compose.runtime)
    implementation(libs.androidx.activity.compose)

    debugImplementation(libs.androidx.compose.ui.tooling)

    screenshotTestImplementation(libs.androidx.compose.ui.tooling)
}

İlgili libs.toml dosyası örneğini aşağıda bulabilirsiniz:

[versions]
androidx-runtime = "1.8.0-alpha06"
agp = "8.6.1"
arcore = "1.0.0-alpha01"
compose = "1.0.0-alpha01"
impress = "0.0.1"
kotlinxCoroutinesGuava = "1.9.0"
scenecore = "1.0.0-alpha01"
kotlin = "2.0.21"
concurrentFuturesKtx = "1.2.0"
activityCompose = "1.10.0-beta01"
composeBom = "2024.11.00"
material = "1.12.0"
screenshot = "0.0.1-alpha08"
adaptiveAndroid = "1.0.0"

[libraries]
androidx-arcore = { module = "androidx.xr.arcore:arcore", version.ref = "arcore" }
androidx-compose = { module = "androidx.xr.compose:compose", version.ref = "compose" }
androidx-scenecore = { module = "androidx.xr.scenecore:scenecore", version.ref = "scenecore" }
impress = { module = "com.google.ar:impress", version.ref = "impress" }
kotlinx-coroutines-guava = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-guava", version.ref = "kotlinxCoroutinesGuava" }
androidx-compose-material3 = { module = "androidx.compose.material3:material3" }
material = { module = "com.google.android.material:material", version.ref = "material" }
androidx-compose-ui-tooling = { module = "androidx.compose.ui:ui-tooling" }
androidx-concurrent-futures = { module = "androidx.concurrent:concurrent-futures-ktx", version.ref = "concurrentFuturesKtx" }
androidx-activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activityCompose" }
androidx-compose-runtime = { module = "androidx.compose.runtime:runtime", version.ref = "androidx-runtime" }
androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" }

Merhaba Android XR örneğine bakın.

Temel Mikrofonlu Kulaklık Etkinliği Şablonu'nu kullanarak Android Studio'da yeni bir uygulama oluşturma

XR için Jetpack Compose içeren yeni bir proje oluşturmak üzere aşağıdaki adımları uygulayın:

  1. Android Studio'ya hoş geldiniz penceresindeyseniz Yeni bir Android Studio projesi başlat'ı tıklayın. Açık bir Android Studio projeniz varsa menü çubuğundan Dosya > Yeni'yi seçin.
  2. Şablon seçeneklerinden XR'ı ve ardından Temel Kulaklık Etkinliği'ni seçin.
  3. Projenizi yapılandırın penceresinde aşağıdakileri yapın:
    1. Uygulama adını ayarlayın.
    2. Sana Özel içeriğiniz için Proje konumu'nu seçin.
  4. Son'u tıklayın.
  5. Projenin build.gradle dosyasının, Gradle özellik dosyalarında açıklandığı şekilde doğru yapılandırıldığından emin olun.