testcentricity_mobile 4.0.2 → 4.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7b1da49ff47653a52199d5b9f72191dd4c23a109325daee033af966272f5086c
-  data.tar.gz: d76708fc1c3384a5b7d98f7212212a3a2892fe112f50ac24343b58e763643ee4
+  metadata.gz: 0d519bfbcede39eaa26f5747d6cd80775251647b0eef46b2d5d67f132ba0cd9f
+  data.tar.gz: 61481d8001fcc958284084910bae13dd83c14d39bedd85d8f055c8cbadecae43
 SHA512:
-  metadata.gz: 2270f5e563176336d880a745c89a698bef717a44185fbe042066b2d463fa265dd6f567465049868eb9d2489062909716b2dffe41a7aff44c312142e3cd53c3b4
-  data.tar.gz: 9069b335fe5928aa03f3ed17e3aa803dd2b65dec9e0756dfa870bccf7ba090f67213581580119ca050a666666f74f1c32a5e22d11b553dd9e01a5e7cda2075a9
+  metadata.gz: 39be2d0fc4c2c384e0ceeaec2325af29b90c53e95a55aa70283582931ce68f632fc6e23e02c030b423514b2ed67ceae1989eb6470a3a3c9f79c4f37da7615d8b
+  data.tar.gz: 15606b7ae0548b6bce2339fdf457cd62ab8288082781eb7199b802e9557b968a0192c1ce88840c455df627a8ee1d6df3b74e9a8fb1dfd7d0313b9d8d2fba291a

data/CHANGELOG.md

@@ -2,6 +2,24 @@
 All notable changes to this project will be documented in this file.
 
 
+## [4.0.4] - 26-APR-2024
+
+### Changed
+
+* Updated `selenium-webdriver` gem to version 4.20.0.
+* Updated `appium_lib` gem to version 15.0.0.
+* Updated `appium_lib_core` gem to version 8.0.1.
+* No longer using deprecated Appium `driver.keyboard_shown?` method.
+
+
+## [4.0.3] - 05-APR-2024
+
+### Fixed
+
+* `AppiumConnect.initialize_appium`, `AppiumServer.start`, and `AppiumServer.running?` methods now support Appium version 2.x.
+Backward compatibility with Appium version 1.x is provided if `APPIUM_SERVER_VERSION` Environment Variable is set to `1`.
+
+
 ## [4.0.2] - 27-MAR-2024
 
 ### Changed

data/README.md

@@ -8,7 +8,7 @@
 
 
 The TestCentricity™ Mobile core framework for native mobile iOS and Android app testing implements a Screen Object Model
-DSL for use with Cucumber (version 7.x or greater) and Appium. It also facilitates the configuration of the appropriate
+DSL for use with Cucumber (version 7.x or greater) and Appium 2.x. It also facilitates the configuration of the appropriate
 Appium capabilities and driver required to establish a connection with locally or cloud hosted iOS and Android real devices
 or simulators.
 
@@ -28,18 +28,28 @@ A complete history of bug fixes and new features can be found in the {file:CHANG
 
 The RubyDocs for this gem can be found [here](https://www.rubydoc.info/gems/testcentricity_mobile/).
 
+Two example projects that demonstrates the implementation of a screen object model framework using Cucumber and TestCentricity™
+Mobile can be found at the following:
+  * [tc_mobile_react_native_demo](https://github.com/TestCentricity/tc_mobile_react_native_demo)
+  * [tc_mobile_wdio_demo](https://github.com/TestCentricity/tc_mobile_wdio_demo)
+
+Refer to [this wiki page](https://github.com/TestCentricity/testcentricity_mobile/wiki/XCUItest-driver-bug-impacts-iOS-dialogs-managed-by-com.apple.springboard) for information on a bug with the latest versions of the XCUItest driver that affects Appium's
+ability to interact with and verify iOS system level modal dialogs.
+
 
 ### Which gem should I use?
 
 * The [TestCentricity **Mobile** gem](https://rubygems.org/gems/testcentricity_mobile) only supports testing of native iOS and Android mobile apps
+* The [TestCentricity **Apps** gem](https://rubygems.org/gems/testcentricity_apps) only supports testing of MacOS desktop apps and native iOS and Android mobile apps
 * The [TestCentricity **Web** gem](https://rubygems.org/gems/testcentricity_web) only supports testing of web interfaces via desktop and mobile web browsers
 * The TestCentricity gem supports testing of native mobile apps and/or web interfaces via desktop and mobile web browsers.
 
-| Tested platforms                                   | TestCentricity Mobile | TestCentricity Web | TestCentricity |
-|----------------------------------------------------|-----------------------|--------------------|----------------|
-| Native mobile iOS and/or Android apps only         | Yes                   | No                 | No             |
-| Desktop/mobile web browsers only                   | No                    | Yes                | No             |
-| Native mobile apps and desktop/mobile web browsers | No                    | No                 | Yes            |
+| Tested platforms                                   | TestCentricity Mobile | TestCentricity Apps | TestCentricity Web | TestCentricity |
+|----------------------------------------------------|-----------------------|---------------------|--------------------|----------------|
+| Native mobile iOS and/or Android apps only         | Yes                   | Yes                 | No                 | No             |
+| MacOS desktop apps                                 | No                    | Yes                 | No                 | No             |
+| Desktop/mobile web browsers only                   | No                    | No                  | Yes                | No             |
+| Native mobile apps and desktop/mobile web browsers | No                    | No                  | No                 | Yes            |
 
 
 ## Installation
@@ -474,11 +484,20 @@ Single `AppUIElement` declarations have the following format:
     elementType :elementName, { locator_strategy: locator_identifier }
 
 * The `elementName` is the unique name that you will use to refer to the UI element and is specified as a `Symbol`.
-* The `locator_strategy` specifies the [selector strategy](https://appium.io/docs/en/commands/element/find-elements/index.html#selector-strategies) 
-that Appium will use to find the `AppUIElement`. Valid selectors are `accessibility_id:`, `id:`, `name:`, `class:`, `xpath:`, 
-`predicate:` (iOS only), `class_chain:` (iOS only), and `css:` (WebViews in hybrid apps only).
+* The `locator_strategy` specifies the selector strategy that Appium will use to find the `AppUIElement`. Valid selectors are:
+  - `accessibility_id:`
+  - `id:`
+  - `name:`
+  - `class:`
+  - `xpath:`
+  - `predicate:` (iOS only)
+  - `class_chain:` (iOS only)
+  - `css:` (WebViews in hybrid apps only).
 * The `locator_identifier` is the value or attribute that uniquely and unambiguously identifies the `AppUIElement`.
 
+Refer to [this page](https://appium.github.io/appium-xcuitest-driver/5.12/locator-strategies/) for information on selector strategies for iOS.
+Refer to [this page](https://github.com/appium/appium-uiautomator2-driver?tab=readme-ov-file#element-location) for information on selector strategies for Android.
+
 Multiple `AppUIElement` declarations for a collection of elements of the same type can be performed by passing a hash table
 containing the names and locators of each individual element.
 
@@ -974,6 +993,10 @@ Refer to [this page](https://appium.io/docs/en/2.4/guides/caps/) for information
 to invoking Cucumber to run your features/scenarios on locally hosted iOS or Android simulators or physical devices. Refer
 to [**section 8.2.3 (Starting and Stopping Appium Server)**](#starting-and-stopping-appium-server) below.
 
+⚠️ If you are running locally hosted mobile tests on iOS or Android simulators or devices using version 1.x of the Appium
+server, the `APPIUM_SERVER_VERSION` environment variable must be set to `1` in order to ensure that the correct Appium server
+endpoint is used.
+
 #### Connecting to Locally Hosted iOS Simulators or Physical Devices
 
 You can run your automated tests on locally hosted iOS simulators or physically connected devices using Appium and XCode
@@ -1190,6 +1213,13 @@ starting your Cucumber test suite(s):
 
     run_appium: APPIUM_SERVER=run
 
+If you are running locally hosted mobile tests on iOS or Android simulators or devices using version 1.x of the Appium server,
+the `APPIUM_SERVER_VERSION` environment variable must be set to `1` in order to ensure that the correct Appium server endpoint
+is used. This can be set by adding the following to your `cucumber.yml` file and including `-p appium_1x` in your command line
+when starting your Cucumber test suite(s):
+
+    appium_1x: APPIUM_SERVER_VERSION=1
+
 Refer to [**section 8.4 (Using Configuration Specific Profiles in `cucumber.yml`)**](#using-configuration-specific-profiles-in-cucumber-yml) below.
 
 
@@ -1210,6 +1240,10 @@ body of an example group:
       $server.stop if Environ.driver == :appium && $server.running?
     end
 ```
+If you are running locally hosted mobile tests on iOS or Android simulators or devices using version 1.x of the Appium server,
+the `APPIUM_SERVER_VERSION` environment variable must be set to `1` in order to ensure that the correct Appium server endpoint
+is used.
+
 
 ###  Connecting to Remote Cloud Hosted iOS and Android Simulators or Physical Devices
 
@@ -1632,6 +1666,7 @@ with access to your version control system.
     # physical devices
     #==============
     run_appium: APPIUM_SERVER=run
+    appium_1x: APPIUM_SERVER_VERSION=1
 
 
     #==============
@@ -1729,6 +1764,11 @@ You can ensure that Appium Server is running by including `-p run_appium` in you
 
     cucumber -p ipad_pro_12_15_sim -p portrait -p run_appium
 
+If you are running locally hosted mobile tests using version 1.x of Appium server, you must include `-p appium_1x` in
+your command line:
+
+    cucumber -p ipad_pro_12_15_sim -p landscape -p run_appium -p appium_1x
+
 
 The following command specifies that Cucumber will run tests against a cloud hosted iPhone 13 Pro Max running iOS 15.4 on the
 BrowserStack service:

data/lib/testcentricity_mobile/app_core/appium_connect_helper.rb

@@ -214,7 +214,7 @@ module TestCentricity
     # @return [Boolean] TRUE if keyboard is shown. Return false if keyboard is hidden.
     #
     def self.keyboard_shown?
-      driver.driver.keyboard_shown?
+      @driver.execute_script('mobile: isKeyboardShown')
     end
 
     # Get the current screen orientation
@@ -390,7 +390,13 @@ module TestCentricity
 
     def self.appium_local_capabilities
       # specify endpoint url
-      @endpoint = 'http://127.0.0.1:4723/wd/hub' if @endpoint.nil?
+      if @endpoint.nil?
+        @endpoint = if ENV['APPIUM_SERVER_VERSION'] && ENV['APPIUM_SERVER_VERSION'].to_i == 1
+                      'http://127.0.0.1:4723/wd/hub'
+                    else
+                      'http://127.0.0.1:4723'
+                    end
+      end
       # define local Appium capabilities
       if @capabilities.nil?
         Environ.device_name = ENV['APP_DEVICE']
@@ -459,11 +465,7 @@ module TestCentricity
         Environ.device_name = @capabilities[:'appium:deviceName']
         Environ.device_os_version = @capabilities[:'appium:platformVersion']
         Environ.device_orientation = @capabilities[:'appium:orientation']
-        Environ.device = if @capabilities[:'appium:udid']
-                           :device
-                         else
-                           :simulator
-                         end
+        Environ.device = @capabilities[:'appium:udid'] ? :device : :simulator
         @capabilities
       end
     end

data/lib/testcentricity_mobile/app_core/screen_objects_helper.rb

@@ -125,7 +125,8 @@ module TestCentricity
                      ui_object.count
                    when :buttons
                      ui_object.buttons
-
+                   else
+                     raise "#{property} is not a valid property"
                    end
           error_msg = "Expected UI object '#{ui_object.get_name}' (#{ui_object.get_locator}) #{property} property to"
           ExceptionQueue.enqueue_comparison(ui_object, state, actual, error_msg)

data/lib/testcentricity_mobile/appium_server.rb

@@ -38,9 +38,14 @@ module TestCentricity
     # Check to see if Appium Server is running
     #
     def running?
+      endpoint = if ENV['APPIUM_SERVER_VERSION'] && ENV['APPIUM_SERVER_VERSION'].to_i == 1
+                   'http://0.0.0.0:4723/wd/hub/sessions'
+                 else
+                   'http://0.0.0.0:4723/sessions'
+                 end
       response = false
       begin
-        response = Net::HTTP.get_response(URI('http://0.0.0.0:4723/wd/hub/sessions'))
+        response = Net::HTTP.get_response(URI(endpoint))
       rescue
       end
       response && response.code_type == Net::HTTPOK

data/lib/testcentricity_mobile/version.rb

@@ -1,3 +1,3 @@
 module TestCentricityMobile
-  VERSION = '4.0.2'
+  VERSION = '4.0.4'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: testcentricity_mobile
 version: !ruby/object:Gem::Version
-  version: 4.0.2
+  version: 4.0.4
 platform: ruby
 authors:
 - A.J. Mrozinski
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-03-27 00:00:00.000000000 Z
+date: 2024-04-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 9.1.2
+        version: 9.2.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 9.1.2
+        version: 9.2.0
 - !ruby/object:Gem::Dependency
   name: parallel_tests
   requirement: !ruby/object:Gem::Requirement
@@ -128,14 +128,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 14.0.0
+        version: 15.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 14.0.0
+        version: 15.0.0
 - !ruby/object:Gem::Dependency
   name: childprocess
   requirement: !ruby/object:Gem::Requirement
@@ -212,14 +212,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 4.19.0
+        version: 4.20.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 4.19.0
+        version: 4.20.0
 - !ruby/object:Gem::Dependency
   name: test-unit
   requirement: !ruby/object:Gem::Requirement