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

​
Prerequisites

For remote emulators:
  • Node.js 22.12.0+ or 24.0.0+
  • Android SDK platform-tools (adb), with ANDROID_HOME exported and pointing at the SDK directory that contains platform-tools/adb
  • An APK to upload
Remote emulators connect through a local adb tunnel, so adb is required even though the emulator itself runs on Momentic’s infrastructure. Only the platform-tools are needed: Android Studio, Java, and a local emulator image are not.
adb on your PATH alone is not enough. Export ANDROID_HOME as well, or the run fails at driver startup with Neither ANDROID_HOME nor ANDROID_SDK_ROOT environment variable was exported.
For local emulators, add:
  • Java JDK 24 (or later)
  • Android Studio (latest stable) with platform-tools and emulator components

​
Install Node.js

Download from nodejs.org.

​
Install adb

Download the Android SDK platform-tools and unzip them into an SDK directory, then export ANDROID_HOME at that directory (not at platform-tools itself):
If you already have Android Studio, platform-tools come with its SDK; export ANDROID_HOME at that SDK instead (see Set ANDROID_HOME).
brew install --cask android-platform-tools puts adb on your PATH but creates no SDK directory, so ANDROID_HOME has nothing valid to point at. Use the zip above, or pair the cask with an SDK layout.

​
Install Java

Java is only needed for local emulators. 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

Android Studio is only needed for local emulators. 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