This document provides an overview of Appium, an open source test automation framework for use with native, hybrid and mobile web apps. It discusses Appium's architecture, how it works with different platforms, how to set it up locally or on Sauce Labs, and provides an introduction to concepts like desired capabilities, finding elements and interacting with apps. The document also outlines a hands-on workshop for using Appium to run tests on Sauce Labs from the command line.

1. mobile automation made awesome
Isaac A. Murchie • Software Developer, Ecosystem & Integrations • Sauce Labs
@AppiumDevs • @imurchie • @saucelabs
MOBILE+WEB DEVCON 2014 • San Francisco, CA
February 3, 2015

2. Appium Workshop
Jonathan Lipps • Director of Ecosystem & Integrations • Sauce Labs
@AppiumDevs • @jlipps • @saucelabs
Ecosystem &
Integrations
Core Developer

3. appium introduction

4. appium is the cross-platform
solution for native, hybrid and
mobile web automation

5. appium is open source

6. Over 5,500 commits
1,869 stars
1,385 forks
Over 160 contributors
1,700 pull requests merged
2,000 issues closed
OSS Rookie of the Year, Bossie award
Over 70 releases

7. appium philosophy

8. Real App Under Test
You should not have to modify or recompile your
application in order to test it.
No discrepancy between test version and
marketplace version.
Ship a binary that passes tests!

9. Language Agnostic
Like Ruby? Write tests in Ruby.
Like JavaScript? Write tests in JavaScript.
…
You get the picture.

10. Don’t Reinvent the Wheel
A mobile automation framework ought to make use
of the tools that are out there, rather than building
everything from scratch.
This goes for API as well.

11. Open Source
In spirit and practice, as well as in name.

12. appium architecture

13. Automation Orchestra
Apple Instruments & UIAutomation for iOS
Google UiAutomator for Android (4.2.1 up)
Google Instrumentation for older Android & hybrid
(via Selendroid)
WebDriver interface

14. appium is a Node.js HTTP server
that creates and handles
WebDriver sessions

15. appium extends the WebDriver
protocol with mobile-specific
behaviors

16. appium can run on your computer,
in your network, or on a cloud
service like Sauce Labs

18. appium setup

19. Local Requirements
!
- Mac 10.9+ with Xcode and iOS SDK
- Android SDK with emulators
- Node.js + NPM
- Java
- Appium client in your language
- Test runner in your language

20. Sauce Requirements
!
- Appium client in your language
- Test runner in your language
- Sauce Labs account

21. Workshop Requirements
!
- Sauce Labs username + access key
- Node.js or io.js
- npm
- grunt

22. code: mobilewebdevcon15

23. Sauce Access Key
!
https://saucelabs.com/account

24. Node
!
- http://nodejs.org/
- brew install node
- node --version
- ought to be v0.10.x

25. Node Package Manager
!
- https://www.npmjs.com/
- should be installed with Node
- npm --version
- ought to be 2.1.18 or greater

26. Fork and clone the repo!
!
git clone https://github.com/appium/javascript-
workshop.git

27. Install the necessary modules
!
- cd javascript-workshop
- npm install

28. Set up credentials:
Mac
!
export SAUCE_USERNAME=“meeee”
export SAUCE_ACCESS_KEY=“xxxxxxx”
Windows
!
SetX SAUCE_USERNAME meeee
SetX SAUCE_ACCESS_KEY xxxxxxx

29. Set up credentials: Easy/Insecure
!
tests/functional/helpers/setup.js

30. appium concepts

31. Types of tests
!
- Native
- Hybrid
- Mobile Web

32. Appium client for JavaScript
!
- We will use wd
- https://github.com/admc/wd
- The official, selenium-webdriver module does
not have the Appium extensions
- webdriver.io is also an option, but we won’t
cover it

33. Desired Capabilities - iOS

34. Desired Capabilities

35. Sessions

36. Finding Elements

37. Finding Elements

38. Interacting with Elements

39. Interacting with WebViews

40. Interacting with WebViews

41. Interacting with the Device

42. Gestures

43. Waits

44. appium hands-on

45. Run the tests!
grunt test:all
# go to https://saucelabs.com/tests to see them running!

46. Problems? Run just one test
SAUCE=1 DEVICE=ios:7.1 mocha -t 90000 -R spec test/functional/ios/
web-specs.js
Or run just one group test
grunt test:ios or grunt test:ios:7.1
grunt test:android or grunt test:android:4.4
!
// try grunt --help for a list of available tasks

47. Further problems?
Grunt will fail fast when there are errors or warnings. Try running it
with the --force options

48. Run tests in parallel
grunt test:all:parallel
grunt test:android:parallel
grunt test:ios:parallel

51. Run tests in parallel

52. Explore the code
-Gruntfile.js
-package.json
-apps
- // test apps, in case you run locally
-node_modules
- // installed by `npm install`
-tests
-functional
-helpers
-apps.js // a list of application names
-caps.js // set up test environments
-setup.js // initialize tests
-common
-f
-android
-hybrid-specs.js
-native-specs.js
-web-specs.js
-ios
-hybrid-specs.js
-native-specs.js
-web-specs.js

53. Sauce Temporary Storage
curl -u YOUR_USERNAME:YOUR_ACCESS_KEY
-X POST
-H "Content-Type: application/octet-stream"
https://saucelabs.com/rest/v1/storage/YOUR_USERNAME/TestApp7.1.app.zip?overwrite=true
--data-binary @apps/TestApp7.1.app.zip
https://docs.saucelabs.com/reference/rest-api/#temporary-storage

54. Cross-platform tests

55. Cross-platform tests

56. Building your app model

57. Building your app model

58. Building your app model (web)

59. Building your app model (web, cont'd)

60. Debugging Failures
!
- Test output / exception messages
- Appium logs
- Logcat / IOS logs
- Screenshot / videos
- driver.source().print() at failure point

61. Appium bugs? Oh noes!
!
- http://discuss.appium.io
- http://github.com/appium/appium/issues
(with logs / repro instructions please!)

62. Ready for more? You could:
!
- Clean up test code into a View Object
Model pattern
- Use driver.source() to write simple tests
for ApiDemos and UICatalog
- Use driver.get(url) to load your web app and explore
with WebDriver
- Write a test for your own app!

63. Thank you!
http://appium.io
https://github.com/appium/appium
@AppiumDevs • @imurchie • @saucelabs