Jetpack XR SDK'yı kullanmaya başlama

Bu kılavuzda, Jetpack XR SDK'sını kullanarak Android XR uygulaması oluşturmayla ilgili talimatlar verilmektedir. Sürükleyici XR deneyimleri oluşturmak için Android Studio'daki temel bağımlılıkları ve proje kurulumunu kapsar.

Uyumluluk

Jetpack XR SDK'sı için minSdk 24 olmalıdır ve SDK 34 veya sonraki bir sürümde derlenmelidir.

Bağımlılık ekleme

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

Ardından, uygulamanızın build.gradle.kts dosyasına gerekli bağımlılıkları ekleyin:

Groovy

dependencies {
    implementation "androidx.xr.runtime:runtime:1.0.0-alpha06"
    implementation "androidx.xr.scenecore:scenecore:1.0.0-alpha07"
    implementation "androidx.xr.compose:compose:1.0.0-alpha07"
    implementation "androidx.xr.compose.material3:material3:1.0.0-alpha11"
    implementation "androidx.xr.arcore:arcore:1.0.0-alpha06"

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

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

Kotlin

dependencies {
    implementation("androidx.xr.runtime:runtime:1.0.0-alpha06")
    implementation("androidx.xr.scenecore:scenecore:1.0.0-alpha07")
    implementation("androidx.xr.compose:compose:1.0.0-alpha07")
    implementation("androidx.xr.compose.material3:material3:1.0.0-alpha11")
    implementation("androidx.xr.arcore:arcore:1.0.0-alpha06")

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

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

Hello Android XR örneğine bakın.

Kod küçültmeyi etkinleştirme (isteğe bağlı)

Derlemelerinizde ProGuard kullanarak kod küçültme ve karartma işlemlerini etkinleştirmek istiyorsanız XR için Android Uzantıları kitaplığına bağımlılık eklemeniz gerekir. Bu, Jetpack XR alpha05 veya daha yeni sürümlerin kullanıldığı projeler için gereklidir.

Modülünüzün build.gradle.kts dosyasına aşağıdaki compileOnly bağımlılığını ekleyin:

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

Basic Headset Activity Template'i kullanarak Android Studio'da yeni bir uygulama oluşturun.

XR için Jetpack Compose'u 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. Android Studio projeniz zaten açıksa menü çubuğundan Dosya > Yeni'yi seçin.
  2. Şablon seçeneklerinden XR'ı, ardından Temel Başlı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. Örneğiniz için Proje konumu'nu seçin.
  4. Son'u tıklayın.
  5. Projenin build.gradle dosyasının Gradle özellik dosyaları bölümünde açıklandığı gibi doğru şekilde yapılandırıldığını doğrulayın.