How Do I Run an Ionic Capacitor App on Android?

Android, Android Apps

Running an Ionic Capacitor app on Android is a straightforward process that allows you to test and deploy your app on real devices or emulators. In this tutorial, we will guide you through the steps required to run your Ionic Capacitor app on an Android device.


Before we begin, make sure you have the following prerequisites in place:

  • Node.js: Ensure that Node.js is installed on your machine. You can download it from the official website and follow the installation instructions.
  • Ionic CLI: Install the Ionic CLI globally by running the command npm install -g @ionic/cli.
  • Android Studio: Download and install Android Studio from the official website. This will provide necessary tools to run your Ionic Capacitor app on Android.

Create an Ionic Capacitor App

To get started, open a terminal or command prompt and navigate to the directory where you want to create your Ionic Capacitor app.

Create a new Ionic Capacitor project by running the following command:

ionic start myApp blank --capacitor

This will create a new Ionic project named ‘myApp’ using the blank template and integrate Capacitor for native functionality.

Add Android Platform

Navigate into your project folder by running:

cd myApp

Add Android as a platform for your project using the following command:

ionic capacitor add android

This command will generate the necessary files and configurations to run your app on Android devices.

Open Android Project in Android Studio

Next, you need to open the Android project in Android Studio. Use the following command:

npx cap open android

This will open your project in Android Studio, where you can build and run your app on an emulator or physical device.

Running the App

To run your Ionic Capacitor app on an emulator or connected device, follow these steps:

  1. Emulator: If you want to use an emulator, launch it from within Android Studio. Make sure it is running before proceeding to the next step.
  2. Physical Device: If you prefer to use a physical device, connect it to your computer via USB debugging mode.

    Ensure that USB debugging is enabled on your device.

  3. In Android Studio, click the Run button or select Run > Run ‘app’. This will build and deploy your Ionic Capacitor app on the selected device or emulator.

If everything goes well, you should see your app running on the Target device or emulator.


If you encounter any issues during the process, here are a few common troubleshooting steps:

  • Device not found: Ensure that the device is connected properly and USB debugging is enabled. You can check if the device is recognized by running npx cap doctor.
  • Build errors: Check for any error messages in the console or logcat. Make sure you have the necessary dependencies and SDKs installed in Android Studio.

That’s it! You have successfully learned how to run an Ionic Capacitor app on Android. Now you can test your app on various devices and continue developing your amazing Ionic applications!