How to Setup Appium on a Mac – Using Java and Appium CheatsheetGo Back
- Posted by Leonidas Kanellopoulos
When I started to search online on how to install and use Appium, all of the info was spread out in different articles, so I decided to make a type of handbook for setting up and using Appium quickly on a new machine (in this case mac), as well as for keeping in place various Appium methods that help me out with elements that are difficult to address. The following are not all necessary, but they do help in the long run, especially when you start to develop your Appium project (in this case I use a maven type project as a reference).
How to Setup Appium On A Mac For Android and iOS Devices
Star off by opening the mac os terminal and install the following to get it up and running:
Install brew package manager:
Make the hidden files appear:
Restart all finder windows so you can see hidden files:
If you don’t have a bash_profile, make one, so you can set the environment variables for android and java later:
Appium needs node.js so let us install this too!
Now let’s install Java
The following are needed for iOS devices.
If you want a specific version of Appium use this:
You must also install the android SDK tools from googles site as well as the latest Xcode version and the Xcode Command line tools
Or via the Terminal
For Xcode go to the appstore and search for Xcode and install it.
Then run the following line in the terminal to install the command line tools:
Check if xcode is installed:
Check the version of the xcode command line tools:
Also make sure you set the the following home environment variables. Open a terminal window and go to your user folder and type in:
The mac text editor will open up. There you should inlcude your android sdk and Java home paths. Depending on where you installed them these might be different. The file although should and up looking something like this:
Now for a final check run this:
You should get all greens from the report something similar to the image below:
Appium setup for iOS devices
To starting using Appium and the Appium inspector for iOS devices you must first install the webdriveragent app to your iOS device.
Open a terminal and go to the folder below
Now create the following directory:
Now run the following script
Lastly build and install the webdriveragent app that will enable for Appium to talk to your device
For more detailed steps follow the steps provided at the Appium github page
Appium Cheat Sheet
In this part I have gathered various “fixes” and “how to’s” for common troubleshooting situations but also some helpful Appium driver methods that are important for creating your testing scenarios.
Make Appium run faster on android by disabling animations.
Appium utilises the UIAutomator/UIAutomator2 Driver for android and the XCUITest driver for iOS. A common issue that you might face is that Appium is not that fast, when tapping and checking if elements exist, depending of the app complexity and android version. The native android espresso driver is super fast, if you have seen it, and currently the Appium devs are busy integrating it for the new version of Appium. Until then a simple way to overcome this is by disabling animations on your android phone. This makes tests run much faster but still not as the espresso driver. To disable the animations you need to activate the developer options on your android. To enable this mode do the following:
>Go to Settings -> About phone -> Build Number (tap on it as many times needed until you see the developer options activated) -> go back to settings, scroll down and you should see the dev options, tap on that and then scroll to the part where you disable the animations. Try running your tests again and you will notice the difference.
Appium cant start because port is occupied.
Sometimes, when you attempt to start the Appium inspector or run your Appium project, you might get an error that the port needed by Appium is occupied.
Kill the Appium server:
View your android and iOS connected devices:
This displays the devices serial number that is also uses for the UDID capability for appium, simply type in the terminal the following:
For iOS devices:
How to find the accessibility ID’s, element names and xpaths of an application.
Appium provides a very handy application called appium desktop that you can find here: https://github.com/appium/appium-desktop.
The way appium desktop works is by firstly setting up your device capabilities within its UI interface and then starts an appium server in order to start your desired app and inspect it.
You can use this for android and iOS devices
This is provided together with android sdk tools and can be found in the path below:
The advantage of this inspector is that you just plugin your android device and start the viewer without the need of starting an appium server.
Xcode Accessibility Inspector
Open up Xcode and make sure your iPhone is plugged in. On the menu bar choose Xcode -> Open developer Tool -> Accessibility Inspector and then choose your device.
Click on the target cursor in the window that opens and then perfom an actual tap on the iPhone. You will see the info of the tapped element appear in the Xcode window.
Usefull Appium Driver Methods
In this section I have gathered some useful Appium driver methods that will help you in doing specific actions or checks.
How to take a Device Screenshot with Appium
Take a screenshot of your phone so you can now what was displayed when your scenario crashes.
For android use this:
Or by using the terminal command via Java:
How to swipe with Appium
There are a lot of methods out there on the internet and after my search the below methods are the ones that I have tested and can say they work. ( for me at least !) driver.navigate().to(“Log out”).
But android has various sizes so if you want for instance to swipe from the center up you need to first get your coords of the centre of the current device.
For iOS: (using Java client 5)
Otherwise you can also use the following for Java-client 4 version
How to wait until elements are displayed
How to click on using the accessibility ID
Type something on your device
Of course there are many more useful commands that we use daily. These are just a few to give you an understanding of how things work in general. Hopefully, I will add some more in the near future. I hope you enjoyed this post. Feel free to comment below with your suggestions.
Take care and TEST!!