Android Build & Development Workflow

Install Android Studio and the Android SDK, and configure the JAVA_HOME and ANDROID_HOME environment variables.

Build and launch the app on an Android emulator using both the Capacitor CLI (`bunx cap run android`) and Android Studio.

Deploy and run the app on a physical Android device after enabling developer mode and USB debugging.

Configure essential Android properties in `build.gradle`, including `applicationId`, `versionCode`, `versionName`, and SDK versions.

Customize the Android app icon, adaptive icon, and splash screen using the @capacitor/assets tool.

Generate a private signing key and keystore for the application using `keytool` and securely store its credentials.

Configure the project's `build.gradle` file to use the signing key for debug builds.

Diagnose common Android build failures, including Gradle sync errors, SDK license issues, and AndroidManifest merge conflicts.