Capacitor Android Documentation
Capacitor Android apps are configured and managed through Android Studio (generally).
Follow these guides for more information on each topic:
Developing Android apps requires some Android SDK dependencies to be installed. Make sure to install the Android SDK Tools (26.0.1 or greater required), and a version of the Android SDK Platforms for API 21 or greater.
You can install these easily by opening Android Studio, and going to Tools -> Android -> SDK Manager from the top menu bar:
By default, an Android project is created for every Capacitor project. If you are adding Capacitor to an existing project, you can manually add the Android project using
npx cap add android npx cap sync
sync command updates dependencies, and copies any web assets to your project. You can also run
npx cap copy
To copy web assets only, which is faster if you know you don't need to update native dependencies.
To open the project in Android Studio, run
npx cap open android
Note: Currently to use an Android Emulator you must use a system image of at least Android version 7.0 on API 24. This is due to the System WebView version not being able to be updated on emulators. Physical devices should work as low as Android 5.0 (API 21) as long as their System WebView is updated.
Once Android Studio is open, you should be able to run your app on a device or emulator. Go to Run or Debug in the Run menu:
If you encountered any issue above, please let us know by filing an issue on the repo, and then consult the
If your app ran you are now ready to continue developing and building your app. Use the various APIs available, Capacitor or Cordova plugins, or custom native code to build our the rest of your app.
Follow these Android-specific guides for more information on setting permissions for your app, updating dependencies, building plugins, and more: