Running

scd project run builds the project, installs it on the target device or simulator, and launches it. Log output is streamed to the terminal until the app exits or you press Ctrl-C.

Synopsis

scd project run [--platform <platform>] [--device <name>] [--configuration debug|release]

Android

scd project run

scd builds the APK, finds a connected device or running emulator, installs it via adb install, launches the main activity, and streams logcat filtered to the app’s process until the process exits.

To target a specific emulator by name:

scd project run --device "Pixel_8_API_35"

If no --device is specified, scd uses the single connected device. Pass an AVD name to start a specific emulator. See Selecting an Android Device for details.

iOS Simulator

scd project run --platform iphonesimulator

Builds the app, boots the target simulator if it is not already running, installs via simctl install, and launches with simctl launch --console-pty so stdout is streamed to the terminal.

To target a specific simulator:

scd project run --platform iphonesimulator --device "iPhone 16"

If --device is omitted, scd picks the first booted simulator, or boots the first available one.

macOS

scd project run --platform macos

Builds the app and runs the binary inside the .app bundle directly (Apple/build/Build/Products/Debug/<Name>.app/Contents/MacOS/<Name>). The process runs in the foreground and stdout is streamed to the terminal.

Release builds

scd project run --platform macos --configuration release

Builds and runs the release configuration. Works for all platforms.

Examples

scd project run                                              # Android, debug
scd project run --configuration release                     # Android, release
scd project run --platform iphonesimulator                  # iOS Simulator, first available
scd project run --platform iphonesimulator --device "iPhone 16"
scd project run --platform macos
scd project run --platform macos --configuration release