appium_lib_core 7.5.0 → 8.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9cc9e5ee62dde8f47acf2e9e80be9517fa8382822f7a1e8eca0a4d7941528e14
-  data.tar.gz: aa51e0206f1c65ca3fc102c787eb7b72dfd4062d9d53d8f2b012447a82429d1f
+  metadata.gz: e0dede67687fe20659b7d6835475a0d5f3afec17cacdfe524e85fe969acf5065
+  data.tar.gz: da99daf2ab73305fdae7ac88114bf07db61612806d5d0ad35184c14bd3ee2932
 SHA512:
-  metadata.gz: 25506af2d4db7550c57c7395e2cad73ea65f64110023463661361b805f9c60b1f3b7ada6a39d61b3abd388562a8b4b3153c0fc521dfc89b6ab1f26c6bb7adbf0
-  data.tar.gz: 63f058a65da7a31fb717742aad9eea29aa6444565031a1da222474b4b3d926e5b05c4611461f9783b5f5244e79bd3474b203054d0760466ef7518f324cccdda8
+  metadata.gz: 89ceab3e96728f645bca3e76aa749679da6061af73d4b5ad46c03975f0e4bc4818a8602f5f391d808083883d4ad1e4075167fee3b877adb69a1081d390a66afe
+  data.tar.gz: 4701430819ac1d48552d30fa81096e264e27ce370820526b9cd4511001b7077c782b6aa708a540e5a4de5670827241cd0c29ada6b3821512403239b20115384d

data/CHANGELOG.md

@@ -10,6 +10,22 @@ Read `release_notes.md` for commit level details.
 
 ### Deprecations
 
+## [8.0.0] - 2024-03-08
+
+### Deprecations
+- Removed deprecated methods
+    - `launch_app`, `close_app` and `reset`
+        - Please use `activate_app`, `terminate_app`, or launch/activate/terminate commands by `mobile:` command
+    - `TouchActions`, `MultiActions`
+        - Please refer to W3C WebDriver actions
+        - https://www.rubydoc.info/gems/appium_lib_core/Appium/Core/Base/Bridge#action-instance_method
+    - `immediate_value` and `replace_value`
+    - `end_coverage`
+    - `sessions` and `session_capabilities` since they are not W3C WebDriver spec and already removed from the dependent selenium clients.
+        - To get events info, please use `driver.logs.events` instead
+    - `switch_to_default_context`
+        - Please set proper context instead
+
 ## [7.5.0] - 2024-02-21
 - Remove upper limitation in `selenium-webdriver`
     - Users can control the version in their Gemfile

data/appium_lib_core.gemspec

@@ -29,8 +29,8 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'yard', '~> 0.9.11'
   spec.add_development_dependency 'minitest', '~> 5.0'
   spec.add_development_dependency 'minitest-reporters', '~> 1.1'
-  spec.add_development_dependency 'webmock', '~> 3.22.0'
-  spec.add_development_dependency 'rubocop', '1.60.2'
+  spec.add_development_dependency 'webmock', '~> 3.23.0'
+  spec.add_development_dependency 'rubocop', '1.62.0'
   spec.add_development_dependency 'appium_thor', '~> 1.0'
   spec.add_development_dependency 'parallel_tests'
   spec.add_development_dependency 'simplecov'

data/lib/appium_lib_core/android/device.rb

@@ -188,13 +188,6 @@ module Appium
         #  @driver.hide_keyboard(nil, :tapOutside) # Close a keyboard with tapping out side of keyboard
         #
 
-        # @deprecated The method no longer exists. This method will be removed.
-        # @!method end_coverage(path, intent)
-        # Android only;  Ends the test coverage and writes the results to the given path on device.
-        # @param [String] path Path on the device to write too.
-        # @param [String] intent Intent to broadcast when ending coverage.
-        #
-
         # @deprecated Use 'mobile: startActivity' extension instead.
         # @!method start_activity(opts)
         # Android only. Start a new activity within the current app or launch a new app and start the target activity.
@@ -481,14 +474,6 @@ module Appium
               end
             end
 
-            # TODO: TEST ME
-            ::Appium::Core::Device.add_endpoint_method(:end_coverage) do
-              def end_coverage(path, intent)
-                ::Appium::Logger.warn '[DEPRECATION] The method no longer exists. This method will be removed.'
-                execute :end_coverage, {}, path: path, intent: intent
-              end
-            end
-
             ::Appium::Core::Device.add_endpoint_method(:execute_cdp) do
               # SeleniumWebdriver could already define this method
               return if method_defined? :execute_cdp

data/lib/appium_lib_core/common/base/bridge.rb

@@ -21,7 +21,6 @@ module Appium
         include Device::ImeActions
         include Device::Setting
         include Device::Context
-        include Device::Value
         include Device::FileManagement
         include Device::KeyEvent
         include Device::ImageComparison
@@ -29,7 +28,6 @@ module Appium
         include Device::AppState
         include Device::ScreenRecord::Command
         include Device::Device
-        include Device::TouchActions
         include Device::ExecuteDriver
         include Device::Orientation
 
@@ -170,11 +168,6 @@ module Appium
           @available_commands[command]
         end
 
-        # Returns all available sessions on the Appium server instance
-        def sessions
-          execute :get_all_sessions
-        end
-
         def status
           execute :status
         end
@@ -207,11 +200,6 @@ module Appium
           execute :get_timeouts
         end
 
-        # Port from MJSONWP
-        def session_capabilities
-          ::Appium::Core::Base::Capabilities.json_create execute(:get_capabilities)
-        end
-
         # For Appium
         # override
         def element_displayed?(element)

data/lib/appium_lib_core/common/base/driver.rb

@@ -434,18 +434,6 @@ module Appium
           block_given? ? @bridge.within_context(context, &block) : @bridge.within_context(context)
         end
 
-        # @deprecated Use set context with proper context name instead.
-        # Change to the default context. This is equivalent to +set_context nil+.
-        #
-        # @example
-        #
-        #   @driver.switch_to_default_context
-        #
-        def switch_to_default_context
-          ::Appium::Logger.warn '[DEPRECATION] Please set proper context instead of calling this method.'
-          @bridge.switch_to_default_context
-        end
-
         # @return [String] The context currently being used.
         #
         # @example
@@ -603,43 +591,6 @@ module Appium
           @bridge.long_press_keycode(key, metastate: metastate, flags: flags)
         end
 
-        # @deprecated Will be removed, or use 'windows: launchApp' extension instead for Windows.
-        # Start the simulator and application configured with desired capabilities
-        #
-        # @example
-        #
-        #   @driver.launch_app
-        #
-        def launch_app
-          @bridge.launch_app
-        end
-
-        # @deprecated Will be removed, or use 'windows: closeApp' extension instead for Windows.
-        # Close an app on device
-        #
-        # @example
-        #
-        #   @driver.close_app
-        #
-        def close_app
-          @bridge.close_app
-        end
-
-        # @deprecated
-        # Reset the device, relaunching the application.
-        #
-        # @example
-        #
-        #   @driver.reset
-        #
-        def reset
-          ::Appium::Logger.warn(
-            '[DEPRECATION] reset is deprecated. Please use terminate_app and activate_app, ' \
-            'or quit and create a new session instead.'
-          )
-          @bridge.reset
-        end
-
         # @deprecated Use 'mobile: getAppStrings' extension instead.
         # Return the hash of all localization strings.
         # @return [Hash]
@@ -852,15 +803,6 @@ module Appium
           @bridge.device_time(format)
         end
 
-        # touch actions
-        def touch_actions(actions)
-          @bridge.touch_actions(actions)
-        end
-
-        def multi_touch(actions)
-          @bridge.multi_touch(actions)
-        end
-
         #
         # Send multiple W3C action chains to server. Use +@driver.action+ for single action chain.
         #
@@ -959,101 +901,6 @@ module Appium
           @bridge.get_timeouts
         end
 
-        # Retrieve the capabilities of the specified session.
-        # It's almost same as +@driver.capabilities+ but you can get more details.
-        #
-        # @return [Selenium::WebDriver::Remote::Capabilities, Selenium::WebDriver::Remote::Capabilities]
-        #
-        # @example
-        #   @driver.session_capabilities
-        #
-        #   #=> uiautomator2
-        #   # <Selenium::WebDriver::Remote::Capabilities:0x007fa38dae1360
-        #   # @capabilities=
-        #   #     {:browser_name=>nil,
-        #   #      :browser_version=>nil,
-        #   #      :platform_name=>"android",
-        #   #      :page_load_strategy=>nil,
-        #   #      :remote_session_id=>nil,
-        #   #      :accessibility_checks=>nil,
-        #   #      :profile=>nil,
-        #   #      :rotatable=>nil,
-        #   #      :device=>nil,
-        #   #      "platform"=>"LINUX",
-        #   #      "webStorageEnabled"=>false,
-        #   #      "takesScreenshot"=>true,
-        #   #      "javascriptEnabled"=>true,
-        #   #      "databaseEnabled"=>false,
-        #   #      "networkConnectionEnabled"=>true,
-        #   #      "locationContextEnabled"=>false,
-        #   #      "warnings"=>{},
-        #   #      "desired"=>
-        #   #          {"platformName"=>"android",
-        #   #           "automationName"=>"uiautomator2",
-        #   #           "app"=>"/path/to/app/api.apk.zip",
-        #   #           "platformVersion"=>"8.1.0",
-        #   #           "deviceName"=>"Android Emulator",
-        #   #           "appPackage"=>"io.appium.android.apis",
-        #   #           "appActivity"=>"io.appium.android.apis.ApiDemos",
-        #   #           "someCapability"=>"some_capability",
-        #   #      "automationName"=>"uiautomator2",
-        #   #      "app"=>"/path/to/app/api.apk.zip",
-        #   #      "platformVersion"=>"8.1.0",
-        #   #      "deviceName"=>"emulator-5554",
-        #   #      "appPackage"=>"io.appium.android.apis",
-        #   #      "appActivity"=>"io.appium.android.apis.ApiDemos",
-        #   #      "someCapability"=>"some_capability",
-        #   #      "deviceUDID"=>"emulator-5554",
-        #   #      "deviceScreenSize"=>"1080x1920",
-        #   #      "deviceScreenDensity"=>420,
-        #   #      "deviceModel"=>"Android SDK built for x86",
-        #   #      "deviceManufacturer"=>"Google",
-        #   #      "pixelRatio"=>2.625,
-        #   #      "statBarHeight"=>63,
-        #   #      "viewportRect"=>{"left"=>0, "top"=>63, "width"=>1080, "height"=>1731}}>
-        #   #
-        #   #=> XCUITest
-        #   # <Selenium::WebDriver::Remote::Capabilities:0x007fb15dc01370
-        #   # @capabilities=
-        #   #     {:browser_name=>"UICatalog",
-        #   #      :browser_version=>nil,
-        #   #      :platform_name=>"ios",
-        #   #      :page_load_strategy=>nil,
-        #   #      :remote_session_id=>nil,
-        #   #      :accessibility_checks=>nil,
-        #   #      :profile=>nil,
-        #   #      :rotatable=>nil,
-        #   #      :device=>"iphone",
-        #   #      "udid"=>"DED4DBAD-8E5E-4AD6-BDC4-E75CF9AD84D8",
-        #   #      "automationName"=>"XCUITest",
-        #   #      "app"=>"/path/to/app/UICatalog.app",
-        #   #      "platformVersion"=>"11.4",
-        #   #      "deviceName"=>"iPhone Simulator",
-        #   #      "useNewWDA"=>true,
-        #   #      "useJSONSource"=>true,
-        #   #      "someCapability"=>"some_capability",
-        #   #      "sdkVersion"=>"11.4",
-        #   #      "CFBundleIdentifier"=>"com.example.apple-samplecode.UICatalog",
-        #   #      "pixelRatio"=>2,
-        #   #      "statBarHeight"=>23.4375,
-        #   #      "viewportRect"=>{"left"=>0, "top"=>47, "width"=>750, "height"=>1287}}>
-        #
-        def session_capabilities
-          @bridge.session_capabilities
-        end
-
-        # Returns available sessions on the Appium server
-        #
-        # @return [[Hash]]
-        #
-        # @example
-        #
-        #   @driver.sessions #=> [{'id' => 'c363add8-a7ca-4455-b9e3-9ac4d69e95b3', 'capabilities' => { capabilities as Hash }}]
-        #
-        def sessions
-          @bridge.sessions
-        end
-
         # Image Comparison
         def match_images_features(first_image:,
                                   second_image:,

data/lib/appium_lib_core/common/base/search_context.rb

@@ -29,12 +29,7 @@ module Appium
           view_matcher:         '-android viewmatcher', # Available in Espresso
           # iOS
           predicate:            '-ios predicate string',
-          class_chain:          '-ios class chain',
-          # Windows with windows prefix
-          # @deprecated
-          windows_uiautomation: '-windows uiautomation',
-          # Tizen with Tizen prefix
-          tizen_uiautomation:   '-tizen uiautomation'
+          class_chain:          '-ios class chain'
         )
 
         # rubocop:disable Layout/LineLength
@@ -121,13 +116,6 @@ module Appium
         #     e = find_element :class_chain, "**/XCUIElementTypeStaticText[$name == 'Buttons'$]"
         #     e.tag_name #=> "XCUIElementTypeStaticText"
         #
-        #     # For Windows
-        #     # @deprecated
-        #     @driver.find_elements :windows_uiautomation, '....'
-        #
-        #     # For Tizen
-        #     @driver.find_elements :tizen_uiautomation, '....'
-        #
         # rubocop:enable Layout/LineLength
         def find_element(*args)
           how, what = extract_args(args)
@@ -159,12 +147,6 @@ module Appium
         private
 
         def _set_by_from_finders(how)
-          if how == :windows_uiautomation
-            ::Appium::Logger.warn(
-              '[DEPRECATION] :windows_uiautomation is deprecated. Please use other locators.'
-            )
-          end
-
           by = FINDERS[how.to_sym]
           unless by
             raise ::Appium::Core::Error::ArgumentError,

data/lib/appium_lib_core/common/base.rb

@@ -17,7 +17,6 @@ require_relative 'device/keyboard'
 require_relative 'device/ime_actions'
 require_relative 'device/setting'
 require_relative 'device/context'
-require_relative 'device/value'
 require_relative 'device/file_management'
 require_relative 'device/keyevent'
 require_relative 'device/image_comparison'
@@ -27,7 +26,6 @@ require_relative 'device/screen_record'
 require_relative 'device/battery_status'
 require_relative 'device/clipboard_content_type'
 require_relative 'device/device'
-require_relative 'device/touch_actions'
 require_relative 'device/execute_driver'
 require_relative 'device/orientation'
 

data/lib/appium_lib_core/common/command.rb

@@ -157,10 +157,6 @@ module Appium
 
         get_timeouts: [:get, 'session/:session_id/timeouts'], # https://w3c.github.io/webdriver/#get-timeouts
 
-        # Add OSS commands to W3C commands. We can remove them if we would like to remove them from W3C module.
-        ### Session capability
-        get_capabilities: [:get, 'session/:session_id'],
-
         ### rotatable
         get_screen_orientation: [:get, 'session/:session_id/orientation'],
         set_screen_orientation: [:post, 'session/:session_id/orientation'],
@@ -184,21 +180,10 @@ module Appium
         ###
 
         # common
-        get_all_sessions: [:get, 'sessions'],
         available_contexts: [:get, 'session/:session_id/contexts'],
         set_context: [:post, 'session/:session_id/context'],
         current_context: [:get, 'session/:session_id/context'],
 
-        touch_actions: [:post, 'session/:session_id/touch/perform'],
-        multi_touch: [:post, 'session/:session_id/touch/multi/perform'],
-
-        # TODO: remove
-        set_immediate_value: [:post, 'session/:session_id/appium/element/:id/value'],
-        replace_value: [:post, 'session/:session_id/appium/element/:id/replace_value'],
-
-        launch_app: [:post, 'session/:session_id/appium/app/launch'],
-        close_app: [:post, 'session/:session_id/appium/app/close'],
-        reset: [:post, 'session/:session_id/appium/app/reset'],
         background_app: [:post, 'session/:session_id/appium/app/background'],
         app_strings: [:post, 'session/:session_id/appium/app/strings'],
 
@@ -244,7 +229,6 @@ module Appium
         toggle_wifi: [:post, 'session/:session_id/appium/device/toggle_wifi'],
         toggle_data: [:post, 'session/:session_id/appium/device/toggle_data'],
         toggle_location_services: [:post, 'session/:session_id/appium/device/toggle_location_services'],
-        end_coverage: [:post, 'session/:session_id/appium/app/end_test_coverage'],
         get_performance_data_types: [:post, 'session/:session_id/appium/performanceData/types'],
         get_performance_data: [:post, 'session/:session_id/appium/getPerformanceData'],
         get_network_connection: [:get, 'session/:session_id/network_connection'], # defined also in OSS

data/lib/appium_lib_core/common/device/app_management.rb

@@ -17,24 +17,6 @@ module Appium
     class Base
       module Device
         module AppManagement
-          def launch_app
-            ::Appium::Logger.warn(
-              '[DEPRECATION] launch_app is deprecated. Please use activate_app instead.'
-            )
-            execute :launch_app
-          end
-
-          def close_app
-            ::Appium::Logger.warn(
-              '[DEPRECATION] close_app is deprecated. Please use terminate_app instead.'
-            )
-            execute :close_app
-          end
-
-          def reset
-            execute :reset
-          end
-
           def app_strings(language = nil)
             opts = language ? { language: language } : {}
             execute :app_strings, {}, opts

data/lib/appium_lib_core/common/device/context.rb

@@ -29,10 +29,6 @@ module Appium
             end
           end
 
-          def switch_to_default_context
-            set_context nil
-          end
-
           def current_context
             execute :current_context
           end

data/lib/appium_lib_core/common/log.rb

@@ -44,8 +44,7 @@ module Appium
 
       # @since Appium 1.16.0
       #
-      # Logs a custom event. The event is available via {::Appium::Core::Events#get} or
-      # <code>@driver.session_capabilities['events']</code> with <code>eventTimings</code> capabilities.
+      # Logs a custom event. The event is available via {::Appium::Core::Events#get}.
       #
       # @param [String] vendor The vendor prefix for the event
       # @param [String] event The name of event
@@ -54,7 +53,6 @@ module Appium
       # @example
       #
       #   @driver.logs.event vendor: 'appium', event: 'funEvent'
-      #   @driver.session_capabilities['events'] #=> {...., 'appium:funEvent' => 1572957315}
       #
       #   @driver.logs.event = { vendor: 'appium', event: 'anotherEvent' }
       #   @driver.logs.events #=> {...., 'appium:funEvent' => [1572957315, 1572960305],

data/lib/appium_lib_core/device.rb

@@ -29,17 +29,15 @@ module Appium
             :hide_keyboard, :is_keyboard_shown,
             :ime_activate, :ime_available_engines, :ime_active_engine, :ime_activated, :ime_deactivate,
             :get_settings, :update_settings,
-            :within_context, :switch_to_default_context, :current_context, :available_contexts, :set_context,
-            :set_immediate_value, :replace_value,
+            :within_context, :current_context, :available_contexts, :set_context,
             :push_file, :pull_file, :pull_folder,
             :keyevent, :press_keycode, :long_press_keycode,
             :match_images_features, :find_image_occurrence, :get_images_similarity, :compare_images,
-            :launch_app, :close_app, :reset, :app_strings, :background_app,
+            :app_strings, :background_app,
             :install_app, :remove_app, :app_installed?, :activate_app, :terminate_app,
             :app_state,
             :stop_recording_screen, :stop_and_save_recording_screen,
             :shake, :device_time,
-            :touch_actions, :multi_touch,
             :execute_driver, :execute_cdp
           ].each(&method(:delegate_from_appium_driver))
         end

data/lib/appium_lib_core/element.rb

@@ -64,35 +64,6 @@ module Appium
       # Alias for type
       alias type send_keys
 
-      # @deprecated Use element send_keys instead.
-      # Set the value to element directly
-      #
-      # @example
-      #
-      #   element.immediate_value 'hello'
-      #
-      def immediate_value(*value)
-        ::Appium::Logger.warn(
-          '[DEPRECATION] element.immediate_value is deprecated. Please use element.send_keys instead.'
-        )
-        @bridge.set_immediate_value @id, *value
-      end
-
-      # @deprecated Use element send_keys or 'mobile: replaceElementValue' for UIAutomator2 instead.
-      # Replace the value to element directly
-      #
-      # @example
-      #
-      #   element.replace_value 'hello'
-      #
-      def replace_value(*value)
-        ::Appium::Logger.warn(
-          '[DEPRECATION] element.replace_value is deprecated. Please use element.send_keys instead, ' \
-          'or "mobile: replaceElementValue" for UIAutomator2.'
-        )
-        @bridge.replace_value @id, *value
-      end
-
       # For use with location_rel.
       #
       # @return [::Selenium::WebDriver::Point] the relative x, y in a struct. ex: { x: 0.50, y: 0.20 }

data/lib/appium_lib_core/version.rb

@@ -14,7 +14,7 @@
 
 module Appium
   module Core
-    VERSION = '7.5.0' unless defined? ::Appium::Core::VERSION
-    DATE    = '2024-02-21' unless defined? ::Appium::Core::DATE
+    VERSION = '8.0.0' unless defined? ::Appium::Core::VERSION
+    DATE    = '2024-03-08' unless defined? ::Appium::Core::DATE
   end
 end

data/lib/appium_lib_core/windows/device.rb

@@ -13,7 +13,6 @@
 # limitations under the License.
 
 require_relative 'device/screen'
-require_relative 'device/app_management'
 
 module Appium
   module Core
@@ -79,7 +78,6 @@ module Appium
         class << self
           def extended(_mod)
             Screen.add_methods
-            AppManagement.add_methods
           end
         end # class << self
       end # module Device

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appium_lib_core
 version: !ruby/object:Gem::Version
-  version: 7.5.0
+  version: 8.0.0
 platform: ruby
 authors:
 - Kazuaki MATSUO
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-02-22 00:00:00.000000000 Z
+date: 2024-03-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
@@ -100,28 +100,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.22.0
+        version: 3.23.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.22.0
+        version: 3.23.0
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.60.2
+        version: 1.62.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.60.2
+        version: 1.62.0
 - !ruby/object:Gem::Dependency
   name: appium_thor
   requirement: !ruby/object:Gem::Requirement
@@ -228,13 +228,9 @@ files:
 - lib/appium_lib_core/common/device/orientation.rb
 - lib/appium_lib_core/common/device/screen_record.rb
 - lib/appium_lib_core/common/device/setting.rb
-- lib/appium_lib_core/common/device/touch_actions.rb
-- lib/appium_lib_core/common/device/value.rb
 - lib/appium_lib_core/common/error.rb
 - lib/appium_lib_core/common/log.rb
 - lib/appium_lib_core/common/logger.rb
-- lib/appium_lib_core/common/touch_action/multi_touch.rb
-- lib/appium_lib_core/common/touch_action/touch_actions.rb
 - lib/appium_lib_core/common/wait.rb
 - lib/appium_lib_core/common/wait/timer.rb
 - lib/appium_lib_core/common/ws/websocket.rb
@@ -258,7 +254,6 @@ files:
 - lib/appium_lib_core/windows.rb
 - lib/appium_lib_core/windows/bridge.rb
 - lib/appium_lib_core/windows/device.rb
-- lib/appium_lib_core/windows/device/app_management.rb
 - lib/appium_lib_core/windows/device/screen.rb
 homepage: https://github.com/appium/ruby_lib_core/
 licenses:

data/lib/appium_lib_core/common/device/touch_actions.rb

@@ -1,37 +0,0 @@
-# frozen_string_literal: true
-
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-require_relative '../touch_action/touch_actions'
-require_relative '../touch_action/multi_touch'
-
-module Appium
-  module Core
-    class Base
-      module Device
-        module TouchActions
-          # @deprecated Use W3C actions instead
-          def touch_actions(actions)
-            actions = { actions: [actions].flatten }
-            execute :touch_actions, {}, actions
-          end
-
-          # @deprecated Use W3C actions instead
-          def multi_touch(actions)
-            execute :multi_touch, {}, actions: actions
-          end
-        end # module TouchActions
-      end # module Device
-    end # class Base
-  end # module Core
-end # module Appium

data/lib/appium_lib_core/common/device/value.rb

@@ -1,50 +0,0 @@
-# frozen_string_literal: true
-
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-module Appium
-  module Core
-    class Base
-      module Device
-        module Value
-          def set_immediate_value(element_id, *value)
-            execute :set_immediate_value, { id: element_id }, generate_value_and_text(value)
-          end
-
-          def replace_value(element_id, *value)
-            execute :replace_value, { id: element_id }, generate_value_and_text(value)
-          end
-
-          private
-
-          def generate_value_and_text(*value)
-            keys = ::Selenium::WebDriver::Keys.encode(*value)
-
-            if @file_detector
-              local_files = keys.first.split("\n").map { |key| @file_detector.call(Array(key)) }.compact
-              if local_files.any?
-                keys = local_files.map { |local_file| upload(local_file) }
-                keys = Array(keys.join("\n"))
-              end
-            end
-
-            # Keep .split(//) for backward compatibility for now
-            text = keys.join
-
-            { text: text }
-          end
-        end # module Value
-      end # module Device
-    end # class Base
-  end # module Core
-end # module Appium

data/lib/appium_lib_core/common/touch_action/multi_touch.rb

@@ -1,75 +0,0 @@
-# frozen_string_literal: true
-
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-module Appium
-  module Core
-    #
-    # @deprecated Use W3C actions instead
-    #
-    # MultiTouch actions allow for multiple touches to happen at the same time,
-    # for instance, to simulate multiple finger swipes.
-    #
-    # Create a series of touch actions by themselves (without a +prepare()+), then
-    # add to a new MultiTouch action.  When ready, call +prepare()+ and all
-    # actions will be executed simultaneously.
-    #
-    # Consider to use W3C spec touch action like the followings.
-    # https://www.selenium.dev/selenium/docs/api/rb/Selenium/WebDriver/PointerActions.html
-    # https://github.com/appium/ruby_lib_core/blob/master/test/functional/android/webdriver/w3c_actions_test.rb
-    # https://github.com/appium/ruby_lib_core/blob/master/test/functional/ios/webdriver/w3c_actions_test.rb
-    #
-    # About W3C actions
-    # https://www.youtube.com/watch?v=oAJ7jwMNFVU
-    # https://appiumpro.com/editions/30-ios-specific-touch-action-methods
-    # https://appiumpro.com/editions/29-automating-complex-gestures-with-the-w3c-actions-api
-    #
-    # Functional test code in ruby_lib_core repository also helps.
-    #
-    # @example
-    #
-    #   @driver = Appium::Core.for(opts).start_driver
-    #   action_1 = Appium::Core::TouchAction.new(@driver).press(x: 45, y: 100).wait(600).release
-    #   action_2 = Appium::Core::TouchAction.new(@driver).tap(element: el, x: 50, y:5, count: 3)
-    #
-    #   multi_touch_action = MultiTouch.new(@driver)
-    #   multi_touch_action.add action_1
-    #   multi_touch_action.add action_2
-    #   multi_touch_action.perform
-    #
-    class MultiTouch
-      attr_reader :driver
-
-      def initialize(driver)
-        ::Appium::Logger.warn(
-          '[DEPRECATION] Appium::Core::MultiTouch is deprecated in W3C spec. Use W3C actions instead'
-        )
-
-        @actions = []
-        @driver = driver
-      end
-
-      # Add a touch_action to be performed
-      # @param chain (TouchAction) The action to add to the chain
-      def add(chain)
-        @actions << chain.actions
-      end
-
-      # Ask Appium to perform the actions
-      def perform
-        @driver.multi_touch @actions
-        @actions.clear
-      end
-    end # class MultiTouch
-  end # module Core
-end # module Appium

data/lib/appium_lib_core/common/touch_action/touch_actions.rb

@@ -1,217 +0,0 @@
-# frozen_string_literal: true
-
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-module Appium
-  module Core
-    #
-    # @deprecated Use W3C actions instead
-    #
-    # Perform a series of gestures, one after another.  Gestures are chained
-    # together and only performed when +perform()+ is called. Default is conducted by global driver.
-    #
-    # Each method returns the object itself, so calls can be chained.
-    #
-    # Consider to use W3C spec touch action like the followings.
-    # https://www.selenium.dev/selenium/docs/api/rb/Selenium/WebDriver/PointerActions.html
-    # https://github.com/appium/ruby_lib_core/blob/master/test/functional/android/webdriver/w3c_actions_test.rb
-    # https://github.com/appium/ruby_lib_core/blob/master/test/functional/ios/webdriver/w3c_actions_test.rb
-    #
-    # About W3C actions
-    # https://www.youtube.com/watch?v=oAJ7jwMNFVU
-    # https://appiumpro.com/editions/30-ios-specific-touch-action-methods
-    # https://appiumpro.com/editions/29-automating-complex-gestures-with-the-w3c-actions-api
-    #
-    # Functional test code in ruby_lib_core repository also helps.
-    #
-    # @example
-    #
-    #   @driver = Appium::Core.for(opts).start_driver
-    #   action = Appium::Core::TouchAction.new(@driver).press(x: 45, y: 100).wait(600).release
-    #   action.perform
-    #   action = Appium::Core::TouchAction.new(@driver).swipe(....)
-    #   action.perform
-    #
-    class TouchAction
-      ACTIONS = %i(move_to long_press double_tap two_finger_tap press release tap wait perform).freeze
-      COMPLEX_ACTIONS = %i(swipe).freeze
-
-      attr_reader :actions, :driver
-
-      def initialize(driver)
-        ::Appium::Logger.warn(
-          '[DEPRECATION] Appium::Core::TouchAction is deprecated in W3C spec. Use W3C actions instead'
-        )
-
-        @actions = []
-        @driver = driver
-      end
-
-      # Move to the given co-ordinates.
-      #
-      # +move_to+'s +x+ and +y+ have two case. One is working as coordinate, the other is working as offset.
-      #
-      # @param opts [Hash] Options
-      # @option opts [integer] :x x co-ordinate to move to if element isn't set. Works as an absolute if x is set with Element.
-      # @option opts [integer] :y y co-ordinate to move to if element isn't set. Works as an absolute if y is set with Element.
-      # @option opts [WebDriver::Element] Element to scope this move within.
-      def move_to(opts)
-        opts = args_with_ele_ref(opts)
-        chain_method(:moveTo, opts)
-      end
-
-      # Press down for a specific duration.
-      # Alternatively, you can use +press(...).wait(...).release()+ instead of +long_press+ if duration doesn't work well.
-      # https://github.com/appium/ruby_lib/issues/231#issuecomment-269895512
-      # e.g. Appium::Core::TouchAction.new.press(x: 280, y: 530).wait(2000).release.perform
-      #
-      # @param opts [Hash] Options
-      # @option opts [WebDriver::Element] element the element to press.
-      # @option opts [integer] x X co-ordinate to press on.
-      # @option opts [integer] y Y co-ordinate to press on.
-      # @option opts [integer] duration Number of milliseconds to press.
-      def long_press(opts)
-        args = opts.select { |k, _v| %i(element x y duration).include? k }
-        args = args_with_ele_ref(args)
-        chain_method(:longPress, args) # longPress is what the appium server expects
-      end
-
-      # Press a finger onto the screen.  Finger will stay down until you call +release+.
-      #
-      # @param opts [Hash] Options
-      # @option opts [WebDriver::Element] :element (Optional) Element to press within.
-      # @option opts [integer] :x x co-ordinate to press on
-      # @option opts [integer] :y y co-ordinate to press on
-      # @option opts [Float] pressure (iOS Only) press as force touch.
-      #                                          See the description of +force+ property on Apple's UITouch class
-      #                                          (https://developer.apple.com/documentation/uikit/uitouch?language=objc)
-      #                                          for more details on possible value ranges.
-      def press(opts)
-        args = opts.select { |k, _v| %i(element x y).include? k }
-        args = args_with_ele_ref(args)
-        args[:pressure] = opts.delete(:pressure) unless opts[:pressure].nil?
-        chain_method(:press, args)
-      end
-
-      # Remove a finger from the screen.
-      #
-      # @param opts [Hash] Options
-      # @option opts [WebDriver::Element] :element (Optional) Element to release from.
-      # @option opts [integer] :x x co-ordinate to release from
-      # @option opts [integer] :y y co-ordinate to release from
-      def release(opts = nil)
-        args = args_with_ele_ref(opts) if opts
-        chain_method(:release, args)
-      end
-
-      # Touch a point on the screen.
-      # Alternatively, you can use +press(...).release.perform+ instead of +tap(...).perform+.
-      #
-      # @param opts [Hash] Options
-      # @option opts [WebDriver::Element] :element (Optional) Element to restrict scope too.
-      # @option opts [integer] :x x co-ordinate to tap
-      # @option opts [integer] :y y co-ordinate to tap
-      # @option opts [integer] :fingers how many fingers to tap with (Default 1)
-      def tap(opts)
-        opts[:count] = opts.delete(:fingers) if opts[:fingers]
-        opts[:count] ||= 1
-        args = args_with_ele_ref opts
-        chain_method(:tap, args)
-      end
-
-      # Double tap an element on the screen
-      #
-      # @param opts [Hash] Options
-      # @option opts [WebDriver::Element] :element (Optional) Element to restrict scope too.
-      # @option opts [integer] :x x co-ordinate to tap
-      # @option opts [integer] :y y co-ordinate to tap
-
-      def double_tap(opts)
-        args = opts.select { |k, _v| %i(element x y).include? k }
-        args = args_with_ele_ref(args)
-        chain_method(:doubleTap, args) # doubleTap is what the appium server expects
-      end
-
-      # Two finger tap an element on the screen
-      #
-      # @param opts [Hash] Options
-      # @option opts [WebDriver::Element] :element (Optional) Element to restrict scope too.
-      # @option opts [integer] :x x co-ordinate to tap
-      # @option opts [integer] :y y co-ordinate to tap
-      def two_finger_tap(opts)
-        args = opts.select { |k, _v| %i(element x y).include? k }
-        args = args_with_ele_ref(args)
-        chain_method(:twoFingerTap, args) # twoFingerTap is what the appium server expects
-      end
-
-      # Pause for a number of milliseconds before the next action
-      # @param milliseconds [integer] Number of milliseconds to pause for
-      def wait(milliseconds)
-        args = { ms: milliseconds }
-        chain_method(:wait, args)
-      end
-
-      # Convenience method to perform a swipe.
-      #
-      # @param opts [Hash] Options
-      # @option opts [int] :start_x Where to start swiping, on the x axis.  Default 0.
-      # @option opts [int] :start_y Where to start swiping, on the y axis.  Default 0.
-      # @option opts [int] :end_x Move to the end, on the x axis.  Default 0.
-      # @option opts [int] :end_y Move to the end, on the y axis.  Default 0.
-      # @option opts [int] :duration How long the actual swipe takes to complete in milliseconds. Default 200.
-      def swipe(opts)
-        start_x = opts.fetch :start_x, 0
-        start_y = opts.fetch :start_y, 0
-        end_x   = opts.fetch :end_x, 0
-        end_y   = opts.fetch :end_y, 0
-
-        duration = opts.fetch :duration, 200
-
-        press x: start_x, y: start_y
-        wait(duration) if duration
-        move_to x: end_x, y: end_y
-
-        release
-
-        self
-      end
-
-      # Ask the driver to perform all actions in this action chain.
-      def perform
-        @driver.touch_actions @actions
-        @actions.clear
-        self
-      end
-
-      # Does nothing, currently.
-      def cancel
-        @actions << { action: cancel }
-        @driver.touch_actions @actions
-        self
-      end
-
-      private
-
-      def chain_method(method, args = nil)
-        action = args ? { action: method, options: args } : { action: method }
-        @actions << action
-        self
-      end
-
-      def args_with_ele_ref(args)
-        args[:element] = args[:element].id if args.key? :element
-        args
-      end
-    end # class TouchAction
-  end # module Core
-end # module Appium

data/lib/appium_lib_core/windows/device/app_management.rb

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-module Appium
-  module Core
-    module Windows
-      module Device
-        module AppManagement
-          # override
-          def self.add_methods
-            ::Appium::Core::Device.add_endpoint_method(:launch_app) do
-              def launch_app
-                execute :launch_app
-              end
-            end
-
-            ::Appium::Core::Device.add_endpoint_method(:close_app) do
-              def close_app
-                execute :close_app
-              end
-            end
-          end
-        end # module AppManagement
-      end # module Device
-    end # module Windows
-  end # module Core
-end # module Appium