Setup Android Emulator app

Requirements

adb

In order to install Appfigurate Emulator app into an Android Emulator, AppfigurateSE runs the adb tool that should be located in the default Android SDK installation directory of:

~/Library/Android/sdk

If your Android SDK installation directory is located elsewhere, tapping the Android SDK settings toolbar icon will display a directory picker dialog. Navigate to your Android SDK installation directory, and tap Choose.

Java

AppfigurateSE also runs the apksigner tool, which requires a Java JRE or JDK to be installed.

macOS

Open a Terminal and run the java command. If the following message is displayed:

%> java
The operation couldn’t be completed. Unable to locate a Java Runtime.
Please visit http://www.java.com for information on installing Java.

then you will need to install a JRE or JDK. We recommend Adoptium.

Windows

Install app

To install the Appfigurate Emulator app into an Android Emulator, tap the Android Emulator tab. If no Android Emulators are detected then the following message is shown:

Launch your chosen Android Emulator using Android Studio.

Once the Android Emulator has launched, AppfigurateSE will display the following screen:

Tap the Install Appfigurate Emulator button to install into your chosen Android Emulator.

Upgrade app

Any previous version of Appfigurate Emulator can be upgraded by tapping the Upgrade Appfigurate Emulator button.

Uninstall app

In the Android Emulator, from the home screen, long press the Appfigurate Emulator app icon, tap App Info, then tap Remove App.

Sync database

AppfigurateSE uses the Android SDK adb tool to copy the database to and from the Android Emulator. After using this tool, the adb daemon running in the Android Emulator will have root privileges. You can manually change this back to user privileges using adb unroot command.

In order to use the Sync database feature, the underlying Android Emulator image needs to be a Google API System Image. If you use a Google Play System Image, the Sync database feature will fail unless you manually root the image with a 3rd party tool like rootAVD.

If the Appfigurate Emulator app is installed in the Android Emulator, the Sync database button is shown.

Tapping the Sync database button will display the following screen:

The local database of app metadata records (stored in ~/Library/Application Support/Appfigurate/ for macOS and %LOCALAPPDATA%\Appfigurate\ for Windows) is displayed in the left hand column. The selected Android Emulator's database is displayed in the right hand column.

Copying the macOS or Windows host database to Android Emulator.

Tap the circular blue button → to copy the local database of app metadata records to the Android Emulator. Any running Appfigurate Emulator app will be automatically terminated and relaunched.

Copying Android Emulator database to macOS or Windows host.

Tap the circular blue button ← to copy the Android Emulator database to the local database of app metadata records. If you have Appfigurate Simulator app(s) running in iOS Simulator(s), you should terminate and relaunch them manually.