appium_lib 9.3.4 → 9.3.5

data/docs/ios_xcuitest.md

@@ -53,6 +53,13 @@ textfield(value) # Return a XCUIElementTypeSecureTextField or XCUIElementTypeTex
 finds_exact(value) # Return any elements include `value` as its name attributes.
 ```
 
+### with Class Chain
+- require Appium 1.6.4+
+    - https://github.com/appium/appium-xcuitest-driver/pull/391
+    - https://github.com/appium/java-client/pull/599/files
+- WebDriverAgent
+    - https://github.com/facebook/WebDriverAgent/wiki/Queries
+
 ### with XPath
 - It is better to avoid XPath strategy.
     - https://github.com/appium/appium/blob/v1.6.2/docs/en/advanced-concepts/migrating-to-xcuitest.md#xpath-locator-strategy

data/ios_tests/lib/ios/specs/device/device.rb

@@ -54,7 +54,10 @@ describe 'device/device' do
 
   t 'background_app homescreen' do
     background_app(-1) # background_app(nil) should work as same.
-    screen.must_raise ::Selenium::WebDriver::Error::NoSuchElementError
+
+    screen.must_equal 'UICatalog'
+    # TODO: Should update this assert.
+    # screen.must_raise ::Selenium::WebDriver::Error::NoSuchElementError
   end
 
   t 'reset' do
@@ -80,13 +83,30 @@ describe 'device/device' do
   end
 
   t 'action_chain' do
-    Appium::TouchAction.new.press(element: id('ButtonsExplain')).perform
+    Appium::TouchAction.new.press(element: text(app_strings['ButtonsExplain'])).perform
     wait { id 'ArrowButton' } # successfully transitioned to buttons page
     go_back
   end
 
   t 'swipe' do
-    swipe start_x: 75, start_y: 500, offset_x: 75, offset_y: 0, duration: 800
+    touch_action = swipe(start_x: 75, start_y: 500, offset_x: 75, offset_y: 20, duration: 500)
+    touch_action.actions.must_equal []
+
+    touch_action = Appium::TouchAction.new.swipe(start_x: 75, start_y: 500, offset_x: 75, offset_y: 20, duration: 500)
+
+    touch_action.actions[0][:action].must_equal :press
+    touch_action.actions[0][:options].must_equal(x: 75, y: 500)
+
+    touch_action.actions[1][:action].must_equal :wait,
+                                                touch_action.actions[1][:options].must_equal(ms: 500)
+
+    touch_action.actions[2][:action].must_equal :moveTo
+    touch_action.actions[2][:options].must_equal(x: 75, y: 20)
+
+    touch_action.actions[3][:action].must_equal :release
+
+    touch_action.perform
+    touch_action.actions.must_equal []
   end
 
   t 'pull_file' do

data/ios_tests/lib/ios/specs/ios/mobile_methods.rb

@@ -0,0 +1,20 @@
+# rake ios[ios/mobile_methods]
+describe 'ios/mobile_methods' do
+  def before_first
+    screen.must_equal catalog
+  end
+
+  t 'an element with class chain' do
+    element = find_element :class_chain, 'XCUIElementTypeWindow/*/*/XCUIElementTypeStaticText'
+
+    element.name.must_equal catalog
+  end
+
+  t 'elements with class chain' do
+    elements = find_elements :class_chain, 'XCUIElementTypeWindow/*/*'
+
+    elements.size.must_equal 2
+    elements[0].name.must_equal catalog
+    elements[1].name.must_be_nil
+  end
+end

data/lib/appium_lib/android/element/generic.rb

@@ -29,30 +29,34 @@ module Appium
     end
 
     # @private
-    def scroll_uiselector(content)
-      "new UiScrollable(new UiSelector().scrollable(true).instance(0)).scrollIntoView(#{content}.instance(0));"
+    def scroll_uiselector(content, index = 0)
+      "new UiScrollable(new UiSelector().scrollable(true).instance(#{index})).scrollIntoView(#{content}.instance(0));"
     end
 
     # Scroll to the first element containing target text or description.
-    # @param text [String] the text to search for in the text value and content description
+    # @param text [String] the text or resourceId to search for in the text value and content description
+    # @param scrollable_index [Integer] the index for scrollable views.
     # @return [Element] the element scrolled to
-    def scroll_to(text)
+    def scroll_to(text, scrollable_index = 0)
       text = %("#{text}")
 
-      args = scroll_uiselector("new UiSelector().textContains(#{text})") +
-             scroll_uiselector("new UiSelector().descriptionContains(#{text})")
+      args = scroll_uiselector("new UiSelector().textContains(#{text})", scrollable_index) +
+             scroll_uiselector("new UiSelector().descriptionContains(#{text})", scrollable_index) +
+             scroll_uiselector(resource_id(text, "new UiSelector().resourceId(#{text});"), scrollable_index)
 
       find_element :uiautomator, args
     end
 
     # Scroll to the first element with the exact target text or description.
-    # @param text [String] the text to search for in the text value and content description
+    # @param text [String] the text or resourceId to search for in the text value and content description
+    # @param scrollable_index [Integer] the index for scrollable views.
     # @return [Element] the element scrolled to
-    def scroll_to_exact(text)
+    def scroll_to_exact(text, scrollable_index = 0)
       text = %("#{text}")
 
-      args = scroll_uiselector("new UiSelector().text(#{text})") +
-             scroll_uiselector("new UiSelector().description(#{text})")
+      args = scroll_uiselector("new UiSelector().text(#{text})", scrollable_index) +
+             scroll_uiselector("new UiSelector().description(#{text})", scrollable_index) +
+             scroll_uiselector(resource_id(text, "new UiSelector().resourceId(#{text});"), scrollable_index)
 
       find_element :uiautomator, args
     end

data/lib/appium_lib/android/helper.rb

@@ -256,7 +256,7 @@ module Appium
     # @param on_match [String] the string to return on resourceId match
     #
     # @return [String] empty string on failure, on_match on successful match
-    def _resource_id(string, on_match)
+    def resource_id(string, on_match)
       return '' unless string
 
       # unquote the string
@@ -289,14 +289,14 @@ module Appium
       value = %("#{value}")
 
       if class_name == '*'
-        return (_resource_id(value, "new UiSelector().resourceId(#{value});") +
+        return (resource_id(value, "new UiSelector().resourceId(#{value});") +
           "new UiSelector().descriptionContains(#{value});" \
           "new UiSelector().textContains(#{value});")
       end
 
       class_name = %("#{class_name}")
 
-      _resource_id(value, "new UiSelector().className(#{class_name}).resourceId(#{value});") +
+      resource_id(value, "new UiSelector().className(#{class_name}).resourceId(#{value});") +
         "new UiSelector().className(#{class_name}).descriptionContains(#{value});" \
         "new UiSelector().className(#{class_name}).textContains(#{value});"
     end
@@ -326,14 +326,14 @@ module Appium
       value = %("#{value}")
 
       if class_name == '*'
-        return (_resource_id(value, "new UiSelector().resourceId(#{value});") +
+        return (resource_id(value, "new UiSelector().resourceId(#{value});") +
           "new UiSelector().description(#{value});" \
           "new UiSelector().text(#{value});")
       end
 
       class_name = %("#{class_name}")
 
-      _resource_id(value, "new UiSelector().className(#{class_name}).resourceId(#{value});") +
+      resource_id(value, "new UiSelector().className(#{class_name}).resourceId(#{value});") +
         "new UiSelector().className(#{class_name}).description(#{value});" \
         "new UiSelector().className(#{class_name}).text(#{value});"
     end

data/lib/appium_lib/common/command.rb

@@ -13,6 +13,9 @@ module Appium
         open_notifications:         [:post, 'session/:session_id/appium/device/open_notifications'.freeze],
         toggle_airplane_mode:       [:post, 'session/:session_id/appium/device/toggle_airplane_mode'.freeze],
         current_activity:           [:get,  'session/:session_id/appium/device/current_activity'.freeze],
+        get_system_bars:            [:get,  'session/:session_id/appium/device/system_bars'.freeze],
+        get_display_density:        [:get,  'session/:session_id/appium/device/display_density'.freeze],
+        is_keyboard_shown:          [:get,  'session/:session_id/appium/device/is_keyboard_shown'.freeze],
         get_network_connection:     [:get,  'session/:session_id/network_connection'.freeze],
         get_performance_data_types: [:post, 'session/:session_id/appium/performanceData/types'.freeze],
 

data/lib/appium_lib/common/version.rb

@@ -1,5 +1,5 @@
 module Appium
   # Version and Date are defined on the 'Appium' module, not 'Appium::Common'
-  VERSION = '9.3.4'.freeze unless defined? ::Appium::VERSION
-  DATE    = '2017-03-16'.freeze unless defined? ::Appium::DATE
+  VERSION = '9.3.5'.freeze unless defined? ::Appium::VERSION
+  DATE    = '2017-03-26'.freeze unless defined? ::Appium::DATE
 end

data/lib/appium_lib/device/device.rb

@@ -23,6 +23,30 @@ module Appium
 
     # @!method current_activity
 
+    # @!method get_system_bars
+    #   Get system bar's information
+    #   @return [String] System bar
+    #
+    #   ```ruby
+    #   get_system_bars
+    #   ```
+
+    # @!method get_display_density
+    #   Get connected device's density.
+    #   @return [Integer] The size of density
+    #
+    #   ```ruby
+    #   get_display_density # 320
+    #   ```
+
+    # @!method is_keyboard_shown
+    #   Get whether keyboard is displayed or not.
+    #   @return [Bool] Return true if keyboard is shown. Return false if keyboard is hidden.
+    #
+    #   ```ruby
+    #   is_keyboard_shown # false
+    #   ```
+
     # @!method launch_app
     #   Start the simulator and application configured with desired capabilities
 
@@ -538,7 +562,7 @@ module Appium
     #   @return [String] The context currently being used.
 
     # @!method available_contexts
-    # @return [Array<String>] All usable contexts, as an array of strings.
+    #   @return [Array<String>] All usable contexts, as an array of strings.
 
     # Perform a block within the given context, then switch back to the starting context.
     # @param context (String) The context to switch to for the duration of the block.

data/lib/appium_lib/device/multi_touch.rb

@@ -163,6 +163,8 @@ module Appium
       end
     end # self
 
+    attr_reader :actions
+
     # Create a new multi-action
     def initialize
       @actions = []
@@ -177,6 +179,7 @@ module Appium
     # Ask Appium to perform the actions
     def perform
       $driver.multi_touch @actions
+      @actions.clear
     end
   end # class MultiTouch
 end # module Appium

data/lib/appium_lib/device/touch_actions.rb

@@ -7,6 +7,15 @@ module Appium
   # ```ruby
   # action = TouchAction.new.press(x: 45, y: 100).wait(5).release
   # action.perform
+  # ```
+  #
+  # Or each methods can call without `TouchAction.new` as the following.
+  # In this case, `perform` is called automatically.
+  # ```ruby
+  # # called `swipe(...).perform` in this method.
+  # swipe(start_x: 75, start_y: 500, offset_x: 75, offset_y: 20, duration: 500)
+  # ```
+
   class TouchAction
     ACTIONS         = [:move_to, :long_press, :double_tap, :two_finger_tap, :press, :release, :tap, :wait, :perform].freeze
     COMPLEX_ACTIONS = [:swipe].freeze
@@ -167,6 +176,7 @@ module Appium
     # Ask the driver to perform all actions in this action chain.
     def perform
       $driver.touch_actions @actions
+      @actions.clear
       self
     end
 

data/lib/appium_lib/ios/mobile_methods.rb

@@ -16,9 +16,23 @@ module Appium
       #    find_elements :predicate, 'wdName == "Buttons"'
       #    find_elements :predicate, 'wdValue == "SearchBar" AND isWDDivisible == 1'
       #   ```
+      #
+      # @!method ios_class_chain_find
+      #   Only for XCUITest(WebDriverAgent)
+      #   find_element/s can be used with a [class chain]( https://github.com/facebook/WebDriverAgent/wiki/Queries)
+      #
+      #   ```ruby
+      #    # select the third child button of the first child window element
+      #    find_elements :class_chain, 'XCUIElementTypeWindow/XCUIElementTypeButton[3]'
+      #    # select all the children windows
+      #    find_elements :class_chain, 'XCUIElementTypeWindow'
+      #    # select the second last child of the second child window
+      #    find_elements :class_chain, 'XCUIElementTypeWindow[2]/XCUIElementTypeAny[-2]'
+      #   ```
       def extended(_mod)
         ::Appium::Driver::SearchContext::FINDERS[:uiautomation] = '-ios uiautomation'
         ::Appium::Driver::SearchContext::FINDERS[:predicate] = '-ios predicate string'
+        ::Appium::Driver::SearchContext::FINDERS[:class_chain] = '-ios class chain'
       end
     end # class << self
   end # module Ios

data/release_notes.md

@@ -1,3 +1,14 @@
+#### v9.3.4 2017-03-16
+
+- [2b01065](https://github.com/appium/ruby_lib/commit/2b01065d0b2c2287ed9568cb23de5e459082ef62) Release 9 3 4 (#509)
+- [0abf62f](https://github.com/appium/ruby_lib/commit/0abf62f0fa99d1ce0841a98e86a6ca334a143f0e) add doc for uiautomator (#508)
+- [0199159](https://github.com/appium/ruby_lib/commit/0199159b6f0193884ebcffbfa460b3403859e537) Search with predicate (#504)
+- [dbd8762](https://github.com/appium/ruby_lib/commit/dbd87620b771e7448e9826181b0ae595701ccaa2) Update deactive app for xcuitest (#502)
+- [e06b25e](https://github.com/appium/ruby_lib/commit/e06b25ed1df5ed1a67fcf1a59767cc42ddcdb0d0) add a test for predicate (#499)
+- [447f13c](https://github.com/appium/ruby_lib/commit/447f13cd799652d203bed4fc557b3c251ef2aa2c) Use awesome print 1.7 (#498)
+- [a68cc5f](https://github.com/appium/ruby_lib/commit/a68cc5fc38b64d1d41945024a808df9af90828d7) remove workaround for rainbow (#497)
+
+
 #### v9.3.3 2017-02-18
 
 - [422a468](https://github.com/appium/ruby_lib/commit/422a4683f10fc99d3731985d532b71e1fe80b4e6) Release 9 3 3 (#494)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appium_lib
 version: !ruby/object:Gem::Version
-  version: 9.3.4
+  version: 9.3.5
 platform: ruby
 authors:
 - code@bootstraponline.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-03-16 00:00:00.000000000 Z
+date: 2017-03-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
@@ -331,6 +331,7 @@ files:
 - ios_tests/lib/ios/specs/ios/element/text.rb
 - ios_tests/lib/ios/specs/ios/element/textfield.rb
 - ios_tests/lib/ios/specs/ios/helper.rb
+- ios_tests/lib/ios/specs/ios/mobile_methods.rb
 - ios_tests/lib/ios/specs/ios/patch.rb
 - ios_tests/lib/run.rb
 - ios_tests/readme.md