Распространение
Инструмент командной строки OVR Platform Utility
Обновлено: 15 янв 2026 г.
Утилита платформы OVR — это инструмент командной строки, который позволяет загружать сборки в каналы выпуска гораздо быстрее, чем через веб-интерфейс панели разработчика, а также дает возможность загружать пакеты большего размера. С ее помощью вы также можете включать в свою систему сборки автоматизированные загрузки.
Утилита платформы OVR выполняет загрузку сборок быстрее, поскольку она анализирует вашу сборку и загружает только те части, которые изменились с момента последней загрузки.
Эта статья содержит следующие разделы:
Скачивание и установка утилиты
- Выберите подходящий файл для скачивания для своей системы:
- Скопируйте утилиту в выбранный каталог.
- Чтобы запустить утилиту в системе Mac или Linux, необходимо изменить для нее права доступа:
- перейдите (
cd) в каталог с файлом; - в командной строке введите:
chmod +x ./ovr-platform-util; - введите
./ovr-platform-utilи команду, чтобы запустить утилиту.
- перейдите (
Получение учетных данных для использования утилиты
Для выполнения некоторых команд вам понадобятся ID приложения, секрет приложения или маркер пользователя, а также ID сборки. Обратите внимание: для проверки доступа к приложению команды принимают секрет приложения или маркер пользователя. Секрет приложения или маркер пользователя можно получить на панели разработчика.
Генерирование маркера пользователя
Чтобы получить эти значения, выполните следующие действия:
- Перейдите на Панель разработчика Meta Horizon.
- Перейдите на страницу настроек аккаунта из раскрывающегося списка "Account" (Аккаунт) на панели навигации слева.
- Выберите свою платформу, если она отличается от той, которую вы сейчас используете, и нажмите Generate token (Сгенерировать маркер).
Получение ID сборки
Чтобы скачать существующую сборку, сначала необходимо получить ее ID. Его можно получить двумя способами:
- ID сборки появится в выходных данных после загрузки сборки приложения с помощью утилиты.
- В качестве альтернативы ID сборки можно найти на панели разработчика, для чего нужно выполнить перечисленные ниже действия.
Получение ID сборки приложения на Панели разработчика:
- Перейдите на Панель разработчика Meta Horizon.
- Выберите приложение.
- В разделе Recently uploaded builds (Недавно загруженные сборки) на главной панели в столбце Build (Сборка) нажмите необходимую версию сборки, чтобы просмотреть сведения.На вкладке Сведения выбранной версии приложения вы найдете значение ID сборки.
Использование утилиты с Unity или Unreal Engine
OVR Platform Utility уже входит в Unity Integration и Unreal Engine Integration.
- Для Unreal: обратитесь к статье Загрузка приложений в Магазин Meta Horizon.
- Для Unity: обратитесь к статье Загрузка приложений в Магазин Meta Horizon.
Краткая справка по командам
Утилита поддерживает загрузки и скачивания Meta Quest. Кроме того, предусмотрены команды для управления утилитой и получения справки. Ниже приведен список команд для утилиты.
Управление утилитой и получение маркеров пользователя
| Задача | Команда |
|---|---|
Получение справки по утилите | |
Получение версии утилиты платформы OVR | |
Обновление утилиты платформы OVR |
Управление сборками Link PC-VR
Следующие команды помогут вам управлять приложениями, предназначенными для гарнитуры Rift.
| Задача | Команда |
|---|---|
Загрузка сборки для Rift | |
Скачивание сборки для Rift | |
Клонирование существующей сборки для Rift | |
Перенос сборки в другой канал выпуска | |
Загрузка файлов дополнительных элементов, таких как скачиваемый контент и покупки в приложении |
Управление сборками Meta Quest
Следующие команды помогут вам управлять приложениями, предназначенными для устройств Meta Quest.
| Задача | Команда |
|---|---|
Загрузка сборки Meta Quest | |
Скачивание сборки Meta Quest | |
Загрузка отладочных символов для существующей сборки | |
Перенос сборки в другой канал выпуска | |
Загрузка файлов дополнительных элементов, таких как скачиваемый контент и покупки в приложении |
Получение справки по утилите
Чтобы получить список команд и другую справочную информацию по утилите, используйте следующую команду.
$ ovr-platform-util.exe help
Проверка версии утилиты
Проверить версию утилиты можно с помощью команды code
version$ ovr-platform-util version
Результат будет примерно следующим:
OVR Platform Command Line Utility - 1.54.0.000001 (Built on Tue Jul 28 2020)
Настройка ля автоматического обновления утилиты
Вы можете настроить автоматическое обновление утилиты с помощью команды
self-update.$ ovr-platform-util self-update
Результат будет примерно следующим:
Checking for the latest version Already running the latest version 1.54.0.000001
Загрузка сборки Link PC-VR
Ниже показан синтаксис и перечислены параметры для загрузки приложения Rift в магазин Rift.
Синтаксис
$ ovr-platform-util upload-rift-build -a <AppID> --app-secret <App-Secret> --token <User-Token> -d <BuildPath> -l <LaunchFile>
-c <ReleaseChannel> -v <Number> -n <Text> --assets-dir <assset-dir> --asset-files-config <config.json> --language-packs-dir [-p <Arguments>] [-L <2DLaunchFile>] [-P <2DArguments>]
[-r <RedistID>[,]...] [-f {true|false}] [--help {true|false}] [--clean {true|false}] [--inherit-assets {true|false}]
Параметры
| Синтаксис | Описание |
|---|---|
-d <buildPath>--build-dir <buildPath> | Обязательный параметр. Полный путь к каталогу, содержащему файлы сборки. |
-a <ID>--app-id <ID> | Обязательный параметр. ID приложения. Можно получить на вкладке API приложения на Панели разработчика Meta Horizon. |
-s <app-secret>--app-secret <app-secret> | Обязательный параметр. Секрет приложения. Можно получить на вкладке API приложения на Панели разработчика Meta Horizon. |
-t <token>--token <token> | Требуется либо секрет приложения, либо маркер пользователя. Такой маркер можно получить с Панели разработчика. |
-c <releaseChannel>--channel <ReleaseChannel> | Обязательный параметр. Канал выпуска для загрузки сборки. Используйте store для каналов Production (AppLab) или Production (Store). В названиях каналов выпуска не учитывается регистр. |
-v <version-number>--version <version-number> | Обязательный параметр. Номер версии, который показывается пользователям. |
-l <launchFile>--launch-file <launchFile> | Обязательный параметр. Относительный путь от каталога сборки к исполняемому файлу, который запускает приложение. |
-n <text>--notes <text> | Необязательный параметр. Текст примечания к выпуску, который показывается пользователям. Этот текст следует заключить в кавычки. Указывайте двойные кавычки как \". Указывайте перенос строк как \n. |
-p <arguments>--launch-params <arguments> | Необязательный параметр. Аргументы, которые передаются инструменту запуска. |
--assets-dir <dirPath> | Необязательно. Задает путь к каталогу со скачиваемым контентом для этой сборки. |
--asset-files-config <filePath> | Необязательный параметр. Путь к файлу конфигурации необходимых объектов или связывания скачиваемого контента с покупками в приложении. |
--language-packs-dir <file-path> | Необязательный параметр. Путь к каталогу, в котором содержатся языковые пакеты. |
-L <2DLaunchFile>--launch-file-2d <2DLaunchFile> | Необязательный параметр. Задает относительный путь от каталога сборки к исполняемому файлу, который запускает приложение в режиме 2D. |
-P <2DArguments>--launch-params-2d <2DArguments> | Необязательный параметр. Аргументы, которые передаются инструменту запуска в режиме 2D. |
-r <redistID>,<redistID2>...--redistributables <redistID>,<redistID2>.... | Необязательный параметр. Один или несколько ID распространяемых компонентов. Эти ID следует заключить в кавычки и разделять запятыми. Пример: "RedistID1,RedistID2". Полный список распространяемых компонентов и их ID см. в разделе Распространяемые компоненты. |
-f {true/false}--firewall-exceptions {true/false} | Необязательный параметр. Указывает, требуется ли исключение брандмауэра Windows. True или False. Значение по умолчанию: false. |
-g <option>--gamepad-emulation <option> | Необязательный параметр. Разрешение эмуляции геймпада с помощью Touch (значения: OFF, TWINSTICK, RIGHT_D_PAD и LEFT_D_PAD). |
Полное описание синтаксиса и параметров можно найти на странице Утилита командной строки платформы OVR.
Синтаксис | Описание |
--help | Необязательный параметр. Вызов справки для команды |
--draft | Необязательный параметр. Загрузка в виде черновика, который позже можно опубликовать на панели инструментов разработчика. |
--clean | Необязательный параметр. Пропуск уровень кэширования и выполнение новой загрузки. Используйте этот параметр, если вам необходимо, чтобы инструмент начал работу заново и повторно вычислил контрольные суммы прерванного сеанса загрузки, а не продолжал с того места, в котором он был прекращен. |
--config | Необязательный параметр. Предоставляет JSON-файл с параметрами конфигурации. |
--inherit-asset-files | Необязательный параметр. Логическое значение, которое указывает, нужно ли наследовать файлы объектов из предыдущей сборки. Значение по умолчанию: false. |
--exclude-addons | Необязательный параметр. Логическое значение, которое указывает, нужно ли исключить дополнительные элементы, связанные с этим приложением. Значение по умолчанию: false. |
--disable-progress-bar | Необязательный параметр. Логическое значение, которое указывает, нужно ли отключать индикатор выполнения. |
Примеры
В этом примере загрузки используется несуществующее приложение Rabbit Hole и предполагаются перечисленные дальше параметры. Обратите внимание: в примере показан синтаксис файла для Windows.
- ID приложения: 10001234.
- Маркер: 1234abcd.
- Каталог сборки: C:\Rabbit Hole.
- Файл запуска: C:\Rabbit Hole\bin\badrabbits.exe.
- Новая версия: 1.1.
- Примечание к выпуску: исправлена ошибка создания кроликов.
*Простой пример загрузки Rift**
Чтобы загрузить версию 1.1 приложения Rabbit Hole в канал выпуска RC, введите следующую команду:
$ ovr-platform-util upload-rift-build --app-id 10001234 --token 1234abcd -d "C:\Rabbit Hole" -l "bin\badrabbits.exe" -n "Fixes the rabbit spawn bug." -v 1.1 -c rc
Пример загрузки с распространяемыми компонентами
Если приложению требуются файлы распространяемых компонентов .NET Framework 3.5 и Visual C++ 2013 x86, введите следующую команду:
$ ovr-platform-util upload-rift-build --app-id 10001234 --app-secret 1234abcd -d "C:\Rabbit Hole" -l "bin\badrabbits.exe" -n "Fixes the rabbit spawn bug." -v 1.1 -c rc -r "606493776156948, 910524935693407"
Пример режима 2D с исключением брандмауэра
Если приложению требуются исключение брандмауэра Windows и операционная система не ниже Windows 10, а также в нем используются исполняемый файл в режиме 2D и строка аргумента badrabbits2d.exe -force2dfix, введите следующую команду:
$ ovr-platform-util upload-rift-build --app-id 10001234 --token 1234abcd -d "C:\Rabbit Hole" -l "bin\badrabbits.exe" -n "Fixes the rabbit spawn bug." -v 1.1 -c rc -L badrabbits2d.exe -P '-force2dfix' -f -w "10"
Пример многострочного примечания к выпуску
Если вы используете многострочное примечание к выпуску, введите следующую команду:
$ ovr-platform-util upload-rift-build --app-id 10001234 --token 1234abcd -d "C:\Rabbit Hole" -l "bin\badrabbits.exe" -n "Carrots now available as in-app purchases.\nBlue rabbits no longer \"glitch\" and get stuck in terrain.\nSpawn sound spatialization adjusted for realism." -v 1.1 -c rc
Скачивание сборки Link PC-VR
Синтаксис для скачивания приложения Rift из магазина Rift имеет следующий вид:
Синтаксис
$ ovr-platform-util download-rift-build -b <BuildID> -d <Directory>
Параметры
| Синтаксис | Описание |
|---|---|
-b <buildID>--build-id <buildID> | Обязательный параметр. ID сборки, которую вы хотите скачать. Это значение можно получить из данных интерфейса командной строки после загрузки сборки приложения с использованием этого инструмента. |
-d <directory>--output-dir <directory> | Обязательный параметр. Задает каталог, в который нужно скачать сборку. |
-t <token>--token <token> | Обязательный параметр. Такой маркер можно получить с Панели разработчика. |
Параметры
Синтаксис | Описание |
--help | Необязательный параметр. Вызов справки для команды |
-c--concurrency | Необязательный параметр. Целое число, которое указывает, сколько сегментов следует скачивать за один раз. c { "entityMap": [object Object], "blockMap": OrderedMap { "tm4n": c { "key": "tm4n", "type": "unstyled", "text": "Значение по умолчанию: 10,", "characterList": List [ b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null }, b { "style": OrderedSet {}, "entity": null } ], "depth": 0, "data": Map {} } }, "selectionBefore": b { "anchorKey": "tm4n", "anchorOffset": 24, "focusKey": "tm4n", "focusOffset": 26, "isBackward": false, "hasFocus": true }, "selectionAfter": b { "anchorKey": "tm4n", "anchorOffset": 26, "focusKey": "tm4n", "focusOffset": 26, "isBackward": false, "hasFocus": true } } |
Пример скачивания Rift
Чтобы скачать сборку приложения с ID 3141592653589793 в каталог C:\Pie Thrower:
- Введите:
$ ovr-platform-util download-rift-build -b 3141592653589793 -d "C:\Pie Thrower"
- Укажите адрес электронной почты и пароль пользователя, авторизованного для скачивания приложения.
- Сборка скачается в выбранный каталог.
Добавление проверки прав в исполняемый файл
Добавьте проверку прав для платформы в указанные исполняемые файлы.
Синтаксис
$ ovr-platform-util add-entitlement-check -b <BuildID> -d <Directory>
Параметры
| Синтаксис | Описание |
|---|---|
-d <buildPath>--build-dir <buildPath> | Обязательный параметр. Полный путь к каталогу, содержащему файлы сборки. |
-d <directory>--output-dir <directory> | Обязательный параметр. Задает каталог, в который нужно скачать сборку. |
Клонирование сборки Link PC-VR
Эта команда позволяет клонировать существующую сборку Rift для создания новой сборки. При необходимости можно изменить любые метаданные сборки. Новая сборка будет размещена в канале выпуска, указанном в параметре destination_channel. Сборку для клонирования можно выбрать из другого канала с помощью параметра source_channel или явно указать в параметре build_id.
Синтаксис
ovr-platform-util clone-rift-build --app-id <AppID> --app-secret <App-Secret> --token <User-Token> --source-channel <Channel> --destination-channel <Channel> [OPTIONS]
Параметры
| Синтаксис | Описание |
|---|---|
-a <ID>--app-id <ID> | Обязательный параметр. ID приложения. Можно получить на вкладке API приложения на Панели разработчика Meta Horizon. |
-s <app-secret>--app-secret <app-secret> | Требуется либо секрет приложения, либо маркер пользователя. Секрет приложения. Можно получить на вкладке API приложения на Панели разработчика Meta Horizon. |
-t <token>--token <token> | Требуется либо секрет приложения, либо маркер пользователя. Такой маркер можно получить с Панели разработчика. |
--destination-channel <channel> | Обязательный параметр. Задает канал выпуска, который будет обновлен. |
--source-channel <channel> | Необязательный параметр. Если этот параметр указан, сборка из этого канала будет скопирована в целевой канал. |
-b <buildID>--build-id <buildID> | Необязательный параметр. ID сборки, которую вы хотите скачать. Это значение можно получить из данных интерфейса командной строки после загрузки сборки приложения с использованием этого инструмента. |
-v <version-number>--version <version-number> | Обязательный параметр. Номер версии, который показывается пользователям. |
-l <launchFile>--launch-file <launchFile> | Обязательный параметр. Относительный путь от каталога сборки к исполняемому файлу, который запускает приложение. |
-n <text>--notes <text> | Необязательный параметр. Текст примечания к выпуску, который показывается пользователям. Этот текст следует заключить в кавычки. Указывайте двойные кавычки как \". Указывайте перенос строк как \n. |
-p <arguments>--launch-params <arguments> | Необязательный параметр. Аргументы, которые передаются инструменту запуска. |
-L <2DLaunchFile>--launch-file-2d <2DLaunchFile> | Необязательный параметр. Задает относительный путь от каталога сборки к исполняемому файлу, который запускает приложение в режиме 2D. |
-P <2DArguments>--launch-params-2d <2DArguments> | Необязательный параметр. Аргументы, которые передаются инструменту запуска в режиме 2D. |
-r <redistID>,<redistID2>...--redistributables <redistID>,<redistID2>.... | Необязательный параметр. Один или несколько ID распространяемых компонентов. Эти ID следует заключить в кавычки и разделять запятыми. Пример: "RedistID1,RedistID2". Полный список распространяемых компонентов и их ID см. в разделе Распространяемые компоненты. |
-f {true/false}--firewall-exceptions {true/false} | Необязательный параметр. Указывает, требуется ли исключение брандмауэра Windows. True или False. Значение по умолчанию: false. |
-w {"7SP1"/8.1/10}--windows-min-version {"7SP1"/8.1/10} | Необязательный параметр. Необходимая минимальная версия Windows. Можно указать версии 7SP1, 8.1 и 10. По умолчанию указывается версия 7SP1. |
-g <option>--gamepad-emulation <option> | Необязательный параметр. Разрешение эмуляции геймпада с помощью Touch (значения: OFF, TWINSTICK, RIGHT_D_PAD и LEFT_D_PAD). |
Пример клонирования сборки Link PC-VR build
ovr-platform-util clone-rift-build --app-id 10001234 --app-secret 1234abdc --source-channel alpha --destination-channel beta --launch-params "server=beta"
Справка по ID распространяемых компонентов
Ниже приводится список пакетов распространяемых компонентов и связанных с ними ID.
| Название | ID распространяемого компонента |
|---|---|
.NET Framework 3.5 | 606493776156948 |
.NET Framework 4.0 | 133610290311340 |
.NET Framework 4.5.1 | 1617306711884127 |
.NET Framework 4.7.1 | 1667821599930345 |
DirectX (июнь 2010 г.) | 822786567843179 |
OpenAL 1.1 | 1147517301974655 |
Visual C++ | 20051604897159783747 |
Visual C++ | 2008118440348500045 |
Visual C++ | 2010532320330249657 |
Visual C++ | 2010 x861008652072555515 |
Visual C++ | 20121683508698536289 |
Visual C++ | 2012 x861002692246447245 |
Visual C++ | 20131675031999409058 |
Visual C++ | 2013 x86910524935693407 |
Visual C++ | 2015 Update 31183534128364060 |
Visual C++ | 2015 x86 Update 31113033105419344 |
Visual C++ | 20171315322525257173 |
Visual C++ | 2017 x861064693870299984 |
Visual C++ | 20192657209094360789 |
Visual C++ | 2019 x862556834837738356 |
Vulkan Runtime | 1.0.65.11824471960899274 |
Vulkan Runtime | 1.1.73.01941020095932382 |
Загрузка сборки Meta Quest
Ниже показан синтаксис и перечислены параметры для загрузки приложения Meta Quest в магазин Meta Horizon. Вы должны указывать предполагаемую возрастную группу пользователей вашего приложения. Узнать больше можно из статьи Самосертификация возрастной группы и требования для молодежной аудитории.
Синтаксис
ovr-platform-util upload-quest-build --age-group {TEENS_AND_ADULTS | MIXED_AGES | CHILDREN} --app_id <ID> --app_secret <app-secret> --token <user-token> --apk <path/to/Your.apk> --obb <path/to/Your.obb> --assets-dir <path/to/DLCs/dir> --channel <ReleaseChannel> --notes <ReleaseNotes> --asset-files-config <config.json> --language-packs-dir <path> --debug_symbols_dir <DirPath> --debug-symbols-pattern <FilenamePattern> [--help {true|false}] [--inherit-assets {true|false}]
[--exclude-addons {true|false}]
Параметры
| Синтаксис | Описание |
|---|---|
--age-group | Обязательный параметр. (Если этот параметр не указан, загрузка будет иметь статус "Черновик", а не статус ошибки). Возрастная группа для сборки. Возможные значения: TEENS_AND_ADULTS, MIXED_AGES и CHILDREN. Узнать больше можно из статьи Самосертификация возрастной группы и требования для молодежной аудитории. |
-a <ID>--app-id <ID> | Обязательный параметр. ID приложения. Можно получить на вкладке API приложения на Панели разработчика Meta Horizon. |
-s <app-secret>--app-secret <app-secret> | Требуется либо секрет приложения, либо маркер пользователя. Секрет приложения. Можно получить на вкладке API приложения на Панели разработчика Meta Horizon. |
-t <token>--token <token> | Требуется либо секрет приложения, либо маркер пользователя. Такой маркер можно получить с Панели разработчика. |
--apk <filePath> | Обязательный параметр. Путь к файлу APK для загрузки. |
--assets-dir <dirPath> | Необязательно. Задает путь к каталогу со скачиваемым контентом для этой сборки. |
--asset-files-config <filePath> | Необязательный параметр. Задает путь к файлу конфигурации необходимых объектов или связывания объектов скачиваемого контента с покупками в приложении. |
--obb <filePath> | Необязательный параметр. Путь к файлу расширения (OBB) для загрузки. |
-c <releaseChannel>--channel <ReleaseChannel> | Обязательный параметр. Канал выпуска для загрузки сборки. Используйте store для каналов Production (AppLab) или Production (Store). В названиях каналов выпуска не учитывается регистр. |
-n <text>--notes <text> | Необязательный параметр. Текст примечания к выпуску, который показывается пользователям. Этот текст следует заключить в кавычки. Указывайте двойные кавычки как \". Указывайте перенос строк как \n. |
--language-packs-dir <file-path> | Необязательный параметр. Путь к каталогу, в котором содержатся языковые пакеты. |
--debug-symbols-dir <dirPath> | Необязательный параметр. Путь к каталогу, в котором содержатся файлы отладочных символов. |
--debug-symbols-pattern <filenamePattern> | Необязательный параметр. Последовательность шаблонов, которая может соответствовать именам файлов всех файлов отладочных символов. Для обозначения подстановочного знака можно использовать звездочку, например: *.sym.so. |
Параметры
Синтаксис | Описание |
--help | Необязательный параметр. Вызов справки для команды |
--draft | Необязательный параметр. Загрузка в виде черновика, который позже можно опубликовать на панели инструментов разработчика. |
--config | Необязательный параметр. Предоставляет JSON-файл с параметрами конфигурации. |
--inherit-asset-files | Необязательный параметр. Логическое значение, которое указывает, нужно ли наследовать файлы объектов из предыдущей сборки. Значение по умолчанию: false. |
--exclude-addons | Необязательный параметр. Логическое значение, которое указывает, нужно ли исключить дополнительные элементы, связанные с этим приложением. Значение по умолчанию: false. |
--disable-progress-bar | Необязательный параметр. Логическое значение, которое указывает, нужно ли отключать индикатор выполнения. |
Примеры
В этом примере загрузки используется несуществующее приложение Rabbit Hole. Обратите внимание: в этих примерах используется синтаксис для операционных систем Windows.
- Возрастная группа: разный возраст (младше 13 лет и старше 13 лет)
- ID приложения: 10001234.
- Маркер пользователя приложения: 1234abcd.
- Путь к файлу APK: C:\Rabbithole.apk.
Пример команды для загрузки:
$ ovr-platform-util upload-quest-build --age-group MIXED_AGES --app-id 10001234 --token 1234abcd --apk C:\RabbitHole.apk --channel alpha --notes "Fixes the rabbit spawn bug."
Скачивание сборки Meta Quest
Ниже показан синтаксис и перечислены параметры для скачивания приложения Meta Quest из магазина Meta Horizon.
Синтаксис
ovr-platform-util download-quest-build -b <BuildID> -d <Directory>
Параметры
| Синтаксис | Описание |
|---|---|
-b <buildID>--build-id <buildID> | Обязательный параметр. ID сборки, которую вы хотите скачать. Это значение можно получить из данных интерфейса командной строки после загрузки сборки приложения с использованием этого инструмента. |
-d <directory>--output-dir <directory> | Обязательный параметр. Задает каталог, в который нужно скачать сборку. |
-t <token>--token <token> | Обязательный параметр. Такой маркер можно получить с Панели разработчика. |
Пример скачивания
В следующем примере показано, как скачать сборку приложения с ID 3141592653589793 в каталог C:\Pie Thrower.
Для Meta Quest введите следующую команду:
$ ovr-platform-util download-quest-build -b 3141592653589793 -d "C:\Pie Thrower"
Загрузка отладочных символов для существующей сборки
Ниже показан синтаксис и перечислены параметры для загрузки файлов отладочных символов в сборку приложения Meta Quest, ранее загруженную в канал выпуска.
Синтаксис
ovr-platform-util upload-debug-symbols --parent <BuildID> --app-id <ID> --app-secret <App-Secret> --token <User-Token> --debug-symbols-dir <DirPath> --debug-symbols-pattern <FilenamePattern>
Параметры
| Синтаксис | Описание |
|---|---|
-p <buildID>--parent <buildID> | Обязательный параметр. ID сборки двоичного файла, к которому следует прикрепить файлы отладочных символов. Это значение можно получить из данных интерфейса командной строки после загрузки сборки приложения. Его также можно получить на странице сведений в Центре разработчиков. Для этого нужно нажать номер версии загруженного двоичного файла. |
-a <ID>--app-id <ID> | Обязательный параметр. ID приложения. Можно получить на вкладке API приложения на Панели разработчика Meta Horizon. |
-s <app-secret>--app-secret <app-secret> | Требуется либо секрет приложения, либо маркер пользователя. Секрет приложения. Можно получить на вкладке API приложения на Панели разработчика Meta Horizon. |
-t <token>--token <token> | Требуется либо секрет приложения, либо маркер пользователя. Такой маркер можно получить с Панели разработчика. |
--debug-symbols-dir <dirPath> | Обязательный параметр. Путь к каталогу, в котором содержатся файлы отладочных символов. |
--debug-symbols-pattern <filenamePattern> | Обязательный параметр. Последовательность шаблонов, которая может соответствовать именам файлов всех файлов отладочных символов. Для обозначения подстановочного знака можно использовать звездочку, например: *.sym.so. |
Параметры
Синтаксис | Описание |
--help | Необязательный параметр. Вызов справки для команды |
--disable-progress-bar | Необязательный параметр. Логическое значение, которое указывает, нужно ли отключать индикатор выполнения. |
Пример
В следующем примере показано, как прикрепить файлы отладочных символов в /myProject/obj/local/armeabi-v7a/ с расширением *.so к сборке с ID 1234567890123456.
$ ovr-platform-util upload-debug-symbols --parent 1234567890123456 -a 1234567890123456 -t <user-token> --debug-symbols-dir /myProject/obj/local/armeabi-v7a/ --debug-symbols-pattern *.so
</oc-docs-device>
Задание канала выпуска
Синтаксис
ovr-platform-util set-release-channel-build --age-group {TEENS_AND_ADULTS | MIXED_AGES | CHILDREN} --app-id <AppID> --app-secret <App-Secret> --token <User-Token> --source-channel <Channel> --destination-channel <Channel>Параметры
| Синтаксис | Описание |
|---|---|
--age-group | Обязательный параметр. Возрастная группа для сборки. Возможные значения: TEENS_AND_ADULTS, MIXED_AGES и CHILDREN. Узнать больше можно из статьи Самосертификация возрастной группы и требования для молодежной аудитории. |
-d <buildPath>--build-dir <buildPath> | Обязательный параметр. Полный путь к каталогу, содержащему файлы сборки. |
-s <app-secret>--app-secret <app-secret> | Требуется либо секрет приложения, либо маркер пользователя. Секрет приложения. Можно получить на вкладке API приложения на Панели разработчика Meta Horizon. |
-t <token>--token <token> | Требуется либо секрет приложения, либо маркер пользователя. Такой маркер можно получить с Панели разработчика. |
--destination-channel <channel> | Обязательный параметр. Задает канал выпуска, который будет обновлен. |
-b <buildID>--build-id <buildID> | Необязательный параметр. ID сборки, которую вы хотите скачать. Это значение можно получить из данных интерфейса командной строки после загрузки сборки приложения с использованием этого инструмента. |
--source-channel <channel> | Необязательный параметр. Если этот параметр указан, сборка из этого канала будет скопирована в целевой канал. |
Пример канала выпуска
В следующем примере показано, как задать канал выпуска для сборки от Beta до RC.
$ ovr-platform-util set-release-channel-build --age-group TEENS_AND_ADULTS --app-id 10001234 --app-secret 1234abcd --source-channel beta --destination-channel rc
Управление дополнительными элементами
Утилита позволяет управлять дополнительными элементами, такими как скачиваемый контент (DLC) и покупки в приложении (IAP), с помощью команды
upload-add-on. Подробнее см. в статье Дополнительные элементы.Синтаксис
$ ovr-platform-util.exe upload-add-on --app-id <AppID> --app-secret <App-Secret> --token <User-Token> --file <file> --sku <sku> --min-version-code <min-version>
Параметры
| Синтаксис | Описание |
|---|---|
-a <ID>--app-id <ID> | Обязательный параметр. ID приложения. Можно получить на вкладке API приложения на Панели разработчика Meta Horizon. |
-s <app-secret>--app-secret <app-secret> | Требуется либо секрет приложения, либо маркер пользователя. Секрет приложения. Можно получить на вкладке API приложения на Панели разработчика Meta Horizon. |
-t <token>--token <token> | Требуется либо секрет приложения, либо маркер пользователя. Такой маркер можно получить с Панели разработчика. |
-f <file-path>--file <file-path> | Обязательный параметр. Путь к файлу объекта для загрузки. |
-p <SKU>--sku <SKU> | Обязательный параметр. SKU, связанный с дополнительным элементом. |
-v <version-code>--min-version-code <version-code> | Обязательный параметр. Минимальный номер сборки приложения, с которым необходимо связать этот дополнительный элемент. |
--metadata | Необязательный параметр. Произвольные метаданные, которые разработчик может прикрепить к объекту. |
Параметры
Синтаксис | Описание |
--help | Необязательный параметр. Вызов справки для команды |
--disable-progress-bar | Необязательный параметр. Логическое значение, которое указывает, нужно ли отключать индикатор выполнения. |
Пример дополнительного элемента
В следующих примерах показано, как загрузить дополнительный элемент carrot.
- ID приложения: 10001234.
- Секрет приложения: 1234abcd.
- Файл: C:\rabbit-hole-d.
- SKU: carrot.
$ ovr-platform-util upload-add-on --app-id 10001234 --app-secret 1234abcd --file C:\rabbit-hole\dlc\ --sku carrot
Виртуальная реальность/Meta Horizon
Поддержка и правовая информация
Виртуальная реальность/Meta Horizon
Поддержка и правовая информация
Виртуальная реальность/Meta Horizon
Поддержка и правовая информация
Русский
© 2026 Meta