Разработка

Настройки манифеста Android

Обновлено: 28 мая 2026 г.
Настройте манифест своего приложения виртуальной реальности для Android, указав необходимые параметры виртуальной реальности для разработки, как показано в следующем сегменте манифеста.
Примечание. Эти требования к манифесту предназначены для разработки и отличаются от наших требований в отношении отправки приложений. Перед отправкой своего приложения проверьте соблюдение требований к манифесту, изложенных в статье Манифесты приложений для сборок выпусков в разделе Распространение.
<manifest
     xmlns:android="http://schemas.android.com/apk/res/android"
     xmlns:horizonos="http://schemas.horizonos/sdk"
     package="<packagename>"
     android:versionCode="1"
     android:versionName="1.0"
     android:installLocation="auto">
<uses-sdk
     android:minSdkVersion="29"
     android:targetSdkVersion="32" />
<horizonos:uses-horizonos-sdk
        horizonos:minSdkVersion="201"
        horizonos:targetSdkVersion="203" />
<application>
<meta-data
     android:name="com.oculus.supportedDevices"
     android:value="quest2|questpro|quest3|quest3s"/>
<activity android:screenOrientation="landscape"
     android:theme="@android:style/Theme.Black.NoTitleBar.Fullscreen"
     android:configChanges="density|keyboard|keyboardHidden|navigation|orientation|screenLayout|screenSize|uiMode"
     android:launchMode="singleTask"
     android:resizeableActivity="false">
    <intent-filter><action android:name="android.intent.action.MAIN" /><category android:name="android.intent.category.LAUNCHER" /><category android:name="com.oculus.intent.category.VR" /></intent-filter></activity></application></manifest>
  • Подставьте вместо <packagename> название вашего пакета, например com.mycompany.myapplication.
  • Для удобства при переходе между приложениями в качестве темы Android должен быть установлен сплошной черный цвет: Theme.Black.NoTitleBar.Fullscreen
  • Необходимая ориентация экрана — альбомная: android:screenOrientation="landscape".
  • Рекомендуется задать параметр configChanges таким образом: android:configChanges="density|keyboard|keyboardHidden|navigation|orientation|screenLayout|screenSize|uiMode".
  • Не добавляйте в манифест атрибут noHistory.
  • Для подписания версии 2 требуется <uses-feature android:name="android.hardware.vr.headtracking" android:required="true" android:version="1" />. Это необходимо для проверки приложений Meta Quest в магазине.
  • В элементе uses-sdk значения minSdkVersion и targetSdkVersion в файле build.gradle должны быть заданы правильно. Использование более высокого значения minSdkVersion может привести к тому, что ваше приложение перестанет работать на гарнитурах более старых поколений. В Android Studio эти значения можно установить в разделах Properties (Свойства) и Default Config (Конфигурация по умолчанию) в меню File (Файл) > Project Structure (Структура проекта) > Modules (Модули).
  • В элементе uses-horizonos-sdk необходимо соответствующим образом настроить minSdkVersion и targetSdkVersion. Подробнее см. в статье Управление версиями Horizon OS SDK.
В следующей таблице перечислены рекомендуемые значения для параметров minSdkVersion и targetSdkVersion элемента uses-sdk. Чтобы гарантировать получение актуальных сообщений об ошибках компилятора, задайте необязательный параметр compileSdkVersion.
УстройствоminSdkVersiontargetSdkVersioncompileSdkVersion (необязательный параметр)
Meta Quest 1 (только)
29
29
29
Meta Quest 1, 2, Pro и 3
29
32
32
Meta Quest 2, Pro и 3 (только)
32
32
32
Для отправки приложений может потребоваться внесение в манифест дополнительных изменений. См. статью Манифесты приложений для версий выпуска в нашем руководстве по публикации.

Режим совместимости

Будущие VR-устройства могут оказаться несовместимы с возможностями, которые использует ваше приложение. Если в разделе com.oculus.supportedDevices вашего манифеста не указана модель гарнитуры, на которой запущено ваше приложение, то при запуске приложения устройство автоматически переключается в режим совместимости. В этом случае VR-устройство Meta попытается обеспечить максимальную совместимость с вашим приложением, а среда выполнения будет идентифицировать гарнитуру как модель предыдущего поколения.
Подробнее о такой логике работы и рекомендуемых API для определения модели устройства, на котором работает ваше приложение, см. в статье Режим совместимости.
При создании приложений, ориентированных на Meta Quest, Quest 2 или Quest Pro, проверьте возможности устройства, прежде чем их использовать, или воспользуйтесь методом работы в среде выполнения, позволяющим определить, на каком устройстве запущено приложение. Затем включите дополнительные функции, улучшающие опыт использования, например отслеживание движений глаз для пользователей Meta Quest Pro.

Добавление поддерживаемых устройств в манифест

Чтобы указать, что приложение поддерживает все текущие устройства, в манифест Android необходимо добавить следующую запись:
<meta-data android:name="com.oculus.supportedDevices" android:value="quest2|questpro|quest3|quest3s"/>
Подробнее о характеристиках поддерживаемых устройств см. в разделе Режим совместимости.

Проверка доступных возможностей

Хотя проверка типа устройства имеет допустимые сценарии использования, однако старайтесь всегда использовать проверку возможностей, если она доступна.
Например, если вы проверите через OpenXR, поддерживает ли устройство отслеживание движений глаз, это позволит получить более точные результаты, чем проверка того, является ли устройство гарнитурой Meta Quest Pro.
Логотип навигации
Русский
© 2026 Meta