sc-frank-ios 1.2.3

data/lib/frank-cucumber/gesture_helper.rb

@@ -0,0 +1,99 @@
+module Frank
+	module Cucumber
+		module GestureHelper
+
+			# Touch and hold the selector for a given duration
+			#
+			# @param [String] selector a view selector.
+			# @param [Number] duration the duration of the touch, the default is 1.
+			#
+			# @return [Array<Boolean>] an array indicating for each view which matched the selector whether it was touched or not.
+			#
+			# @raise an expection if no views matched the selector
+			# @raise an expection if no views which matched the selector could be touched
+			def tap_and_hold( selector, duration = 1 )
+				touch_successes = frankly_map( selector, "touchAndHold:", duration )
+				raise "Could not find anything matching [#{selector}] to long touch" if touch_successes.empty?
+			    raise "Some views could not be long touched (probably because they are not within the current viewport)" if touch_successes.include?(false)
+			end
+
+			# Touch and hold the selector at a specific point for a given duration
+			#
+			# @param [String] selector a view selector.
+			# @param [Number] duration the duration of the touch, the default is 1.
+			# @param [Number] x the x-coordinate to touch
+			# @param [Number] y the y-coordinate to touch
+			#
+			# @return [Array<Boolean>] an array indicating for each view which matched the selector whether it was touched or not.
+			#
+			# @raise an expection if no views matched the selector
+			# @raise an expection if no views which matched the selector could be touched
+			def tap_and_hold_point( selector, x, y, duration = 1 )
+				touch_successes = frankly_map( selector, "touchAndHold:x:y:", duration, x, y )
+				raise "Could not find anything matching [#{selector}] to long touch" if touch_successes.empty?
+			    raise "Some views could not be long touched (probably because they are not within the current viewport)" if touch_successes.include?(false)
+			end
+
+			# Double tap the selector
+			#
+			# @param [String] selector a view selector.
+			#
+			# @return [Array<Boolean>] an array indicating for each view which matched the selector whether it was touched or not.
+			#
+			# @raise an expection if no views matched the selector
+			# @raise an expection if no views which matched the selector could be touched
+			def double_tap( selector )
+				touch_successes = frankly_map( selector, "doubleTap"  )
+				raise "Could not find anything matching [#{selector}] to double tap" if touch_successes.empty?
+			    raise "Some views could not be double tap (probably because they are not within the current viewport)" if touch_successes.include?(false)
+			end
+
+			# Double tap the selector at a specific point
+			#
+			# @param [String] selector a view selector.
+			# @param [Number] x the x-coordinate to touch
+			# @param [Number] y the y-coordinate to touch
+			#
+			# @return [Array<Boolean>] an array indicating for each view which matched the selector whether it was touched or not.
+			#
+			# @raise an expection if no views matched the selector
+			# @raise an expection if no views which matched the selector could be touched
+			def double_tap_point( selector, x, y )
+				touch_successes = frankly_map( selector, "doubleTapx:y:", x, y )
+				raise "Could not find anything matching [#{selector}] to double tap" if touch_successes.empty?
+			    raise "Some views could not be double tap (probably because they are not within the current viewport)" if touch_successes.include?(false)
+			end
+			
+			# Drag the slider thumb to required value, taking the specified time
+			#
+			# @param [String] selector A view selector
+			# @param [Number] value The value up to which the slider should be dragged
+			# @param [Number] duration The time interval that the drag should take
+			#
+			#  @return [Array<Boolean>] an array indicating for each view which matched the selector if the value was acceptable or not
+			#
+			# @raise an expection if no views matched the selector
+			# @raise an expection if no views which matched the selector could have their thumbs dragged
+			def drag_thumb_in_slider( selector, value, duration )
+				touch_successes = frankly_map( selector, "FEX_dragThumbToValue:withDuration:", value, duration)
+				raise "Could not find anything matching [#{selector}] to have its thumb dragged" if touch_successes.empty?
+			    raise "Some views could not had their thumbs dragged (are they even UISLiders?)" if touch_successes.include?(false)
+			end
+			
+			# Drag the slider thumb to required value
+			#
+			# @param [String] selector A view selector
+			# @param [Number] value The value up to which the slider should be dragged
+			#
+			#  @return [Array<Boolean>] an array indicating for each view which matched the selector if the value was acceptable or not
+			#
+			# @raise an expection if no views matched the selector
+			# @raise an expection if no views which matched the selector could have their thumbs dragged
+			def drag_thumb_in_slider_with_default_duration( selector, value )
+				touch_successes = frankly_map( selector, "FEX_dragThumbToValue:", value )
+				raise "Could not find anything matching [#{selector}] to have its thumb dragged" if touch_successes.empty?
+			    raise "Some views could not had their thumbs dragged (are they even UISLiders?)" if touch_successes.include?(false)
+			end
+		end
+	end
+end

data/lib/frank-cucumber/host_scripting.rb

@@ -0,0 +1,96 @@
+require 'frank-cucumber/frank_localize'
+
+module Frank module Cucumber
+
+module HostScripting
+
+  def start_recording
+    %x{osascript<<APPLESCRIPT
+	tell application "QuickTime Player"
+	set sr to new screen recording
+	  tell sr to start
+	end tell
+  APPLESCRIPT}
+
+  end
+
+  def stop_recording
+    %x{osascript<<APPLESCRIPT
+	tell application "QuickTime Player"
+	  set sr to (document 1)
+	  tell sr to stop
+	end tell
+  APPLESCRIPT}
+  end
+
+  def quit_simulator
+    %x{osascript<<APPLESCRIPT-
+      application id "com.apple.iphonesimulator" quit
+    APPLESCRIPT}
+  end
+
+  def quit_double_simulator
+    %x{osascript<<APPLESCRIPT
+      activate application id "com.apple.iphonesimulator"
+      tell application "System Events"
+        tell process "#{Localize.t(:iphone_simulator)}"
+          if (value of static text 1 of window 1) is "#{Localize.t(:only_one_simulator)}" then
+            click button 1 of window 1
+          end if
+        end tell
+      end tell
+    }
+  end
+
+def simulator_reset_data
+  %x{osascript<<APPLESCRIPT
+activate application id "com.apple.iphonesimulator"
+tell application "System Events"
+  click menu item 5 of menu 1 of menu bar item 2 of menu bar 1 of process "#{Localize.t(:iphone_simulator)}"
+  delay 0.5
+  click button "#{Localize.t(:iphone_simulator_reset)}" of window 1 of process "#{Localize.t(:iphone_simulator)}"
+end tell
+  APPLESCRIPT}
+end
+
+  #Note this needs to have "Enable access for assistive devices"
+  #chcked in the Universal Access system preferences
+  def simulator_hardware_menu_press( menu_label )
+    %x{osascript<<APPLESCRIPT
+activate application id "com.apple.iphonesimulator"
+tell application "System Events"
+	click menu item "#{menu_label}" of menu "#{Localize.t(:hardware)}" of menu bar of process "#{Localize.t(:iphone_simulator)}"
+end tell
+  APPLESCRIPT}
+  end
+
+  def press_home_on_simulator
+    simulator_hardware_menu_press Localize.t(:home)
+  end
+
+  def rotate_simulator_left
+    simulator_hardware_menu_press Localize.t(:rotate_left)
+  end
+
+  def rotate_simulator_right
+    simulator_hardware_menu_press Localize.t(:rotate_right)
+  end
+
+  def shake_simulator
+    simulator_hardware_menu_press Localize.t(:shake_gesture)
+  end
+
+  def simulate_memory_warning
+    simulator_hardware_menu_press Localize.t(:simulate_memory_warning)
+  end
+
+  def toggle_call_status_bar
+    simulator_hardware_menu_press Localize.t(:toggle_call_status_bar)
+  end
+
+  def simulate_hardware_keyboard
+    simulator_hardware_menu_press Localize.t(:simulate_hardware_keyboard)
+  end
+end
+
+end end

data/lib/frank-cucumber/keyboard_helper.rb

@@ -0,0 +1,69 @@
+module Frank
+module Cucumber
+
+module KeyboardHelper
+  # Ask Frank to press a sequence of keys on the iOS keyboard.
+  #
+  # @note The keyboard must be fully visible on the device before calling this method.
+  #
+  # The "/b" control character is interpreted as a request to press the 'Delete' key.
+  #
+  # An implicit return is appended to the key sequence, unless you explicitly specify otherwise by setting the :append_return option to false.
+  #
+  # @example
+  #   # press the X, -, Y, and z keys on the
+  #   # iOS keyboard, then press return
+  #   type_into_keyboard("X-Yz")
+  #
+  #   # press the 1, 2, and 3 keys on the
+  #   # iOS keyboard, but don't press return afterwards
+  #   type_into_keyboard("123", :append_return => false)
+  #
+  #   # press the 1, 2, and 3 keys on the
+  #   # iOS keyboard, but don't press return afterwards
+  #   type_into_keyboard("123", :append_return => false)
+  #
+  #   # press Delete twice, then type "foo"
+  #   type_into_keyboard("\b\bfoo")
+  #
+  def type_into_keyboard(text_to_type, options = {})
+    options = {
+      :append_return => true
+    }.merge(options)
+
+    if( options[:append_return] )
+      text_to_type = text_to_type+"\n" unless text_to_type.end_with?("\n")
+    end
+    res = frank_server.send_post(
+      'type_into_keyboard',
+      :text_to_type => text_to_type
+    )
+    Frank::Cucumber::Gateway.evaluate_frankly_response( res, "typing the following into the keyboard '#{text_to_type}'" )
+  end
+
+  # Type a keyboard shortcut (Mac only)
+  #
+  # This function takes as arguments either a single string, or an array of strings, with
+  # each string representing a different key to press. Modifier keys are represented by
+  # the strings "command", "shift", "option", and "control".
+  #
+  # For example, to sent a keyboard shortcut to quit the app, you would call
+  #
+  # type shortcut "command", "q"
+  def type_shortcut(*args)
+    if args[0].kind_of?(Array)
+      return type_shortcut(*args)
+    else
+      key = args.pop
+
+      res = frank_server.send_post(
+        'type_into_keyboard',
+        :text_to_type => key,
+        :modifiers => args
+      )
+
+      Frank::Cucumber::Gateway.evaluate_frankly_response(res, "typing the following shortcut into the keyboard '#{key}' with modifiers #{args}")
+    end
+  end
+end
+end end

data/lib/frank-cucumber/launcher.rb

@@ -0,0 +1,70 @@
+require 'sim_launcher'
+require 'frank-cucumber/app_bundle_locator'
+
+module Frank module Cucumber
+
+module Launcher 
+  attr_accessor :application_path, :sdk, :version
+
+  def simulator_client
+    @simulator_client ||= SimLauncher::Client.new(@application_path, @sdk, @version)
+  end
+
+  def simulator_direct_client
+    @simulator_direct_client ||= SimLauncher::DirectClient.new(@application_path, @sdk, @version)
+  end
+
+  def enforce(app_path, locator = Frank::Cucumber::AppBundleLocator.new)
+    if app_path.nil?
+      message = "APP_BUNDLE_PATH is not set. \n\nPlease set APP_BUNDLE_PATH (either an environment variable, or the ruby constant in support/env.rb) to the path of your Frankified target's iOS app bundle."
+      possible_app_bundles = locator.guess_possible_app_bundles_for_dir( Dir.pwd )
+      if possible_app_bundles && !possible_app_bundles.empty?
+        message << "\n\nBased on your current directory, you probably want to use one of the following paths for your APP_BUNDLE_PATH:\n"
+        message << possible_app_bundles.join("\n")
+      end
+      raise "\n\n"+("="*80)+"\n"+message+"\n"+("="*80)+"\n\n"
+    end
+
+    if app_path_problem = SimLauncher.check_app_path(app_path)
+      raise "\n\n"+("="*80)+"\n"+app_path_problem+"\n"+("="*80)+"\n\n"
+    end
+  end
+
+  def launch_app(app_path, sdk = nil, version = 'iphone')
+    @application_path = app_path
+    @sdk = sdk
+    @version = version
+
+    enforce(app_path)
+
+    # kill the app if it's already running, just in case this helps 
+    # reduce simulator flakiness when relaunching the app. Use a timeout of 5 seconds to 
+    # prevent us hanging around for ages waiting for the ping to fail if the app isn't running
+    begin
+      Timeout::timeout(5) { press_home_on_simulator if frankly_ping }
+    rescue Timeout::Error 
+    end
+
+    if( ENV['USE_SIM_LAUNCHER_SERVER'] )
+      simulator = simulator_client
+    else
+      simulator = simulator_direct_client
+    end
+
+    num_timeouts = 0
+    begin
+      simulator.relaunch
+      wait_for_frank_to_come_up
+    rescue Timeout::Error
+      num_timeouts += 1
+      puts "Encountered #{num_timeouts} timeouts while launching the app."
+      if num_timeouts > 3
+        raise "Encountered #{num_timeouts} timeouts in a row while trying to launch the app."
+      end
+      quit_double_simulator
+      retry
+    end
+
+  end
+end
+end end

data/lib/frank-cucumber/localize.yml

@@ -0,0 +1,104 @@
+en:
+  iphone_simulator: iPhone Simulator
+  iphone_simulator_reset: Reset
+  hardware: Hardware
+  home: Home
+  rotate_left: Rotate Left
+  rotate_right: Rotate Right
+  shake_gesture: Shake Gesture
+  simulate_memory_warning: Simulate Memory Warning
+  toggle_in_call_status_bar: Toggle In-Call Status Bar
+  simulate_hardware_keyboard: Simulate Hardware Keyboard
+  only_one_simulator: Only one iOS Simulator can run at a time.
+
+fr:
+  iphone_simulator: Simulateur iOS
+  iphone_simulator_reset: Réinitialiser
+  hardware: Matériel
+  home: Écran d’accueil
+  rotate_left: Rotation à gauche
+  rotate_right: Rotation à droite
+  shake_gesture: Secousse
+  simulate_memory_warning: Simuler un avertissement de mémoire
+  toggle_in_call_status_bar: Afficher/Masquer la barre d'état d'appel en cour
+  simulate_hardware_keyboard: Simuler un clavier matériel
+  only_one_simulator: Un seul Simulateur iOS peut être exécuté à la fois.
+
+de:
+  iphone_simulator: iOS-Simulator
+  iphone_simulator_reset: Zurücksetzen
+  hardware: Hardware
+  home: Home
+  rotate_left: Links drehen
+  rotate_right: Rechts drehen
+  shake_gesture: Schüttelgeste
+  simulate_memory_warning: Speicherwarnhinweis simulieren
+  toggle_in_call_status_bar: Status für eingeh. Anrufe ein/aus
+  simulate_hardware_keyboard: Hardware-Tastatur simulieren
+  only_one_simulator: Es kann jeweils nur eine iOS-Simulator-Instanz aktiv sein.
+
+ru:
+  iphone_simulator: Симулятор iOS
+  iphone_simulator_reset: Сбросить
+  hardware: Аппаратура
+  home: Экран «Домой»
+  rotate_left: Повернуть влево
+  rotate_right: Повернуть вправо
+  shake_gesture: Выполнить жест встряхивания
+  simulate_memory_warning: Симулировать предупреждение о нехватке памяти
+  toggle_in_call_status_bar: Переключить на строку состояния поступающего вызова
+  simulate_hardware_keyboard: Симулировать физическую клавиатуру
+  only_one_simulator: Два и более Симуляторов iOS не могут быть запущены одновременно.
+
+zh:
+  iphone_simulator: iOS 模拟器
+  iphone_simulator_reset: 还原
+  hardware: 硬件
+  home: 首页
+  rotate_left: 向左旋转
+  rotate_right: 向右旋转
+  shake_gesture: 摇动手势
+  simulate_memory_warning: 模拟内存警告
+  toggle_in_call_status_bar: 切换呼叫状态栏
+  simulate_hardware_keyboard: 模拟硬件键盘
+  only_one_simulator: 一次只能运行一个“iOS 模拟器”。
+
+ja:
+  iphone_simulator: iOSシミュレータ
+  iphone_simulator_reset: リセット
+  hardware: ハードウェア
+  home: ホーム
+  rotate_left: 反時計回りに回転
+  rotate_right: 時計回りに回転
+  shake_gesture: シェイクジェスチャー
+  simulate_memory_warning: メモリ警告をシミュレート
+  toggle_in_call_status_bar: 着信ステータスバーを切り替える
+  simulate_hardware_keyboard: ハードウェアキーボードをシミュレート
+  only_one_simulator: 実行できるiOSシミュレータは1度に1つのみです。
+
+es:
+  iphone_simulator: Simulador iOS
+  iphone_simulator_reset: Restablecer
+  hardware: Hardware
+  home: Inicio
+  rotate_left: Girar a la izquierda
+  rotate_right: Girar a la derecha
+  shake_gesture: Agitar
+  simulate_memory_warning: Simular aviso de memoria
+  toggle_in_call_status_bar: Activar/Desactivar barra de estado durante llamada
+  simulate_hardware_keyboard: Simular teclado físico
+  only_one_simulator: Sólo se puede ejecutar un Simulador iOS a la vez.
+
+it:
+  iphone_simulator: Simulatore iOS
+  iphone_simulator_reset: Reimposta
+  hardware: Hardware
+  home: Home
+  rotate_left: Ruota a sinistra
+  rotate_right: Ruota a destra
+  shake_gesture: Gesto Agita
+  simulate_memory_warning: Simula avviso memoria
+  toggle_in_call_status_bar: Attiva/disattiva barra di state chiamata
+  simulate_hardware_keyboard: Simula la tastiera hardware
+  only_one_simulator: Solo un Simulatore iOS può essere eseguito in un momento.
+

data/lib/frank-cucumber/location_helper.rb

@@ -0,0 +1,20 @@
+module Frank
+  module Cucumber
+    module LocationHelper
+      # Ask Frank to set the location.
+      #
+      # @example
+      #   # Set the location to Stockholm
+      #   set_location(:latitude => 59.338887, :longitude => 18.058425)
+      #
+      def set_location(options = {})
+        res = frank_server.send_post( 
+          'location',
+          :latitude => options[:latitude],
+          :longitude => options[:longitude]
+        )
+        Frank::Cucumber::Gateway.evaluate_frankly_response( res, "setting the location to #{options[:latitude]}, #{options[:longitude]}" )
+      end
+    end
+  end
+end