Module: Calabash::Android::Operations

Includes:
DragHelpers, EnvironmentHelpers, TextHelpers, TouchHelpers, WaitHelpers
Included in:
Calabash::ABase
Defined in:
lib/calabash-android/operations.rb

Defined Under Namespace

Classes: Device

Constant Summary

Constants included from MonkeyHelpers

MonkeyHelpers::MAX_RETRIES

Constants included from WaitHelpers

WaitHelpers::DEFAULT_OPTS

Class Method Summary collapse

Instance Method Summary collapse

Methods included from DragHelpers

#drag_and_drop, #drag_coordinates

Methods included from MonkeyHelpers

#adb_command, #existing_monkey_pids, #get_monkey_port, #kill_existing_monkey_processes, #kill_monkey_processes_on_device, #kill_monkey_processes_on_host, #monkey_move_from, #monkey_tap, #monkey_touch, #start_monkey

Methods included from EnvironmentHelpers

#xamarin_test_cloud?

Methods included from WaitHelpers

#handle_error_with_options, #screenshot_and_retry, #until_element_does_not_exist, #until_element_exists, #wait_error, #wait_for, #wait_for_activity, #wait_for_element_does_not_exist, #wait_for_element_exists, #wait_for_elements_do_not_exist, #wait_for_elements_exist, #wait_for_text, #wait_for_text_to_disappear, #wait_poll, #when_element_exists

Methods included from TouchHelpers

#double_tap, #drag, #execute_gesture, #find_coordinate, #flick, #flick_down, #flick_left, #flick_right, #flick_up, #long_press, #long_press_when_element_exists, #pan, #pan_down, #pan_left, #pan_right, #pan_up, #pinch, #pinch_in, #pinch_out, #query_result?, #tap, #tap_mark, #tap_when_element_exists, #touch

Methods included from TextHelpers

#assert_text, #clear_text, #clear_text_in, #enter_text, #escape_quotes, #has_text?, #keyboard_enter_char, #keyboard_enter_text, #keyboard_visible?, #set_selection, #wait_for_keyboard

Class Method Details

.extended(base) ⇒ Object 



41
42
43
44
45
46
47
48
49
50
 
# File 'lib/calabash-android/operations.rb', line 41

def self.extended(base)
  if (class << base; included_modules.map(&:to_s).include?('Cucumber::RbSupport::RbWorld'); end)
    unless instance_methods.include?(:embed)
      original_embed = base.method(:embed)
      define_method(:embed) do |*args|
        original_embed.call(*args)
      end
    end
  end
end

Instance Method Details

#app_to_background(secs) ⇒ Object 



1171
1172
1173
 
# File 'lib/calabash-android/operations.rb', line 1171

def app_to_background(secs)
  ni
end

#backdoor(method_name, arguments = [], options = {}) ⇒ Object 



1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
 
# File 'lib/calabash-android/operations.rb', line 1241

def backdoor(method_name, arguments = [], options={})
  arguments = [arguments] unless arguments.is_a?(Array)

  result = JSON.parse(http('/backdoor', {method_name: method_name, arguments: arguments}))

  if result['outcome'] != 'SUCCESS'
    raise result.to_s
  end

  result['result']
end

#cell_swipe(options = {}) ⇒ Object 



1028
1029
1030
 
# File 'lib/calabash-android/operations.rb', line 1028

def cell_swipe(options={})
  ni
end

#check_element_does_not_exist(query) ⇒ Object 



1193
1194
1195
1196
1197
 
# File 'lib/calabash-android/operations.rb', line 1193

def check_element_does_not_exist( query )
  if element_exists( query )
    screenshot_and_raise "Expected no elements to match query: #{query}"
  end
end

#check_element_exists(query) ⇒ Object 



1187
1188
1189
1190
1191
 
# File 'lib/calabash-android/operations.rb', line 1187

def check_element_exists( query )
  if not element_exists( query )
    screenshot_and_raise "No element found for query: #{query}"
  end
end

#check_view_with_mark_exists(expected_mark) ⇒ Object 



1199
1200
1201
 
# File 'lib/calabash-android/operations.rb', line 1199

def check_view_with_mark_exists(expected_mark)
  check_element_exists( "view marked:'#{expected_mark}'" )
end

#classes(query_string, *args) ⇒ Object 



254
255
256
 
# File 'lib/calabash-android/operations.rb', line 254

def classes(query_string, *args)
  query(query_string, :class, *args)
end

#clear_app_data ⇒ Object 



130
131
132
 
# File 'lib/calabash-android/operations.rb', line 130

def clear_app_data
  default_device.clear_app_data
end

#clear_preferences(name) ⇒ Object 



187
188
189
 
# File 'lib/calabash-android/operations.rb', line 187

def clear_preferences(name)
  default_device.clear_preferences(name)
end

#client_version ⇒ Object 



159
160
161
 
# File 'lib/calabash-android/operations.rb', line 159

def client_version
  default_device.client_version
end

#connect_to_test_server ⇒ Object

app life cycle



273
274
275
276
277
 
# File 'lib/calabash-android/operations.rb', line 273

def connect_to_test_server
  puts "Explicit calls to connect_to_test_server should be removed."
  puts "Please take a look in your hooks file for calls to this methods."
  puts "(Hooks are stored in features/support)"
end

#current_activity ⇒ Object 



52
53
54
 
# File 'lib/calabash-android/operations.rb', line 52

def current_activity
  `#{default_device.adb_command} shell dumpsys window windows`.force_encoding('UTF-8').each_line.grep(/mFocusedApp.+[\.\/]([^.\s\/\}]+)/){$1}.first
end

#default_device ⇒ Object 



68
69
70
 
# File 'lib/calabash-android/operations.rb', line 68

def default_device
  @@default_device ||= Device.new(self, ENV["ADB_DEVICE_ARG"], ENV["TEST_SERVER_PORT"], ENV["APP_PATH"], ENV["TEST_APP_PATH"])
end

#deprecated_actions ⇒ Object 



99
100
101
102
103
 
# File 'lib/calabash-android/operations.rb', line 99

def deprecated_actions
  @deprecated_actions ||= Hash[
      *File.readlines(File.join(File.dirname(__FILE__), 'deprecated_actions.map')).map{|e| e.chomp.split(',', 2)}.flatten
  ]
end

#disconnect_from_test_server ⇒ Object 



279
280
281
282
283
 
# File 'lib/calabash-android/operations.rb', line 279

def disconnect_from_test_server
  puts "Explicit calls to disconnect_from_test_server should be removed."
  puts "Please take a look in your hooks file for calls to this methods."
  puts "(Hooks are stored in features/support)"
end

#done ⇒ Object 



1032
1033
1034
 
# File 'lib/calabash-android/operations.rb', line 1032

def done
  ni
end

#each_item(opts = {:query => "android.widget.ListView", :post_scroll => 0.2}, &block) ⇒ Object 



213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
 
# File 'lib/calabash-android/operations.rb', line 213

def each_item(opts={:query => "android.widget.ListView", :post_scroll => 0.2}, &block)
  uiquery = opts[:query] || "android.widget.ListView"
  skip_if = opts[:skip_if] || lambda { |i| false }
  stop_when = opts[:stop_when] || lambda { |i| false }
  check_element_exists(uiquery)
  num_items = query(opts[:query], :adapter, :count).first
  num_items.times do |item|
    next if skip_if.call(item)
    break if stop_when.call(item)

    scroll_to_row(opts[:query], item)
    sleep(opts[:post_scroll]) if opts[:post_scroll] and opts[:post_scroll] > 0
    yield(item)
  end
end

#element_does_not_exist(uiquery) ⇒ Object 



1175
1176
1177
 
# File 'lib/calabash-android/operations.rb', line 1175

def element_does_not_exist(uiquery)
  query(uiquery).empty?
end

#element_exists(uiquery) ⇒ Object 



1179
1180
1181
 
# File 'lib/calabash-android/operations.rb', line 1179

def element_exists(uiquery)
  not element_does_not_exist(uiquery)
end

#element_is_not_hidden(uiquery) ⇒ Object

a better name would be element_exists_and_is_not_hidden



1204
1205
1206
 
# File 'lib/calabash-android/operations.rb', line 1204

def element_is_not_hidden(uiquery)
  ni
end

#evaluate_javascript(query_string, javascript, opt = {}) ⇒ Object 



1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
 
# File 'lib/calabash-android/operations.rb', line 1229

def evaluate_javascript(query_string, javascript, opt={})
  wait_for_elements_exist(query_string, {timeout: Calabash::Android::Defaults.query_timeout})
  result = JSON.parse(http("/map", {query: query_string, operation: {method_name: 'execute-javascript'}, javascript: javascript}))

  if result['outcome'] != 'SUCCESS' || result['results'].nil?
    parsed_result = result['results'].map {|r| "\"#{r}\","}.join("\n")
    raise "Could not evaluate javascript: \n#{parsed_result}"
  end

  result['results']
end

#execute_uiquery(uiquery) ⇒ Object 



876
877
878
879
880
881
882
883
884
885
886
887
888
889
 
# File 'lib/calabash-android/operations.rb', line 876

def execute_uiquery(uiquery)
  if uiquery.instance_of? String
    elements = query(uiquery)

    return elements.first unless elements.empty?
  else
    elements = uiquery

    return elements.first if elements.instance_of?(Array)
    return elements if elements.instance_of?(Hash)
  end

  nil
end

#fail(msg = "Error. Check log for details.", options = {:prefix => nil, :name => nil, :label => nil}) ⇒ Object 



167
168
169
 
# File 'lib/calabash-android/operations.rb', line 167

def fail(msg="Error. Check log for details.", options={:prefix => nil, :name => nil, :label => nil})
  screenshot_and_raise(msg, options)
end

#find_scrollable_view(options = {}) ⇒ Object 



1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
 
# File 'lib/calabash-android/operations.rb', line 1036

def find_scrollable_view(options={})
  timeout = options[:timeout] || 30

  begin
    Timeout.timeout(timeout, WaitError) do
      scroll_view_query_string = "android.widget.ScrollView index:0"
      list_view_query_string = "android.widget.AbsListView index:0"
      web_view_query_string = "android.webkit.WebView index:0"

      loop do
        if element_exists(scroll_view_query_string)
          return scroll_view_query_string
        elsif element_exists(list_view_query_string)
          return list_view_query_string
        elsif element_exists(web_view_query_string)
          return web_view_query_string
        end
      end
    end
  rescue WaitError
    raise WaitError.new('Could not find any scrollable views')
  end
end

#flash(query_string) ⇒ Object 



209
210
211
 
# File 'lib/calabash-android/operations.rb', line 209

def flash(query_string)
  map(query_string, :flash)
end

#get_preferences(name) ⇒ Object 



179
180
181
 
# File 'lib/calabash-android/operations.rb', line 179

def get_preferences(name)
  default_device.get_preferences(name)
end

#hide_soft_keyboard ⇒ Object 



872
873
874
 
# File 'lib/calabash-android/operations.rb', line 872

def hide_soft_keyboard
  perform_action('hide_soft_keyboard')
end

#html(q) ⇒ Object 



917
918
919
 
# File 'lib/calabash-android/operations.rb', line 917

def html(q)
  query(q).map {|e| e['html']}
end

#http(path, data = {}, options = {}) ⇒ Object 



895
896
897
 
# File 'lib/calabash-android/operations.rb', line 895

def http(path, data = {}, options = {})
  default_device.http(path, data, options)
end

#http_put(path, data = {}, options = {}) ⇒ Object 



899
900
901
 
# File 'lib/calabash-android/operations.rb', line 899

def http_put(path, data = {}, options = {})
  default_device.http_put(path, data, options)
end

#install_app(app_path) ⇒ Object 



113
114
115
 
# File 'lib/calabash-android/operations.rb', line 113

def install_app(app_path)
  default_device.install_app(app_path)
end

#interpolate(recording, options = {}) ⇒ Object 



1217
1218
1219
 
# File 'lib/calabash-android/operations.rb', line 1217

def interpolate(recording, options={})
  ni
end

#label(uiquery) ⇒ Object 



859
860
861
 
# File 'lib/calabash-android/operations.rb', line 859

def label(uiquery)
  ni
end

#load_dylib(file_path, classes = []) ⇒ Object

Parameters:

  • file_path (String) —

    Path of the file to load (.apk or .jar)

  • classes (Array<String>) (defaults to: []) —

    A list of classes to load from the file



912
913
914
915
 
# File 'lib/calabash-android/operations.rb', line 912

def load_dylib(file_path, classes = [])
  uploaded_file = upload_file(file_path)
  http('/load-dylib', {path: uploaded_file, classes: classes})
end

#load_playback_data(recording, options = {}) ⇒ Object 



1209
1210
1211
 
# File 'lib/calabash-android/operations.rb', line 1209

def load_playback_data(recording,options={})
  ni
end

#log(message) ⇒ Object 



56
57
58
 
# File 'lib/calabash-android/operations.rb', line 56

def log(message)
  $stdout.puts "#{Time.now.strftime("%Y-%m-%d %H:%M:%S")} - #{message}" if (ARGV.include? "-v" or ARGV.include? "--verbose")
end

#macro(txt) ⇒ Object 



60
61
62
63
64
65
66
 
# File 'lib/calabash-android/operations.rb', line 60

def macro(txt)
  if self.respond_to?(:step)
    step(txt)
  else
    Then(txt)
  end
end

#make_http_request(options) ⇒ Object 



1272
1273
1274
 
# File 'lib/calabash-android/operations.rb', line 1272

def make_http_request(options)
  default_device.make_http_request(options)
end

#map(query, method_name, *method_args) ⇒ Object 



1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
 
# File 'lib/calabash-android/operations.rb', line 1253

def map(query, method_name, *method_args)
  operation_map = {
      :method_name => method_name,
      :arguments => method_args
  }
  res = http("/map",
             {:query => query, :operation => operation_map})
  res = JSON.parse(res)
  if res['outcome'] != 'SUCCESS'
    screenshot_and_raise "map #{query}, #{method_name} failed because: #{res['reason']}\n#{res['details']}"
  end

  res['results']
end

#ni ⇒ Object 



258
259
260
 
# File 'lib/calabash-android/operations.rb', line 258

def ni
  raise "Not yet implemented."
end

#page(clz, *args) ⇒ Object

simple page object helper



266
267
268
 
# File 'lib/calabash-android/operations.rb', line 266

def page(clz, *args)
  clz.new(self, *args)
end

#perform_action(action, *arguments) ⇒ Object 



82
83
84
85
86
87
88
89
90
91
92
93
 
# File 'lib/calabash-android/operations.rb', line 82

def perform_action(action, *arguments)
  if removed_actions.include?(action)
    puts "\e[31mError: The action '#{action}' was removed in calabash-android 0.5\e[0m"
    puts 'Solutions that do not require the removed action can be found on:'
    puts "\e[36mhttps://github.com/calabash/calabash-android/blob/master/migrating_to_calabash_0.5.md\##{action}\e[0m"
  elsif deprecated_actions.has_key?(action)
    puts "\e[31mWarning: The action '#{action}' is deprecated\e[0m"
    puts "\e[32mUse '#{deprecated_actions[action]}' instead\e[0m"
  end

  default_device.perform_action(action, *arguments)
end

#performAction(action, *arguments) ⇒ Object 



76
77
78
79
80
 
# File 'lib/calabash-android/operations.rb', line 76

def performAction(action, *arguments)
  puts "Warning: The method performAction is deprecated. Please use perform_action instead."

  perform_action(action, *arguments)
end

#playback(recording, options = {}) ⇒ Object 



1213
1214
1215
 
# File 'lib/calabash-android/operations.rb', line 1213

def playback(recording, options={})
  ni
end

#press_back_button ⇒ Object 



940
941
942
 
# File 'lib/calabash-android/operations.rb', line 940

def press_back_button
  press_button('KEYCODE_BACK')
end

#press_button(key) ⇒ Object 



936
937
938
 
# File 'lib/calabash-android/operations.rb', line 936

def press_button(key)
  perform_action('press_key', key)
end

#press_down_button ⇒ Object 



948
949
950
 
# File 'lib/calabash-android/operations.rb', line 948

def press_down_button
  press_button('KEYCODE_DPAD_DOWN')
end

#press_enter_button ⇒ Object 



964
965
966
 
# File 'lib/calabash-android/operations.rb', line 964

def press_enter_button
  press_button('KEYCODE_ENTER')
end

#press_left_button ⇒ Object 



956
957
958
 
# File 'lib/calabash-android/operations.rb', line 956

def press_left_button
  press_button('KEYCODE_DPAD_LEFT')
end

#press_menu_button ⇒ Object 



944
945
946
 
# File 'lib/calabash-android/operations.rb', line 944

def press_menu_button
  press_button('KEYCODE_MENU')
end

#press_right_button ⇒ Object 



960
961
962
 
# File 'lib/calabash-android/operations.rb', line 960

def press_right_button
  press_button('KEYCODE_DPAD_RIGHT')
end

#press_up_button ⇒ Object 



952
953
954
 
# File 'lib/calabash-android/operations.rb', line 952

def press_up_button
  press_button('KEYCODE_DPAD_UP')
end

#press_user_action_button(action_name = nil) ⇒ Object 



926
927
928
929
930
931
932
933
934
 
# File 'lib/calabash-android/operations.rb', line 926

def press_user_action_button(action_name=nil)
  wait_for_keyboard

  if action_name.nil?
    perform_action("press_user_action_button")
  else
    perform_action("press_user_action_button", action_name)
  end
end

#pull(remote, local) ⇒ Object 



134
135
136
 
# File 'lib/calabash-android/operations.rb', line 134

def pull(remote, local)
  default_device.pull(remote, local)
end

#push(local, remote) ⇒ Object 



138
139
140
 
# File 'lib/calabash-android/operations.rb', line 138

def push(local, remote)
  default_device.push(local, remote)
end

#query(uiquery, *args) ⇒ Object 



191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
 
# File 'lib/calabash-android/operations.rb', line 191

def query(uiquery, *args)
  converted_args = []
  args.each do |arg|
    if arg.is_a?(Hash) and arg.count == 1
      if arg.values.is_a?(Array) && arg.values.count == 1
        values = arg.values.flatten
      else
        values = [arg.values]
      end

      converted_args << {:method_name => arg.keys.first, :arguments => values}
    else
      converted_args << arg
    end
  end
  map(uiquery,:query,*converted_args)
end

#record_begin ⇒ Object 



1221
1222
1223
 
# File 'lib/calabash-android/operations.rb', line 1221

def record_begin
  ni
end

#record_end(file_name) ⇒ Object 



1225
1226
1227
 
# File 'lib/calabash-android/operations.rb', line 1225

def record_end(file_name)
  ni
end

#reinstall_apps ⇒ Object 



105
106
107
 
# File 'lib/calabash-android/operations.rb', line 105

def reinstall_apps
  default_device.reinstall_apps
end

#reinstall_test_server ⇒ Object 



109
110
111
 
# File 'lib/calabash-android/operations.rb', line 109

def reinstall_test_server
  default_device.reinstall_test_server
end

#removed_actions ⇒ Object 



95
96
97
 
# File 'lib/calabash-android/operations.rb', line 95

def removed_actions
  @removed_actions ||= File.readlines(File.join(File.dirname(__FILE__), 'removed_actions.txt')).map(&:chomp)
end

#rotate(dir) ⇒ Object 



1167
1168
1169
 
# File 'lib/calabash-android/operations.rb', line 1167

def rotate(dir)
  ni
end

#screenshot(options = {:prefix => nil, :name => nil}) ⇒ Object 



155
156
157
 
# File 'lib/calabash-android/operations.rb', line 155

def screenshot(options={:prefix => nil, :name => nil})
  default_device.screenshot(options)
end

#screenshot_and_raise(e, options = nil) ⇒ Object 



863
864
865
866
867
868
869
870
 
# File 'lib/calabash-android/operations.rb', line 863

def screenshot_and_raise(e, options = nil)
  if options
    screenshot_embed options
  else
    screenshot_embed
  end
  raise e
end

#screenshot_embed(options = {:prefix => nil, :name => nil, :label => nil}) ⇒ Object 



150
151
152
153
 
# File 'lib/calabash-android/operations.rb', line 150

def screenshot_embed(options={:prefix => nil, :name => nil, :label => nil})
  path = default_device.screenshot(options)
  embed(path, "image/png", options[:label] || File.basename(path))
end

#scroll(query_string, direction) ⇒ Object 



1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
 
# File 'lib/calabash-android/operations.rb', line 1068

def scroll(query_string, direction)
  if direction != :up && direction != :down
    raise 'Only upwards and downwards scrolling is supported for now'
  end

  action = lambda do
    elements = query(query_string)
    raise "No elements found. Query: #{query_string}" if elements.empty?

    if elements.length > 1
      query_string = "#{query_string} index:0"
    end

    element = elements.first

    response = query(query_string, :getFirstVisiblePosition).first

    if response.is_a?(Hash) && response.has_key?("error") # View is not of type android.widget.AbsListView
      scroll_x = 0
      scroll_y = 0
      width = element['rect']['width']
      height = element['rect']['height']

      if direction == :up
        scroll_y = -height/2
      else
        scroll_y = height/2
      end

      query(query_string, {scrollBy: [scroll_x.to_i, scroll_y.to_i]})
    else # View is of type android.widget.AbsListView
      first_position = response.to_i
      last_position = query(query_string, :getLastVisiblePosition).first.to_i

      selection_index = if direction == :up
                          [first_position + [first_position - last_position + 1, -1].min, 0].max
                        elsif direction == :down
                          first_position + [last_position - first_position, 1].max
                        end

      query(query_string, setSelection: selection_index)
    end
  end

  when_element_exists(query_string, action: action)
end

#scroll_down(options = {}) ⇒ Object 



1064
1065
1066
 
# File 'lib/calabash-android/operations.rb', line 1064

def scroll_down(options={})
  scroll(find_scrollable_view(options), :down)
end

#scroll_to(query_string, options = {}) ⇒ Object 



1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
 
# File 'lib/calabash-android/operations.rb', line 1115

def scroll_to(query_string, options={})
  options[:action] ||= lambda {}

  all_query_string = query_string

  unless all_query_string.chomp.downcase.start_with?('all')
    all_query_string = "all #{all_query_string}"
  end

  wait_for_element_exists(all_query_string)

  element = query(all_query_string).first
  raise "No elements found. Query: #{all_query_string}" if element.nil?
  element_y = element['rect']['y']
  element_height = element['rect']['height']
  element_bottom = element_y + element_height

  scroll_view_query_string = options[:container] || if element.has_key?('html')
                                                      "android.webkit.WebView id:'#{element['webView']}'"
                                                    else
                                                      "#{all_query_string} parent android.widget.ScrollView index:0"
                                                    end

  scroll_element = query(scroll_view_query_string).first

  raise "Could not find parent scroll view. Query: '#{escape_quotes(scroll_view_query_string)}'" if scroll_element.nil?

  scroll_element_y = scroll_element['rect']['y']
  scroll_element_height = scroll_element['rect']['height']

  if element_bottom > scroll_element_y + scroll_element_height
    scroll_by_y = element_bottom - (scroll_element_y + scroll_element_height)
  elsif element_y < scroll_element_y
    scroll_by_y = element_y - scroll_element_y
  else
    scroll_by_y = 0
  end

  if scroll_by_y != 0
    result = query(scroll_view_query_string, {scrollBy: [0, scroll_by_y]}).first
    raise 'Could not scroll parent view' if result != '<VOID>'
  end

  visibility_query_string = all_query_string[4..-1]
  when_element_exists(visibility_query_string, options)
end

#scroll_to_row(uiquery, number) ⇒ Object 



1162
1163
1164
1165
 
# File 'lib/calabash-android/operations.rb', line 1162

def scroll_to_row(uiquery,number)
  query(uiquery, {:smoothScrollToPosition => number})
  puts "TODO:detect end of scroll - use sleep for now"
end

#scroll_up(options = {}) ⇒ Object 



1060
1061
1062
 
# File 'lib/calabash-android/operations.rb', line 1060

def scroll_up(options={})
  scroll(find_scrollable_view(options), :up)
end

#select_context_menu_item(view_uiquery, menu_item_query_string) ⇒ Object 



973
974
975
976
977
978
979
980
981
 
# File 'lib/calabash-android/operations.rb', line 973

def select_context_menu_item(view_uiquery, menu_item_query_string)
  long_press(view_uiquery)

  container_class = 'com.android.internal.view.menu.ListMenuItemView'
  wait_for_element_exists(container_class)

  combined_query_string = "#{container_class} descendant #{menu_item_query_string}"
  touch(combined_query_string)
end

#select_item_from_spinner(item_query_string, options = {}) ⇒ Object 



983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
 
# File 'lib/calabash-android/operations.rb', line 983

def (item_query_string, options={})
   = options[:spinner] || "android.widget.AbsSpinner"
  direction = options[:direction] || :down
  count = query(, :getCount).first
  scroll_view_query_string = options[:scroll_view] || "android.widget.AbsListView index:0"

  unless direction == :up || direction == :down
    raise "Invalid direction '#{direction}'. Only upwards and downwards scrolling is supported"
  end

  touch()

  change_direction = false

  wait_for({retry_frequency: 0}.merge(options)) do
    if query(item_query_string).empty?
      scroll(scroll_view_query_string, direction)

      if change_direction
        direction = direction == :up ? :down : :up
        change_direction = false
      else
        # Because getLastVisiblePosition returns the last element even though it is not visible,
        # we have to scroll one more time to make sure we do not change direction before the last
        # element is fully visible
        if direction == :down
          change_direction = true if query(scroll_view_query_string, :getLastVisiblePosition).first+1 == count
        elsif direction == :up
          change_direction = true if query(scroll_view_query_string, :getFirstVisiblePosition).first == 0
        end
      end

      false
    else
      true
    end
  end

  touch(item_query_string)
end

#select_options_menu_item(identifier, options = {}) ⇒ Object 



968
969
970
971
 
# File 'lib/calabash-android/operations.rb', line 968

def select_options_menu_item(identifier, options={})
  press_menu_button
  tap_when_element_exists("DropDownListView * marked:'#{identifier}'", options)
end

#server_version ⇒ Object 



163
164
165
 
# File 'lib/calabash-android/operations.rb', line 163

def server_version
  default_device.server_version
end

#set_date(query_string, year_or_datestring, month = nil, day = nil) ⇒ Object 



229
230
231
232
233
234
235
236
237
238
239
 
# File 'lib/calabash-android/operations.rb', line 229

def set_date(query_string, year_or_datestring, month=nil, day=nil)
  wait_for_element_exists(query_string)

  if month.nil? && day.nil? && year_or_datestring.is_a?(String)
    date = Date.parse(year_or_datestring)
    set_date(query_string, date.year, date.month, date.day)
  else
    year = year_or_datestring
    query(query_string, updateDate: [year, month-1, day])
  end
end

#set_default_device(device) ⇒ Object 



72
73
74
 
# File 'lib/calabash-android/operations.rb', line 72

def set_default_device(device)
  @@default_device = device
end

#set_gps_coordinates(latitude, longitude) ⇒ Object 



175
176
177
 
# File 'lib/calabash-android/operations.rb', line 175

def set_gps_coordinates(latitude, longitude)
  default_device.set_gps_coordinates(latitude, longitude)
end

#set_gps_coordinates_from_location(location) ⇒ Object 



171
172
173
 
# File 'lib/calabash-android/operations.rb', line 171

def set_gps_coordinates_from_location(location)
  default_device.set_gps_coordinates_from_location(location)
end

#set_preferences(name, hash) ⇒ Object 



183
184
185
 
# File 'lib/calabash-android/operations.rb', line 183

def set_preferences(name, hash)
  default_device.set_preferences(name, hash)
end

#set_text(uiquery, txt) ⇒ Object 



921
922
923
924
 
# File 'lib/calabash-android/operations.rb', line 921

def set_text(uiquery, txt)
  puts "set_text is deprecated. Use enter_text instead"
  enter_text(uiquery, txt)
end

#set_time(query_string, hour_or_timestring, minute = nil) ⇒ Object 



241
242
243
244
245
246
247
248
249
250
251
252
 
# File 'lib/calabash-android/operations.rb', line 241

def set_time(query_string, hour_or_timestring, minute=nil)
  wait_for_element_exists(query_string)

  if minute.nil? && hour_or_timestring.is_a?(String)
    time = Time.parse(hour_or_timestring)
    set_time(query_string, time.hour, time.min)
  else
    hour = hour_or_timestring
    query(query_string, setCurrentHour: hour)
    query(query_string, setCurrentMinute: minute)
  end
end

#shutdown_test_server ⇒ Object 



146
147
148
 
# File 'lib/calabash-android/operations.rb', line 146

def shutdown_test_server
  default_device.shutdown_test_server
end

#start_test_server_in_background(options = {}) ⇒ Object 



142
143
144
 
# File 'lib/calabash-android/operations.rb', line 142

def start_test_server_in_background(options={})
  default_device.start_test_server_in_background(options)
end

#step_deprecated ⇒ Object 



891
892
893
 
# File 'lib/calabash-android/operations.rb', line 891

def step_deprecated
  puts 'Warning: This predefined step is deprecated.'
end

#swipe(query_string, options = {}) ⇒ Object 



1024
1025
1026
 
# File 'lib/calabash-android/operations.rb', line 1024

def swipe(query_string, options={})
  raise 'Swipe not implemented. Use flick or pan instead.'
end

#uninstall_apps ⇒ Object 



121
122
123
124
 
# File 'lib/calabash-android/operations.rb', line 121

def uninstall_apps
  default_device.uninstall_app(package_name(default_device.test_server_path))
  default_device.uninstall_app(package_name(default_device.app_path))
end

#update_app(app_path) ⇒ Object 



117
118
119
 
# File 'lib/calabash-android/operations.rb', line 117

def update_app(app_path)
  default_device.update_app(app_path)
end

#upload_file(file_path) ⇒ String

Returns The path of the uploaded file on the device.

Returns:

  • (String) —

    The path of the uploaded file on the device



904
905
906
907
908
 
# File 'lib/calabash-android/operations.rb', line 904

def upload_file(file_path)
  name = File.basename(file_path)
  device_tmp_path = http_put('/add-file', File.binread(file_path))
  http('/move-cache-file-to-public', {from: device_tmp_path, name: name})
end

#url_for(method) ⇒ Object 



1268
1269
1270
 
# File 'lib/calabash-android/operations.rb', line 1268

def url_for( method )
  default_device.url_for(method)
end

#view_with_mark_exists(expected_mark) ⇒ Object 



1183
1184
1185
 
# File 'lib/calabash-android/operations.rb', line 1183

def view_with_mark_exists(expected_mark)
  element_exists( "android.view.View marked:'#{expected_mark}'" )
end

#wake_up ⇒ Object 



126
127
128
 
# File 'lib/calabash-android/operations.rb', line 126

def wake_up
  default_device.wake_up()
end