CLI / oroc run

oroc run

Run application.

Provide a project directory, HTML file, or JavaScript module. When no oro.toml is found, oroc infers a minimal configuration automatically.

Usage#

oroc run [options] [<project-or-source>]

Options#

Option Description
-H, --headless run application in headless mode (without frame or window)
--platform=<platform> platform target to run application on (defaults to host):<br>- android<br>- android-emulator<br>- ios<br>- ios-simulator
--config=<path> use an explicit oro.toml/oro.ini file
--device=<serial> Android device to install and run on
--port=<port> load "index.html" from a specific port (if host is not specified, defaults to localhost)
--host=<host> load "index.html" from a specific host (if port is not specified, defaults to 80)
-P, --prod build for production (disables debugging info, inspector, etc.)
-t, --test=<path> enable test mode and import a test file relative to resource files
-D, --debug enable debug mode
-q, --quiet hint for less log output
-E, --env=<name[=value]> add environment variables
-V, --verbose enable verbose output
--allow-exec allow native extension commands (git/build scripts)
--tls-keylog=<path> write NSS TLS key log lines to <path> (OpenSSL provider)
--log-file=<path> mirror logs to a JSON file
--remote-debugging-port=<port> set the remote debugging port
--sanitizers enable desktop ASan/UBSan sanitizers
-h, --help show help

Environment#

Variable Description
ORO_DEBUG enable debug mode (like -D)
ORO_VERBOSE enable verbose logs (like -V)

Notes#

Android targets use --device, then ANDROID_SERIAL, then the first ready device listed by adb devices. The android-emulator target selects the first ready emulator.

Common errors#

For CI/Linux headless, install xvfb-run or set a custom headless runner in your config.

Use --test=path to run tests bundled with your app.

Examples#

oroc run .

build and launch the current project on the host platform

oroc run --platform=android-emulator .

build and launch the current project on the Android emulator target

oroc run --headless --test=tests/smoke.js .

execute a bundled test entrypoint in headless mode

Source repository · Edit this page · View Markdown

Quick links

Type to search across the site. Use the up and down arrow keys to choose a result, Enter to open it, and Escape to close.