Начните работу с Jetpack XR SDK

Это руководство содержит инструкции по созданию приложения Android XR с использованием Jetpack XR SDK. Оно охватывает основные зависимости и настройку проекта в Android Studio для создания захватывающих XR-приложений.

Совместимость

Для Jetpack XR SDK требуется minSdk 24 и его необходимо скомпилировать в SDK 34 или выше.

Добавить зависимости

Чтобы понять необходимые зависимости и проблемы совместимости для каждой из библиотек в Jetpack XR SDK, ознакомьтесь со следующими справочными руководствами:

Затем добавьте необходимые зависимости в файл build.gradle.kts вашего приложения:

Круто

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

Котлин

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 .

Включить минимизацию кода (необязательно)

Если вы хотите включить минимизацию и обфускацию кода с помощью ProGuard для своих сборок, необходимо добавить зависимость от библиотеки Android Extensions for XR. Это требуется для проектов, использующих Jetpack XR alpha05 и более поздние версии.

Добавьте следующую зависимость compileOnly в файл build.gradle.kts вашего модуля:

Круто

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

Создайте новое приложение в Android Studio, используя шаблон Basic Headset Activity.

Чтобы создать новый проект, включающий Jetpack Compose для XR, выполните следующие действия:

  1. Если вы открыли окно «Добро пожаловать в Android Studio» , нажмите « Начать новый проект Android Studio» . Если у вас уже открыт проект Android Studio, выберите «Файл» > «Создать» в строке меню.
  2. Выберите XR в параметрах шаблона , а затем — «Базовая активность гарнитуры» .
  3. В окне «Настройка проекта» выполните следующие действия:
    1. Задайте имя приложения .
    2. Выберите местоположение проекта для вашего образца.
  4. Нажмите кнопку Готово .
  5. Проверьте правильность настройки файла build.gradle проекта, как описано в разделе Файлы свойств Gradle .