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