Appium Windows Installation

If you have AMD chipped PC

Follow the instructions here to install Genymotion emulator. Choose either 64-bit or 32-bit.
Or... bring your own android device to the workshop and a micro-usb cable.

Open CMD and check java version: c:\> java -version
- If the version is less than 1.8 or the command is not recognized you need to install java.
- If the version is 1.8 or greater then go to Ruby install.
Click here
Select the Accept License Agreement radio button.
Click the "jdk-8u221-windows-x64.exe" link for 64-bit machine.
Click the "jdk-8u221-windows-i586.exe" link for 32-bit machine.
Make note of the installation/destination path! You will need this later. e.g. C:\Program Files\Java\jdk1.8.0_xx

Download and install 64-bit or 32-bit
Make note of the NPM installation/destination path! You will need this later. e.g. C:\Users\yourUser\AppData\Roaming\npm

Click here to download Android Studio.
Check the Terms and Conditions checkbox and then click the DOWNLOAD ANDROID STUDIO FOR WINDOWS button.
Then select the RUN button to start the installation after download.
Select Yes to allow this app to makes changes to your device.
Click the Next button.
On the Choose Components dialog make sure Android SDK and Android Virtual Device is checked.
Click the Next button on the Choose Components dialog.
Click the "I Agree" button on the License Agreement.
Set the Android Studio path to: C:\Program Files\Android\Android Studio. This should be the default location.
Set the Android SDK path location to: C:\Users\yourUser\AppData\Local\Android\sdk. This should be the default location.
Set Android Studio for the name of the Start Menu Folder.
Click the Install button. This will take a while...
Click the Next button.
Click the Finish button to start Android Studio.

In Android Studio Welcome dialog.
Click the Configure button. It's on the lower right side of the Android Studio welcome dialog.
click SDK Manager in the configuration dropdown.
Select Android 9.0 (Pie) SDK.
- Why Android 9.0? It's the most common SDK version used throughout the world and is a good starting point until you get more comfortable with mobile automation. See here!
Click the "Show Package Details" checkbox on lower right.
Check (or make sure they are checked) the following SDK dependencies to install:
- Android SDK Platform 23
- Sources for Android 23
- Intel x86 Atom System Image.
- Intel x86 Atom_64 System Image.
- Google API's Intel x86 Atom System Image
- Google API's Intel X86 Atom_64 System Image
Click the OK button
Click the OK button in Confirm Change dialog.
On the next screen click the Accept radio button on the License Agreement.
Click the Next button to install SDK 23 components. This will take a while...
Click the Finish button.

Goto Control Panel\System and Security\System > Advanced system > Edit Variables...
Under "User variables for your_user_name"
Highlight the Path variable.
- Click Edit > New
- Add path for sdk\tools. e.g. C:\Users\youUser\AppData\Local\Android\sdk\tools (change this to your sdk path)
- Click OK
- Add path for sdk\platform-tools. e.g. C:\Users\youUser\AppData\Local\Android\sdk\platform-tools (change this to your sdk path)
- Click OK
- App path for node NPM locaton. e.g. C:\Users\youUser\AppData\Roaming\npm
- Click OK
Add ANDROID_HOME variable.
- Click the New... button.
- Set name: ANDROID_HOME
- Set value: C:\Users\youUser\AppData\Local\Android\sdk (change this to your sdk path)
- Click OK
Add JAVA_HOME variable.
- Click the New... button.
- Set name: JAVA_HOME
- Set value: C:\Program Files\Java\jdk1.8.0_92
- Click OK
See example here for environment variable.
See example here for Path variables.
Close all CMD's and RESTART PC!

Run C:\> java -version in CMD. You should see something close to this java version "1.8.0_144" or greater returned.
Run c:\> emulator -help. You should see menu options for android emulator manager.
Run c:\> npm. You should see the npm menu options.
If any of the above is not working check to make sure the install locations are correct and reflected correctly in the path environment variable.

Run c:\> adb in CMD. You should see this Android Debug Bridge version 1.0.32 and additional menu options.

Run android create avd -n EM1 -k "system-images;android-23;google_apis;x86" in CMD.
Enter NO to not create a custom hardware profile.

Run the emulator: emulator -avd EM1
Note: You might see an error like this "[7264]:ERROR:./android/qt/qt_setup.cpp:28:Qt library not found at ..\emulator\lib64\qt\lib". It's a known problem with the latest Android SDK. There are two ways to get around this.
- 1. Open a powershell terminal and run the command in there.
- 1. Run it from the sdk/tools directory. e.g. cd C:\Users\yourUser\AppData\Local\Android\sdk and then emulator -avd EM1
Verify avd output on startup includes:
- Hax is enabled
- HAX is working and emulator runs in fast virt mode.
Verify emulator fully starts and you see the android home/desktop screen.
Note: Emulator can also be created via the AVD Manager IDE inside of Android Studio. However, you would need to create a new project or import one to see this menu option.

Download, unzip and install here
Make note of the installation/destination path. e.g. C:\Program Files (x86)\Appium
Create desktop icon.

Run C:\> npm install -g appium-doctor
Run C:\> appium-doctor (checks setup is correct on machine)
- Verify "info AppiumDoctor Everything looks good, bye!" is displayed.
- If there are things missing please go back to the install instructions or environment variable setup.

Run C:\> npm install -g appium
- Verify appium installed correctly by doing C:\> appium -v
Note: You might get an error when install appium with NPM. If so, open a powershell window as administrator. e.g. search for powershell in start menu, then right click powershell and select run as administrator.
- In powershell run: Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force
- Run: npm install -g npm-windows-upgrade
- Run: npm-windows-upgrade
- Run: npm install -g appium

Jacobvu84 / serenity-screenplay-junit-appium