Class: WDA

Inherits:
Object
  • Object
show all
Includes:
HTTParty, Alert, Custome, Debug, FindElement, Orientation, Screenshot, Session, TouchID, Type
Defined in:
lib/wda_lib.rb,
lib/wda_lib/type.rb,
lib/wda_lib/alert.rb,
lib/wda_lib/debug.rb,
lib/wda_lib/custom.rb,
lib/wda_lib/element.rb,
lib/wda_lib/session.rb,
lib/wda_lib/version.rb,
lib/wda_lib/touch_id.rb,
lib/wda_lib/screenshot.rb,
lib/wda_lib/orientation.rb,
lib/wda_lib/find_element.rb

Defined Under Namespace

Modules: Alert, Custome, Debug, FindElement, Orientation, Screenshot, Session, TouchID, Type Classes: Dimension, Element, Point

Constant Summary collapse

BASE_URL =

Get base_url from XCTRunner logs: ServerURLHere->x.x.x.x:8100<-ServerURLHere Default base_url ‘localhost:8100’ for running XCTRunner on simulator

'http://localhost:8100'
VERSION = 
'0.0.3'

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Type

#match

Methods included from TouchID

#match_touchid

Methods included from Session

#healthcheck, #launch_app, #quit, #restart, #session, #status, #x

Methods included from Screenshot

#screenshot

Methods included from Orientation

#get_rotation, #orientation, #set_orientation, #set_rotation

Methods included from FindElement

#button, #buttons, #find, #find_element, #find_elements, #find_subl_element, #find_subl_elements, #finds, #first_button, #first_textfield, #last_button, #names, #partial_text, #partial_texts, #predicate_text, #predicate_texts, #secure_textfield, #secure_textfields, #statictext, #statictexts, #stringlize, #text, #textfield, #textfields, #texts, #visible_cell, #xpath, #xpath_search

Methods included from Debug

#find_app, #get_source, #get_window, #get_window_statusbar, #source

Methods included from Custome

#homescreen, #pause, #springboard, #timeout, #timeout_in_session

Methods included from Alert

#accept_alert, #alert_text, #dismiss_alert

Constructor Details

#initialize(opts = {}) ⇒ WDA

Create a new client

“‘ruby require ’rubygems’ require ‘wda_lib’

Start wda client opts = { caps: { bundleId: @bundle_id }, device_url: ‘x.x.x.x:8100’ } WDA.new(opts).start_session



45
46
47
48
49
50
51
52
53
54
55
56
57
58
 
# File 'lib/wda_lib.rb', line 45

def initialize(opts = {})
  # fail 'opts should be a hash' unless opts.is_a? Hash
  # fail 'bundleId should be provided' if opts[:bundleId].nil?
  url = opts[:device_url] || BASE_URL
  parsed_url = URI.parse(url)
  @base_url = parsed_url.scheme + '://' + parsed_url.host + ':' + parsed_url.port.to_s
  @url = @base_url
  @server_host = parsed_url.host
  @server_port = parsed_url.port
  status
  window_size
  capabilities(opts)
  @driver = Selenium::WebDriver::Driver.for(:remote, :url => @base_url,  :desired_capabilities => @caps[:desiredCapabilities])
end

Instance Attribute Details

#base_url ⇒ Object (readonly)

Returns the value of attribute base_url.



30
31
32
 
# File 'lib/wda_lib.rb', line 30

def base_url
  @base_url
end

#bundle_id ⇒ Object

Returns the value of attribute bundle_id.



29
30
31
 
# File 'lib/wda_lib.rb', line 29

def bundle_id
  @bundle_id
end

#caps ⇒ Object

Returns the value of attribute caps.



29
30
31
 
# File 'lib/wda_lib.rb', line 29

def caps
  @caps
end

#device ⇒ Object

Returns the value of attribute device.



29
30
31
 
# File 'lib/wda_lib.rb', line 29

def device
  @device
end

#driver ⇒ Object

Returns the value of attribute driver.



29
30
31
 
# File 'lib/wda_lib.rb', line 29

def driver
  @driver
end

#http ⇒ Object

Returns the value of attribute http.



29
30
31
 
# File 'lib/wda_lib.rb', line 29

def http
  @http
end

#server_host ⇒ Object (readonly)

Returns the value of attribute server_host.



30
31
32
 
# File 'lib/wda_lib.rb', line 30

def server_host
  @server_host
end

#server_port ⇒ Object (readonly)

Returns the value of attribute server_port.



30
31
32
 
# File 'lib/wda_lib.rb', line 30

def server_port
  @server_port
end

#session_id ⇒ Object

Returns the value of attribute session_id.



29
30
31
 
# File 'lib/wda_lib.rb', line 29

def session_id
  @session_id
end

#url ⇒ Object (readonly)

Returns the value of attribute url.



30
31
32
 
# File 'lib/wda_lib.rb', line 30

def url
  @url
end

#win_x ⇒ Object (readonly)

Returns the value of attribute win_x.



30
31
32
 
# File 'lib/wda_lib.rb', line 30

def win_x
  @win_x
end

#win_y ⇒ Object (readonly)

Returns the value of attribute win_y.



30
31
32
 
# File 'lib/wda_lib.rb', line 30

def win_y
  @win_y
end

#window_h ⇒ Object (readonly)

Returns the value of attribute window_h.



30
31
32
 
# File 'lib/wda_lib.rb', line 30

def window_h
  @window_h
end

#window_w ⇒ Object (readonly)

Returns the value of attribute window_w.



30
31
32
 
# File 'lib/wda_lib.rb', line 30

def window_w
  @window_w
end

Instance Method Details

#capabilities(opts = {}) ⇒ Object

Build desired_capabilities with options

Parameters:

  • opts (Hash) (defaults to: {})

Returns:

  • attribute caps [Hash]



63
64
65
66
67
68
69
70
71
72
73
74
 
# File 'lib/wda_lib.rb', line 63

def capabilities(opts = {})
  @bundle_id = opts[:bundleId] if !opts[:bundleId].nil?
  selenium_capabilities = Selenium::WebDriver::Remote::W3CCapabilities.new( 
                            browser_name: 'iphone', 
                            platform_name: @platform_name, 
                            platform_version: @platform_version,
                            session_id: @session_id,
                            session_valid: @session_valid,
                            bundleId: @bundle_id
                          )
  @caps = { desiredCapabilities: selenium_capabilities }
end

#delete(path) ⇒ Object 



109
110
111
 
# File 'lib/wda_lib.rb', line 109

def delete(path)
  WDA.delete(path)
end

#get(path) ⇒ Object

HTTP methods for dealing with all supported motheds in FB WDA I don’t like to write such pieces of code, it removes all query params and headers, But as FB WDA is doing like this, this can simplify codes



93
94
95
96
97
98
99
 
# File 'lib/wda_lib.rb', line 93

def get(path)
  if URI.parse(path).absolute?
    WDA.get(path)
  else
    WDA.get(@url + path)
  end
end

#keys(value) ⇒ Object

Type text to textfield

Parameters:

  • value (String) 


171
172
173
 
# File 'lib/wda_lib/element.rb', line 171

def keys(value)
  post '/keys', { value: value.chars }
end

#post(path, body = nil) ⇒ Object 



101
102
103
104
105
106
107
 
# File 'lib/wda_lib.rb', line 101

def post(path, body = nil)
  if URI.parse(path).absolute?
    WDA.post(path, body: body.to_json)
  else
    WDA.post(@url + path, body: body.to_json)
  end
end

#swipe(fromX, toX, fromY, toY) ⇒ Object

Swipe on an element with its id and position

Parameters:

  • (Integer) 


159
160
161
 
# File 'lib/wda_lib/element.rb', line 159

def swipe(fromX, toX, fromY, toY)
  post '/uiaTarget/0/dragfromtoforduration', { fromX: fromX, toX: toX, fromY: fromY, toY: toY, duration: 0 }
end

#tap_on(x, y) ⇒ Object

Tap on a given positon

Parameters:

  • id (String) —

    , x, y [Integer]



165
166
167
 
# File 'lib/wda_lib/element.rb', line 165

def tap_on(x, y)
  post '/tap/0', { x: x, y: y }
end

#update_status(status_response) ⇒ Object

Update current running sessionId to @session_id

Parameters:

  • session_response (object) —

    : http GET session response body



79
80
81
82
83
84
85
86
87
88
 
# File 'lib/wda_lib.rb', line 79

def update_status(status_response)
  @session_id = status_response['sessionId']
  @session_valid = true
  @session_id = status_response['sessionId']
  @platform_name = status_response['value']['os']['name']
  @platform_version = status_response['value']['os']['version']
  @url = @base_url + "/session/#{@session_id}"
  capabilities
  status_response
end

#window_size ⇒ Object

Returns width, height.

Returns:

  • width, height



176
177
178
179
180
181
 
# File 'lib/wda_lib/element.rb', line 176

def window_size
  win_size = get('/window/size')['value']
  @win_x = win_size['width']
  @win_y = win_size['height']
  Dimension.new(win_size['width'], win_size['height'])
end