cd) 更改为上述文件的位置chmod +x ./ovr-platform-util./ovr-platform-util 和一条命令运行此实用程序| 任务 | 命令 |
|---|---|
获取有关此实用程序的帮助 | |
获取 OVR 平台实用程序的版本 | |
更新 OVR 平台实用程序 |
| 任务 | 命令 |
|---|---|
上传 Rift 编译版本 | |
下载 Rift 编译版本 | |
克隆现有 Rift 编译版本 | |
将编译版本移到其他版本通道 | |
上传附加组件文件(如 DLC 或应用内购买) |
| 任务 | 命令 |
|---|---|
上传 Meta Quest 编译版本 | |
下载 Meta Quest 编译版本 | |
上传现有编译版本的调试符号 | |
将编译版本移到其他版本通道 | |
上传附加组件文件(如 DLC 或应用内购买) |
$ ovr-platform-util.exe help
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
$ 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> | 必要。指定应用编号。从 Meta Horizon 开发者面板中此应用的“API”选项卡获取。 |
-s <app-secret>--app-secret <app-secret> | 必要。指定应用密钥。从 Meta Horizon 开发者面板中此应用的“API”选项卡获取。 |
-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> | 可选。指定此编译版本中包含 DLC 的目录的路径。 |
--asset-files-config <filePath> | 可选。指定用于配置必要素材,或关联 DLC 素材与应用内购买的文件路径。 |
--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>.... | 可选。指定一个或多个可再发行程序包编号。将各编号用引号括起来。用逗号分隔多个可再发行程序包编号。示例 -“RedistID1,RedistID2”。 请参阅“可再发行程序包”部分,获取完整的可再发行程序包及其编号清单 |
-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”)。 |
语法 | 描述 |
--help | 可选。显示与特定命令相关的帮助 |
--draft | 可选。作为草稿上传,可稍后在开发者面板上发布。 |
--clean | 可选。跳过缓存层并执行新的上传。如果您想强制此工具重新开始并重新计算一个已中断上传会话的校验和,而不是从中断处继续计算,请使用此参数。 |
--config | 可选。提供含配置参数的 JSON 文件 |
--inherit-asset-files | 可选。一个布尔值,指示是否沿用上一编译版本中的素材文件。默认为 false。 |
--exclude-addons | 可选。一个布尔值,指示是否排除与此应用关联的附加组件。默认为 false。 |
--disable-progress-bar | 可选。一个布尔值,指示是否禁用进度条。 |
$ 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
$ 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"
$ 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
$ ovr-platform-util download-rift-build -b <BuildID> -d <Directory>
| 语法 | 描述 |
|---|---|
-b <buildID>--build-id <buildID> | 必要。指定要下载的编译版本编号。使用命令行工具成功上传某个应用编译版本后,可从 CLI 输出结果中获取此编号。 |
-d <directory>--output-dir <directory> | 必要。指定要将特定编译版本下载到的目录。 |
-t <token>--token <token> | 必要。从开发者面板获取的用户口令。 |
语法 | 描述 |
--help | 可选。显示与特定命令相关的帮助 |
-c--concurrency | 可选。一个整数,指示一次要下载的段数。默认值为 10。 |
$ 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> | 必要。指定要将特定编译版本下载到的目录。 |
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> | 必要。指定应用编号。从 Meta Horizon 开发者面板中此应用的“API”选项卡获取。 |
-s <app-secret>--app-secret <app-secret> | 需要应用密钥或用户口令。指定应用密钥。从 Meta Horizon 开发者面板中此应用的“API”选项卡获取。 |
-t <token>--token <token> | 需要应用密钥或用户口令。从开发者面板获取的用户口令。 |
--destination-channel <channel> | 必要。指定要更新的版本通道。 |
--source-channel <channel> | 可选。如果指定,来自此通道的编译版本将被复制到目标通道。 |
-b <buildID>--build-id <buildID> | 可选。指定要下载的编译版本编号。使用命令行工具成功上传某个应用编译版本后,可从 CLI 输出结果中获取此编号。 |
-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>.... | 可选。指定一个或多个可再发行程序包编号。将各编号用引号括起来。用逗号分隔多个可再发行程序包编号。示例 -“RedistID1,RedistID2”。 请参阅“可再发行程序包”部分,获取完整的可再发行程序包及其编号清单 |
-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”)。 |
ovr-platform-util clone-rift-build --app-id 10001234 --app-secret 1234abdc --source-channel alpha --destination-channel beta --launch-params "server=beta"
| 名称 | 可再发行程序包编号 |
|---|---|
.NET Framework 3.5 | 606493776156948 |
.NET Framework 4.0 | 133610290311340 |
.NET Framework 4.5.1 | 1617306711884127 |
.NET Framework 4.7.1 | 1667821599930345 |
DirectX(2010 年 6 月) | 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 |
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> | 必要。指定应用编号。从 Meta Horizon 开发者面板中此应用的“API”选项卡获取。 |
-s <app-secret>--app-secret <app-secret> | 需要应用密钥或用户口令。指定应用密钥。从 Meta Horizon 开发者面板中此应用的“API”选项卡获取。 |
-t <token>--token <token> | 需要应用密钥或用户口令。从开发者面板获取的用户口令。 |
--apk <filePath> | 必要。指定要上传的 APK 文件的路径。 |
--assets-dir <dirPath> | 可选。指定此编译版本中包含 DLC 的目录的路径。 |
--asset-files-config <filePath> | 可选。指定用于配置必要素材,或关联 DLC 素材与应用内购买的文件路径。 |
--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 | 可选。一个布尔值,指示是否禁用进度条。 |
$ 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."
ovr-platform-util download-quest-build -b <BuildID> -d <Directory>
| 语法 | 描述 |
|---|---|
-b <buildID>--build-id <buildID> | 必要。指定要下载的编译版本编号。使用命令行工具成功上传某个应用编译版本后,可从 CLI 输出结果中获取此编号。 |
-d <directory>--output-dir <directory> | 必要。指定要将特定编译版本下载到的目录。 |
-t <token>--token <token> | 必要。从开发者面板获取的用户口令。 |
$ ovr-platform-util download-quest-build -b 3141592653589793 -d "C:\Pie Thrower"
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> | 必要。指定要附加调试符号文件的二进制编译版本编号。成功上传一个应用编译版本后,您可以从 CLI 输出结果中获取此编译版本编号。或者,您可以在开发者中心的 “详情” 页面,点击已上传二进制文件的版本号,获取该编号。 |
-a <ID>--app-id <ID> | 必要。指定应用编号。从 Meta Horizon 开发者面板中此应用的“API”选项卡获取。 |
-s <app-secret>--app-secret <app-secret> | 需要应用密钥或用户口令。指定应用密钥。从 Meta Horizon 开发者面板中此应用的“API”选项卡获取。 |
-t <token>--token <token> | 需要应用密钥或用户口令。从开发者面板获取的用户口令。 |
--debug-symbols-dir <dirPath> | 必要。包含调试符号文件的目录的路径。 |
--debug-symbols-pattern <filenamePattern> | 必要。可匹配所有调试符号文件文件名的模式序列。星号可以用来表示通配符,如 *.sym.so。 |
语法 | 描述 |
--help | 可选。显示与特定命令相关的帮助 |
--disable-progress-bar | 可选。一个布尔值,指示是否禁用进度条。 |
$ 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
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> | 需要应用密钥或用户口令。指定应用密钥。从 Meta Horizon 开发者面板中此应用的“API”选项卡获取。 |
-t <token>--token <token> | 需要应用密钥或用户口令。从开发者面板获取的用户口令。 |
--destination-channel <channel> | 必要。指定要更新的版本通道。 |
-b <buildID>--build-id <buildID> | 可选。指定要下载的编译版本编号。使用命令行工具成功上传某个应用编译版本后,可从 CLI 输出结果中获取此编号。 |
--source-channel <channel> | 可选。如果指定,来自此通道的编译版本将被复制到目标通道。 |
$ ovr-platform-util set-release-channel-build --age-group TEENS_AND_ADULTS --app-id 10001234 --app-secret 1234abcd --source-channel beta --destination-channel rc
upload-add-on 命令管理附加组件,如可下载内容 (DLC) 和应用内购买 (IAP)。详情请参阅附加组件。$ 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> | 必要。指定应用编号。从 Meta Horizon 开发者面板中此应用的“API”选项卡获取。 |
-s <app-secret>--app-secret <app-secret> | 需要应用密钥或用户口令。指定应用密钥。从 Meta Horizon 开发者面板中此应用的“API”选项卡获取。 |
-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 | 可选。一个布尔值,指示是否禁用进度条。 |
$ ovr-platform-util upload-add-on --app-id 10001234 --app-secret 1234abcd --file C:\rabbit-hole\dlc\ --sku carrot