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 fromionic servewith the--livereloadoption) - 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. |
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. |
--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 |
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 |