# GETTING STARTED # ----------------- # This documentation is intended to show you how to get started with a # simple Appium & appium_lib test. This example is written without a specific # testing framework in mind; You can use appium_lib on any framework you like. # # INSTALLING RVM # -------------- # We're assuming you've got rvm installed, but if not, from a terminal # run the following line (removing the ""'s): # # "\curl -L https://get.rvm.io | bash -s stable --ruby" # # INSTALLING GEMS # --------------- # Then, change to the example directory: # "cd appium-location/sample-code/examples/ruby" # # and install the required gems with bundler by doing: # "bundle install" # # RUNNING THE TESTS # ----------------- # To actually run the tests, make sure appium is running in another terminal # window, then from the same window you used for the above commands, type # "ruby simple_test.rb" # # It will take a while, but once it's done you should get nothing but a line # telling you "Tests Succeeded"; You'll see the iOS Simulator cranking away # doing actions while we're running. require 'rubygems' require 'appium_lib' APP_PATH = '../../apps/TestApp/build/release-iphonesimulator/TestApp.app' desired_caps = { 'platformName' => 'ios', 'versionNumber' => '7.1', 'app' => APP_PATH } # Start the driver Appium::Driver.new(caps: desired_caps).start_driver module Calculator module IOS # Add all the Appium library methods to Test to make # calling them look nicer. Appium.promote_singleton_appium_methods Calculator # Add two numbers values = [rand(10), rand(10)] expected_sum = values.reduce(&:+) # Find every textfield. elements = textfields elements.each_with_index do |element, index| element.type values[index] end # Click the first button button(1).click # Get the first static text field, then get its text actual_sum = first_text.text raise unless actual_sum == (expected_sum.to_s) # Alerts are visible button('show alert').click find_element :class_name, 'UIAAlert' # Elements can be found by :class_name # wait for alert to show wait { text 'this alert is so cool' } # Elements can be found by their Class and value of an attribute find_ele_by_attr 'UIATableCell', :label, 'Cancel' # Or by find find('Cancel').click # Waits until alert doesn't exist wait_true { !exists { tag('UIAAlert') } } # Alerts can be switched into button('show alert').click # Get a button by its text alert = driver.switch_to.alert # Get the text of the current alert, using # the Selenium::WebDriver directly alerting_text = alert.text raise Exception unless alerting_text.include? 'Cool title' alert_accept # Accept the current alert # Window Size is easy to get sizes = window_size raise Exception unless sizes.height == 568 raise Exception unless sizes.width == 320 # Quit when you're done! driver_quit puts 'Tests Succeeded!' end end