Commerce Applications SDK Installation

The Verifone Commerce Application SDK is a plugin for the Android Studio IDE. The plugin integrates into an existing
Android Studio installation (downloaded and installed separately).

The latest version of the Verifone Commerce Applications SDK plugin is 2.4.0.6, released May 24 2019

System Requirements
Upgrading an Existing Installation
Plugin Installation Instructions for Windows
Plugin Installation Instructions for MAC
Emulator update instructions

System Requirements

Software Pre-Requisites

 Compatible desktop client versions: Windows 7, Windows 10 Enterprise, MacOS High Sierra 10.13.2 to 10.13.6
 An existing Android studio installation - supported versions are 3.3.x and 3.2.x can be downloaded from here.
 SDK now makes use of internal JRE of android studio. So, Oracle JDK is not required.
 It is mandatory to update the emulator before verifying latest payment service related changes.
 Verifone Android app require Android API Level 22 to be downloaded from Android SDK Manager.
 Android Studio uses the plugin as a ZIP file, therefore please Do Not Unzip the downloaded plugin zip file.

Upgrading an existing installation

A Verifone Commerce SDK Plugin can be upgraded over an existing installation. If you have an existing Verifone
Commerce SDK Plugin installed on your system, we assume you are familiar with installing plugins in Android Studio.

To upgrade an existing installation please follow the steps below

 Download the plugin to your PC

 Open the the Android Studio Settings screen
 Click the Plugins option
 Click the Install plugin from disk button
 Select the file you downloaded above
 Follow on-screen instructions to complete the installation

Plugin Installation Instructions for Windows

 Note, after installing the plugin you may need to update the emulator, see related instructions at the end of this
page
 Open the Commerce Applications SDK devtools instance or if you have not used the Commerce Applications
SDK previously open the Android Studio.
 Navigate to the 'Welcome screen'. If the plugin is not installed, screen will look like this
 And if the previous plugin version is installed, the screen will have options like this. You can install the new plugin
on top of the previous one without removing it.

 Select the 'Configure' option at the bottom of the screen.

  Click on 'Plugins' option under 'Configure'.

File menu option (Windows):

This option is very useful when user turns off welcome screen in Android studio.

 Click on File option from menu bar.

 Select Settings... option.
 Settings screen will be display.
 Navigate to Plugins option.

 Remove/Uninstall the plugin (installed earlier), from Android Studio by clicking on 'Commerce Applications SDK'
option and 'Restart Android Studio'
 Follow steps from here and once on 'Plugins' screen, check for 'Install plugin from disk' option.
 Click on 'Install plugin from disk' option and select the zip plugin file which is stored on the local machine.
 Once the plugin is installed, the 'Plugins' wizard will show an option for 'Restart Android Studio'.
 Click on 'Restart Android Studio' and let the android studio restart to show the installed plugin.
EULA are now displayed in this 'Restart Android Studio' button in the 'Plugins' wizard.
 If you have a previous SDK version installed, remove/uninstall the plugin from Android Studio by clicking on
'Commerce Applications SDK' entry in the plugin list, clicking the uninstall button in the right pane, and then
clicking the 'Restart Android Studio'.

 Return to the step #2 and once on 'Plugins' screen, check for 'Install Plugin' from disk option.
 Click on 'Install plugin from disk' option and select the zip plugin file which is stored on the local machine.
 Once the plugin is installed, the plugin wizard will show an option for restarting the Android Studio.
 Click on the 'Restart Android Studio' and let the Android Studio restart to show the installed plugin.
 Before the studio is restarted, a prompt will be shown on Windows machine for Font Installer. Please select Yes
for it.

 SDK Plugin is installed. Read the SDK license text and after reading press OK

o
 After following all the above steps, the plugin with required dependencies will be installed and
Verifone Application option will be available on the welcome screen.
 Next check if you need to update the emulator, see instructions towards the end of this page
o

Emulator update instructions for Windows and Mac

There are following two ways to update emulator in Android Studio:

 Welcome screen.
 File menu option(Windows) OR Android studio option (Mac).

Welcome screen :

 Navigate to Welcome screen.

 Click on Configure option and Select SDK Manager option.
File menu option(Windows):
This option is very useful when user turns off welcome screen in Android studio.

 Click on File option from menu bar.

 Select Settings... option.
 Default Settings Window is displayed.

Android Studio option (Mac):

This option is very useful when user turns off welcome screen in Android studio.

 Click on Android Studio option from menu bar.

 Select Preferences... option.

 Preferences screen will be display.

 Click on Appearance & Behavior option.
 Click on System Settings option.
 Select Android SDK option.
Navigate to SDK Tools tab and select following tools:

 Android Emulator.
 Android SDK Platform-Tools.

Click on Apply and OK button to update the require configuration files.