Skip to main content
Momentic supports Android apps running on local and remote emulators. Real devices are not supported.

​
Prerequisites

For local emulators:
  • Node.js 22.12.0+ or 24.0.0+
  • Java JDK 24 (or later)
  • Android Studio (latest stable) with platform-tools and emulator components
  • ANDROID_HOME set in your shell
For remote emulators, you do not need local Android Studio or ANDROID_HOME once you have an APK to upload.

​
Install Node.js

Download from nodejs.org.

​
Install Java

Download JDK 24 from Oracle.
If java --version isn’t found, re-open your terminal or make sure JAVA_HOME/bin is on your PATH.

​
Install Android Studio

Download Android Studio and complete the first-run setup. Include:
  • Android SDK Platform-Tools (ADB)
  • Android Emulator

​
Set ANDROID_HOME

Point ANDROID_HOME at your Android SDK install. Typical locations:
  • macOS: /Users/<username>/Library/Android/sdk
  • Linux: /home/<username>/Android/Sdk
  • Windows: C:\Users\<username>\AppData\Local\Android\Sdk

​
Verify

​
Enable WebView debugging

If your app renders content inside an Android WebView, enable WebView debugging so Momentic can attach and interact with elements inside the WebView. Add this to your app’s startup code, before the WebView is used:
Without this, interactions against WebView elements fail with InternalWebAgentError: No browser controller is attached to the requested webview.

​
APK requirements

  • Debug builds with debuggable=true work without extra configuration.
  • Release builds must enable WebView debugging as above if they contain WebView content.
  • Both ARM64 and x86_64 APKs are supported. Remote emulators use x86_64.

​
Next steps

Emulators

Local vs. remote emulators and regions

CI/CD

Run Android tests on every pull request