Troubleshooting emulators

There are a few common issues you may encounter when configuring or using a Clover device emulator.

Log on failure for EU production account

If your log on attempts for an EU production merchant result in an SSL handshake error, complete the following steps to reset the Clover-specific data on the emulator.

  1. Verify that you have set the device target for EU as described in Emulator setup in Android Studio - Updating device settings for production testing.
  2. Open the Settings app.
  3. Click Apps & notifications.
  4. Click App info.
  5. Click Clover.
  6. Click Storage.
  7. Click Clear data.
  8. On the Delete app data dialog, click OK.

The app data is cleared. You can now log on with your EU merchant account.

Unable to add more than one Clover device emulator

If a Clover device emulator is already running, you can add another emulator but cannot run the ./ script on the new emulator. To run the script, first you must stop the running emulator by performing the following steps:

  1. Use the adb devices command to return the list of devices that are running.
  2. From that list, grab the designation for the emulator you want to stop (such as emulator-5554).
  3. Use the adb -s emulator-5554 emu kill command (replacing emulator-5554 with whatever your emulator's designation is).
  4. Run the adb devices command again to verify you were able to stop the desired device.
  5. Launch the newly added emulator and then run the ./ script.
  6. After the apps installation is completed, run the previous emulator.

Only the Owner of a merchant account can set up the emulator

To set up an emulator you must be the Owner of a merchant account. If multiple members of a team need to test on emulators, there are a couple ways to do so:

  1. Have all team members log in to the emulator with the Owner account credentials.
  2. Have each member create their own developer account (not as an invitee to the common developer account). When you create a developer account, a merchant is created and you are assigned the Owner of that merchant.

Issue with Android Studio Clover Emulator Profile and Apple M1 Chip

When trying to run Clover's hardware emulator profiles within Android Studio with a MAC M1 Apple chip, an error returns saying the profile has been terminated.


If you experience this error, complete the following steps as a workaround:

  1. In your Android Studio IDE, open the Preference settings.
  2. Click the Tools dropdown.
  3. Click the Emulator option on the side menu.
  4. Clear the Launch in a tool window checkbox.
  1. Click Apply in the bottom right area.