appium_lib_core 7.1.0 → 7.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3603b3335a27a152a88df56fa4211659e190769b294c2256b30b874791549342
-  data.tar.gz: 0554b71de5f368e194ca888771b215e79f124b73d9a6c70ca4400c66876c2e0b
+  metadata.gz: 13a5734d69d20cdf77c2548a00fe5aa3a1933e7636d0961d6cedd203dcda4cdf
+  data.tar.gz: 5fd94469762b252aab7592bbb898a87910a88734ca8dc36d58ae8bb014cdae7b
 SHA512:
-  metadata.gz: 7f4c299f4838b719aa073158ba976b5f1958e3f9e40a0e3d8cf1d602d74353e06e8fc42972fa342c40197a316a6f5ee1e83c3a62c1d1159036ac46762270de6b
-  data.tar.gz: 4cab479ef7e1eb1e025f6150e6c65a10a8a2a7f29c6c99367315523f26b397d94807dc0879ca2e8de6eb222d3e1d90b1caf49b2444b72288cb435a1a106fb4a5
+  metadata.gz: 15456cb665b05358a85c60004430d712302985637caca9a43d951716846c95290fb57c8cfe0eba474018568757106e930584d963a4cada948e4234c7d4296585
+  data.tar.gz: 04ff7932530ffb43d9e8e9b13c50252c68cbc13fecacc1bc9625ca002f06fdea355fa4d37856dc9897f90226657c6b49e3764fb48ebea6808ec558ac12d1c7ad

data/CHANGELOG.md

@@ -10,6 +10,32 @@ Read `release_notes.md` for commit level details.
 
 ### Deprecations
 
+## [7.3.2] - 2023-11-08
+
+### Bug fixes
+- Fix default value fo set context
+
+## [7.3.1] - 2023-11-04
+### Enhancements
+- Bump `selenium-webdriver` max
+
+## [7.3.0] - 2023-10-17
+
+### Deprecations
+- Add deprecation marks that will be removed from Appium or this library to move to extension commands such as `mobile:`
+    - https://github.com/appium/ruby_lib_core/pull/504
+
+## [7.2.0] - 2023-10-13
+
+### Enhancements
+- Append `selenium-webdriver` `4.12` support
+
+## [7.1.1] - 2023-10-01
+
+### Deprecations
+
+- Add deprecation marks in `immediate_value` and `replace_value`
+
 ## [7.1.0] - 2023-08-15
 
 ### Enhancements

data/Rakefile

@@ -113,28 +113,7 @@ end
 
 desc('Execute RuboCop static code analysis')
 RuboCop::RakeTask.new(:rubocop) do |t|
-  t.patterns = %w(lib test script)
+  t.patterns = %w(lib test)
   t.options = %w(-D)
   t.fail_on_error = true
 end
-
-desc('print commands which Ruby client has not implemented them yet')
-namespace :commands do
-  require './script/commands'
-
-  desc('Mobile JSON protocol')
-  task :mjsonwp do |_t, _args|
-    c = Script::CommandsChecker.new
-    c.get_mjsonwp_routes
-    c.get_all_command_path './mjsonwp_routes.js'
-    c.all_diff_commands_mjsonwp.each { |key, value| puts("command: #{key}, method: #{value}") }
-  end
-
-  desc('W3C protocol')
-  task :w3c do |_t, _args|
-    c = Script::CommandsChecker.new
-    c.get_mjsonwp_routes
-    c.get_all_command_path './mjsonwp_routes.js'
-    c.all_diff_commands_w3c.each { |key, value| puts("command: #{key}, method: #{value}") }
-  end
-end

data/appium_lib_core.gemspec

@@ -22,15 +22,15 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_runtime_dependency 'selenium-webdriver', '~> 4.2', '< 4.12'
+  spec.add_runtime_dependency 'selenium-webdriver', '~> 4.2', '< 4.16'
   spec.add_runtime_dependency 'faye-websocket', '~> 0.11.0'
 
   spec.add_development_dependency 'rake', '~> 13.0'
   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.18.1'
-  spec.add_development_dependency 'rubocop', '1.56.0'
+  spec.add_development_dependency 'webmock', '~> 3.19.0'
+  spec.add_development_dependency 'rubocop', '1.57.2'
   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/auth_finger_print.rb

@@ -20,6 +20,8 @@ module Appium
           def self.add_methods
             ::Appium::Core::Device.add_endpoint_method(:finger_print) do
               def finger_print(finger_id)
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: fingerprint' extension instead"
+
                 unless (1..10).cover? finger_id.to_i
                   raise ::Appium::Core::Error::ArgumentError,
                         "finger_id should be integer between 1 to 10. Not #{finger_id}"

data/lib/appium_lib_core/android/device/network.rb

@@ -20,24 +20,32 @@ module Appium
           def self.add_methods
             ::Appium::Core::Device.add_endpoint_method(:get_network_connection) do
               def get_network_connection
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: getConnectivity' extension instead"
+
                 execute :get_network_connection
               end
             end
 
             ::Appium::Core::Device.add_endpoint_method(:toggle_wifi) do
               def toggle_wifi
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: setConnectivity' extension instead"
+
                 execute :toggle_wifi
               end
             end
 
             ::Appium::Core::Device.add_endpoint_method(:toggle_data) do
               def toggle_data
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: setConnectivity' extension instead"
+
                 execute :toggle_data
               end
             end
 
             ::Appium::Core::Device.add_endpoint_method(:set_network_connection) do
               def set_network_connection(mode)
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: setConnectivity' extension instead"
+
                 # same as ::Selenium::WebDriver::DriverExtensions::HasNetworkConnection
                 # But this method accept number
                 connection_type = { airplane_mode: 1, wifi: 2, data: 4, all: 6, none: 0 }
@@ -49,6 +57,8 @@ module Appium
 
             ::Appium::Core::Device.add_endpoint_method(:toggle_airplane_mode) do
               def toggle_airplane_mode
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: setConnectivity' extension instead"
+
                 execute :toggle_airplane_mode
               end
               alias_method :toggle_flight_mode, :toggle_airplane_mode

data/lib/appium_lib_core/android/device/performance.rb

@@ -20,12 +20,15 @@ module Appium
           def self.add_methods
             ::Appium::Core::Device.add_endpoint_method(:get_performance_data_types) do
               def get_performance_data_types
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: getPerformanceDataTypes' extension instead"
                 execute :get_performance_data_types
               end
             end
 
             ::Appium::Core::Device.add_endpoint_method(:get_performance_data) do
               def get_performance_data(package_name:, data_type:, data_read_timeout: 1000)
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: getPerformanceData' extension instead"
+
                 execute(:get_performance_data, {},
                         packageName: package_name, dataType: data_type, dataReadTimeout: data_read_timeout)
               end

data/lib/appium_lib_core/android/device/screen.rb

@@ -20,6 +20,8 @@ module Appium
           def self.add_methods
             ::Appium::Core::Device.add_endpoint_method(:get_display_density) do
               def get_display_density
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: getDisplayDensity' extension instead"
+
                 execute :get_display_density
               end
             end

data/lib/appium_lib_core/android/device.rb

@@ -27,6 +27,7 @@ module Appium
 
         # rubocop:disable Layout/LineLength
 
+        # @deprecated Use 'mobile: openNotifications' extension instead.
         # @!method open_notifications
         #   Open Android notifications
         #
@@ -35,6 +36,7 @@ module Appium
         #   @driver.open_notifications
         #
 
+        # @deprecated Use 'mobile: getCurrentActivity' extension instead.
         # @!method current_activity
         # Get current activity name
         # @return [String] An activity name
@@ -44,6 +46,7 @@ module Appium
         #   @driver.current_activity # '.ApiDemos'
         #
 
+        # @deprecated Use 'mobile: getCurrentPackage' extension instead.
         # @!method current_package
         # Get current package name
         # @return [String] A package name
@@ -53,6 +56,7 @@ module Appium
         #   @driver.current_package # 'com.example.android.apis'
         #
 
+        # @deprecated Use 'mobile: getSystemBars' extension instead.
         # @!method get_system_bars
         # Get system bar's information
         # @return [String]
@@ -63,6 +67,7 @@ module Appium
         #   @driver.system_bars
         #
 
+        # @deprecated Use 'mobile: getDisplayDensity' extension instead.
         # @!method get_display_density
         # Get connected device's density.
         # @return [Integer] The size of density
@@ -72,6 +77,7 @@ module Appium
         #   @driver.get_display_density # 320
         #
 
+        # @deprecated Use 'mobile: getConnectivity' extension instead.
         # @!method get_network_connection
         #   Get the device network connection current status
         #   See set_network_connection method for return value
@@ -86,6 +92,7 @@ module Appium
         #   @driver.get_network_connection  #=> 6
         #
 
+        # @deprecated Use 'mobile: getConnectivity' extension instead.
         # @!method toggle_wifi
         #   Switch the state of the wifi service only for Android
         #
@@ -96,6 +103,7 @@ module Appium
         #   @driver.toggle_wifi
         #
 
+        # @deprecated Use 'mobile: getConnectivity' extension instead.
         # @!method toggle_data
         #   Switch the state of data service only for Android, and the device should be rooted
         #
@@ -106,6 +114,7 @@ module Appium
         #   @driver.toggle_data
         #
 
+        # @deprecated Use 'mobile: getConnectivity' extension instead.
         # @!method location
         # Get the location of the device.
         #
@@ -143,6 +152,7 @@ module Appium
         #   driver.set_location 10, 10, 0
         #
 
+        # @deprecated Use 'mobile: toggleGps' extension instead.
         # @!method toggle_location_services
         #   Switch the state of the location service
         #
@@ -153,6 +163,7 @@ module Appium
         #   @driver.toggle_location_services
         #
 
+        # @deprecated Use 'mobile: getConnectivity' extension instead.
         # @!method toggle_airplane_mode
         # Toggle flight mode on or off
         #
@@ -161,6 +172,7 @@ module Appium
         #   @driver.toggle_airplane_mode
         #
 
+        # @deprecated Use 'mobile: hideKeyboard' extension instead.
         # @!method hide_keyboard(close_key = nil, strategy = nil)
         # Hide the onscreen keyboard
         # @param [String] close_key The name of the key which closes the keyboard.
@@ -176,12 +188,14 @@ 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.
         #
@@ -206,6 +220,7 @@ module Appium
         #     app_activity: '.accessibility.AccessibilityNodeProviderActivity'
         #
 
+        # @deprecated Use 'mobile: setConnectivity' extension instead.
         # @!method set_network_connection(mode)
         # Set the device network connection mode
         # Same as +#network_connection_type+ in selenium-webdriver.
@@ -228,6 +243,7 @@ module Appium
         #   @driver.network_connection_type = :airplane_mode # As selenium-webdriver
         #
 
+        # @deprecated Use 'mobile: getPerformanceDataTypes' extension instead.
         # @!method get_performance_data_types
         #   Get the information type of the system state which is supported to read such as
         #   cpu, memory, network, battery via adb commands.
@@ -238,6 +254,7 @@ module Appium
         #   @driver.get_performance_data_types #=> ["cpuinfo", "batteryinfo", "networkinfo", "memoryinfo"]
         #
 
+        # @deprecated Use 'mobile: getPerformanceData' extension instead.
         # @!method get_performance_data(package_name:, data_type:, data_read_timeout: 1000)
         #   Get the resource usage information of the application.
         #   https://github.com/appium/appium-base-driver/blob/be29aec2318316d12b5c3295e924a5ba8f09b0fb/lib/mjsonwp/routes.js#L303
@@ -317,6 +334,7 @@ module Appium
         #   @driver.set_clipboard(content: 'happy testing') #=> {"protocol"=>"W3C"}
         #
 
+        # @deprecated Use 'mobile: fingerprint' extension instead.
         # @!method finger_print(finger_id)
         #     Authenticate users by using their finger print scans on supported emulators.
         #
@@ -356,42 +374,56 @@ module Appium
 
             ::Appium::Core::Device.add_endpoint_method(:open_notifications) do
               def open_notifications
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: openNotifications' extension instead"
+
                 execute :open_notifications
               end
             end
 
             ::Appium::Core::Device.add_endpoint_method(:current_activity) do
               def current_activity
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: getCurrentActivity' extension instead"
+
                 execute :current_activity
               end
             end
 
             ::Appium::Core::Device.add_endpoint_method(:current_package) do
               def current_package
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: getCurrentPackage' extension instead"
+
                 execute :current_package
               end
             end
 
             ::Appium::Core::Device.add_endpoint_method(:get_system_bars) do
               def get_system_bars
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: getSystemBars' extension instead"
+
                 execute :get_system_bars
               end
             end
             # as alias to get_system_bars
             ::Appium::Core::Device.add_endpoint_method(:system_bars) do
               def system_bars
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: getSystemBars' extension instead"
+
                 execute :get_system_bars
               end
             end
 
             ::Appium::Core::Device.add_endpoint_method(:toggle_location_services) do
               def toggle_location_services
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: toggleGps' extension instead"
+
                 execute :toggle_location_services
               end
             end
 
             ::Appium::Core::Device.add_endpoint_method(:start_activity) do
               def start_activity(opts)
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: startActivity' extension instead"
+
                 raise 'opts must be a hash' unless opts.is_a? Hash
 
                 option = {}
@@ -429,6 +461,8 @@ module Appium
             # Android, Override included method in bridge
             ::Appium::Core::Device.add_endpoint_method(:hide_keyboard) do
               def hide_keyboard(close_key = nil, strategy = nil)
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: hideKeyboard' extension instead"
+
                 option = {}
 
                 option[:key] = close_key if close_key
@@ -441,6 +475,8 @@ module Appium
             # Android, Override included method in bridge
             ::Appium::Core::Device.add_endpoint_method(:background_app) do
               def background_app(duration = 0)
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: backgroundApp' extension instead"
+
                 execute :background_app, {}, seconds: duration
               end
             end
@@ -448,6 +484,7 @@ module Appium
             # 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

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

@@ -224,6 +224,7 @@ module Appium
           )
         end
 
+        # @deprecated Use 'mobile: lock' extension instead.
         # Lock the device
         # @return [String]
         #
@@ -234,9 +235,11 @@ module Appium
         #                   #   Block other commands during locking the device.
         #
         def lock(duration = nil)
+          ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: lock' extension instead"
           @bridge.lock(duration)
         end
 
+        # @deprecated Use 'mobile: isLocked' extension instead.
         # Check current device status is weather locked or not
         #
         # @example
@@ -245,10 +248,12 @@ module Appium
         #   @driver.locked?
         #
         def locked?
+          ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: isLocked' extension instead"
           @bridge.device_locked?
         end
         alias device_locked? locked?
 
+        # @deprecated Use 'mobile: unlock' extension instead.
         # Unlock the device
         #
         # @example
@@ -256,9 +261,11 @@ module Appium
         #   @driver.unlock
         #
         def unlock
+          ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: unlock' extension instead"
           @bridge.unlock
         end
 
+        # @deprecated Use 'mobile: hideKeyboard' extension instead.
         # Hide the onscreen keyboard
         # @param [String] close_key The name of the key which closes the keyboard.
         #   Defaults to 'Done' for iOS(except for XCUITest).
@@ -273,9 +280,11 @@ module Appium
         #   @driver.hide_keyboard(nil, :tapOutside) # Close a keyboard with tapping out side of keyboard
         #
         def hide_keyboard(close_key = nil, strategy = nil)
+          ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: hideKeyboard' extension instead"
           @bridge.hide_keyboard close_key, strategy
         end
 
+        # @deprecated Use 'mobile: isKeyboardShown' extension instead.
         # Get whether keyboard is displayed or not.
         # @return [Boolean] Return true if keyboard is shown. Return false if keyboard is hidden.
         #
@@ -284,6 +293,7 @@ module Appium
         #   @driver.keyboard_shown?   # true
         #
         def keyboard_shown?
+          ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: isKeyboardShown' extension instead"
           @bridge.is_keyboard_shown
         end
         alias is_keyboard_shown keyboard_shown?
@@ -327,6 +337,7 @@ module Appium
         end
         alias update_settings settings=
 
+        # @deprecated Use 'mobile: shell' extension instead.
         # Returns an instance of DeviceIME
         #
         # @return [Appium::Core::Base::Driver::DeviceIME]
@@ -340,9 +351,11 @@ module Appium
         #   @driver.ime.deactivate #=> Deactivate current IME engine
         #
         def ime
+          ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: shell' extension instead"
           @ime ||= DeviceIME.new(@bridge)
         end
 
+        # @deprecated Use 'mobile: shell' extension instead.
         # Android only. Make an engine that is available active.
         #
         # @param [String] ime_name The IME owning the activity [required]
@@ -356,6 +369,7 @@ module Appium
           ime.activate(ime_name)
         end
 
+        # @deprecated Use 'mobile: shell' extension instead.
         # Android only. List all available input engines on the machine.
         #
         # @example
@@ -367,6 +381,7 @@ module Appium
           ime.available_engines
         end
 
+        # @deprecated Use 'mobile: shell' extension instead.
         # Android only. Get the name of the active IME engine.
         #
         # @example
@@ -378,6 +393,7 @@ module Appium
           ime.active_engine
         end
 
+        # @deprecated Use 'mobile: shell' extension instead.
         # @!method ime_activated
         #   Android only. Indicates whether IME input is active at the moment (not if it is available).
         #
@@ -392,6 +408,7 @@ module Appium
           ime.activated?
         end
 
+        # @deprecated Use 'mobile: shell' extension instead.
         # Android only. De-activates the currently-active IME engine.
         #
         # @example
@@ -455,7 +472,7 @@ module Appium
         #   @driver.set_context "NATIVE_APP"
         #   @driver.context = "NATIVE_APP"
         #
-        def context=(context = null)
+        def context=(context = nil)
           @bridge.set_context(context)
         end
         alias set_context context=
@@ -477,6 +494,7 @@ module Appium
         #   @driver.push_file "/sdcard/Pictures", file # Push a file binary to /sdcard/Pictures path in Android
         #
         def push_file(path, filedata)
+          # TODO: use 'mobile: pushFile' internally
           @bridge.push_file(path, filedata)
         end
 
@@ -505,6 +523,7 @@ module Appium
         #   File.open('proper_filename', 'wb') { |f| f<< decoded_file }
         #
         def pull_file(path)
+          # TODO: use 'mobile: pullFile' internally
           @bridge.pull_file(path)
         end
 
@@ -530,9 +549,11 @@ module Appium
         #   File.open('proper_filename', 'wb') { |f| f<< decoded_file }
         #
         def pull_folder(path)
+          # TODO: use 'mobile: pullFolder' internally
           @bridge.pull_folder(path)
         end
 
+        # @deprecated Use 'mobile: pressKey' extension instead.
         # Press keycode on the device.
         # http://developer.android.com/reference/android/view/KeyEvent.html
         # @param [Integer] key The key to press. The values which have +KEYCODE_+ prefix in http://developer.android.com/reference/android/view/KeyEvent.html
@@ -552,9 +573,11 @@ module Appium
         #   @driver.press_keycode 66, metastate: [1], flags: [32]
         #
         def press_keycode(key, metastate: [], flags: [])
+          ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: pressKey' extension instead"
           @bridge.press_keycode(key, metastate: metastate, flags: flags)
         end
 
+        # @deprecated Use 'mobile: pressKey' extension instead.
         # Long press keycode on the device.
         # http://developer.android.com/reference/android/view/KeyEvent.html
         # @param [Integer] key The key to long press. The values which have +KEYCODE_+ prefix in http://developer.android.com/reference/android/view/KeyEvent.html
@@ -574,10 +597,11 @@ module Appium
         #   @driver.long_press_keycode 66, metastate: [1], flags: [32, 8192]
         #
         def long_press_keycode(key, metastate: [], flags: [])
+          ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: pressKey' extension instead"
           @bridge.long_press_keycode(key, metastate: metastate, flags: flags)
         end
 
-        # @deprecated Except for Windows
+        # @deprecated Will be removed, or use 'windows: launchApp' extension instead for Windows.
         # Start the simulator and application configured with desired capabilities
         #
         # @example
@@ -588,7 +612,7 @@ module Appium
           @bridge.launch_app
         end
 
-        # @deprecated Except for Windows
+        # @deprecated Will be removed, or use 'windows: closeApp' extension instead for Windows.
         # Close an app on device
         #
         # @example
@@ -614,6 +638,7 @@ module Appium
           @bridge.reset
         end
 
+        # @deprecated Use 'mobile: getAppStrings' extension instead.
         # Return the hash of all localization strings.
         # @return [Hash]
         #
@@ -622,9 +647,11 @@ module Appium
         #   @driver.app_strings #=> "TransitionsTitle"=>"Transitions", "WebTitle"=>"Web"
         #
         def app_strings(language = nil)
+          ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: getAppStrings' extension instead"
           @bridge.app_strings(language)
         end
 
+        # @deprecated Use 'mobile: backgroundApp' extension instead.
         # Backgrounds the app for a set number of seconds.
         # This is a blocking application
         # @param [Integer] duration How many seconds to background the app for.
@@ -667,6 +694,7 @@ module Appium
         #   @driver.install_app("/path/to/test.ipa", timeoutMs: 20000)
         #
         def install_app(path, **options)
+          # TODO: use mobile command in the background?
           options = options.transform_keys { |key| key.to_s.gsub(/_./) { |v| v[1].upcase } } unless options.nil?
           @bridge.install_app(path, options)
         end
@@ -687,6 +715,7 @@ module Appium
         #   @driver.remove_app("io.appium.bundle", keep_data: false, timeout, 10000)
         #
         def remove_app(app_id, keep_data: nil, timeout: nil)
+          # TODO: use mobile command in the background?
           @bridge.remove_app(app_id, keep_data: keep_data, timeout: timeout)
         end
 
@@ -698,6 +727,7 @@ module Appium
         #   @driver.app_installed?("io.appium.bundle")
         #
         def app_installed?(app_id)
+          # TODO: use mobile command in the background?
           @bridge.app_installed?(app_id)
         end
 
@@ -709,6 +739,7 @@ module Appium
         #   @driver.activate_app("io.appium.bundle") #=> {}
         #
         def activate_app(app_id)
+          # TODO: use mobile command in the background?
           @bridge.activate_app(app_id)
         end
 
@@ -725,6 +756,7 @@ module Appium
         #   @driver.terminate_app("io.appium.bundle", timeout: 500)
         #
         def terminate_app(app_id, timeout: nil)
+          # TODO: use mobile command in the background?
           @bridge.terminate_app(app_id, timeout: timeout)
         end
 
@@ -748,6 +780,7 @@ module Appium
         #      @driver.query_app_state("io.appium.bundle") #=> :not_running
         #
         def app_state(app_id)
+          # TODO: use mobile command in the background?
           @bridge.app_state(app_id)
         end
         alias query_app_state app_state
@@ -787,6 +820,7 @@ module Appium
           @bridge.stop_and_save_recording_screen(file_path)
         end
 
+        # @deprecated Use 'mobile: shake' extension instead.
         # Cause the device to shake
         #
         # @example
@@ -794,9 +828,11 @@ module Appium
         #   @driver.shake
         #
         def shake
+          ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: shake' extension instead"
           @bridge.shake
         end
 
+        # @deprecated Use 'mobile: getDeviceTime' extension instead.
         # Get the time on the device
         #
         # @param [String] format The set of format specifiers. Read https://momentjs.com/docs/ to get
@@ -810,6 +846,7 @@ module Appium
         #   @driver.device_time "YYYY-MM-DD" #=> "2018-06-12"
         #
         def device_time(format = nil)
+          ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: getDeviceTime' extension instead"
           @bridge.device_time(format)
         end
 

data/lib/appium_lib_core/common/command.rb

@@ -192,6 +192,7 @@ module Appium
         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'],
 

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

@@ -42,7 +42,7 @@ module Appium
             execute(:available_contexts, {}) || []
           end
 
-          def set_context(context = null)
+          def set_context(context = nil)
             execute :set_context, {}, name: context
           end
         end # module ImeActions

data/lib/appium_lib_core/element.rb

@@ -64,6 +64,7 @@ module Appium
       # Alias for type
       alias type send_keys
 
+      # @deprecated Use element send_keys instead.
       # Set the value to element directly
       #
       # @example
@@ -71,9 +72,13 @@ module Appium
       #   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
@@ -81,6 +86,10 @@ module Appium
       #   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
 

data/lib/appium_lib_core/ios/xcuitest/device.rb

@@ -25,6 +25,7 @@ module Appium
 
           # rubocop:disable Layout/LineLength
 
+          # @deprecated Use 'mobile: hideKeyboard' extension instead.
           # @!method hide_keyboard(close_key = nil, strategy = nil)
           # Hide the onscreen keyboard
           # @param [String] close_key The name of the key which closes the keyboard.
@@ -38,6 +39,7 @@ module Appium
           #  @driver.hide_keyboard('Finished') # Close a keyboard with the 'Finished' button
           #
 
+          # @deprecated Use 'mobile: backgroundApp' extension instead.
           # @!method background_app(duration = 0)
           # Backgrounds the app for a set number of seconds.
           # This is a blocking application.

data/lib/appium_lib_core/version.rb

@@ -14,7 +14,7 @@
 
 module Appium
   module Core
-    VERSION = '7.1.0' unless defined? ::Appium::Core::VERSION
-    DATE    = '2023-08-15' unless defined? ::Appium::Core::DATE
+    VERSION = '7.3.2' unless defined? ::Appium::Core::VERSION
+    DATE    = '2023-11-08' unless defined? ::Appium::Core::DATE
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appium_lib_core
 version: !ruby/object:Gem::Version
-  version: 7.1.0
+  version: 7.3.2
 platform: ruby
 authors:
 - Kazuaki MATSUO
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-08-16 00:00:00.000000000 Z
+date: 2023-11-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
@@ -19,7 +19,7 @@ dependencies:
         version: '4.2'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '4.12'
+        version: '4.16'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '4.2'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '4.12'
+        version: '4.16'
 - !ruby/object:Gem::Dependency
   name: faye-websocket
   requirement: !ruby/object:Gem::Requirement
@@ -106,28 +106,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.18.1
+        version: 3.19.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.18.1
+        version: 3.19.0
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.56.0
+        version: 1.57.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.56.0
+        version: 1.57.2
 - !ruby/object:Gem::Dependency
   name: appium_thor
   requirement: !ruby/object:Gem::Requirement