Troubleshoot emulators

United States
Latin America

You may encounter a few common issues when configuring or using a Clover device emulator.

Log in failure for a European region production account

If your login attempts for a European region production merchant result in a Secure Sockets Layer (SSL) handshake error, reset the Clover-specific data on the emulator:

  1. Verify that you have set the device target for Europe as described in Emulator setup in Android Studio - Update 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 pop-up, click OK.

The app data is cleared. You can now log in with your merchant account for Europe.

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, stop the running emulator as follows:

  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. In this command, replace emulator-5554 with the designation of your emulator.
  4. Re-run the adb devices command to verify you were able to stop the device.
  5. Launch the newly added emulator and then run the ./ script.
  6. After the app 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 ways to do so:

  • All team members log in to the emulator with the Owner account credentials.
  • Each member creates their 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 hardware emulator profiles within Android Studio with a MAC M1 Apple chip, an error displays the profile is terminated.


To troubleshoot:

  1. In your Android Studio IDE, open the Preference settings.
  2. From the left navigation menu, select Tools > Emulator.
  3. Clear the Launch in a tool window checkbox.
  1. Click Apply.