ionic capacitor run

Run an Ionic project on a connected device

ionic capacitor run [options]

ionic capacitor run will do the following:

• Perform ionic build (or run the dev server from ionic serve with the --livereload option)
• Copy web assets into the specified native platform
• Open the IDE for your native project (Xcode for iOS, Android Studio for Android)

When using the --livereload option and need to serve to your LAN, a device, or an emulator, use the --external option also. Otherwise, the web view tries to access localhost.

Once the web assets and configuration are copied into your native project, the app can run on devices and emulators/simulators using the native IDE. Unfortunately, programmatically building and launching the native project is not yet supported.

For Android and iOS, you can setup Remote Debugging on your device with browser development tools using these docs.

Examples

$ ionic capacitor run
$ ionic capacitor run android
$ ionic capacitor run android -l --external
$ ionic capacitor run ios --livereload --external
$ ionic capacitor run ios --livereload-url=http://localhost:8100

Inputs

platform
Description	The platform to run (e.g. android, ios)

Options

--ssl
Description	Use HTTPS for the dev server
--no-build
Description	Do not invoke Ionic build
--no-open
Description	Do not invoke Capacitor open
--external
Description	Host dev server on all network interfaces (i.e. --host=0.0.0.0)
--livereload
Description	Spin up dev server to live-reload www files
Aliases	-l
--livereload-url =<url>
Description	Provide a custom URL to the dev server
--prod
Description	Flag to use the production configuration

Advanced Options

--consolelogs
Description	Print app console logs to the terminal
--consolelogs-port =<port>
Description	Use specific port for console logs server
--host =<host>
Description	Use specific host for the dev server
Default	localhost
--port =<port>
Description	Use specific port for the dev server
Aliases	-p
Default	8100
--public-host =<host>
Description	The host used for the browser or web view
--configuration =<conf>
Description	Specify the configuration to use.
Aliases	-c
--source-map
Description	Output source maps
--watch
Description	Rebuild when files change