Setup Android Emulator app

Requirements

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 Settings toolbar icon will display a directory picker dialog. Navigate to your Android SDK installation directory, and tap Choose.

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 macOS + iOS shared database (stored in ~/Library/Application Support/Appfigurate/) is displayed in the left hand column. The Android Emulator's database is displayed in the right hand column.

Copying macOS host database to Android Emulator.

Tap the circular blue button → to copy the local macOS + iOS shared database to the Android Emulator. Any running Appfigurate Emulator app will be automatically terminated and relaunched.

Copying Android Emulator database to macOS host.

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