appium_lib_core 13.0.1 → 13.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e72aea90c7dc28d4e664e683d7c2a75f38fff4c10945acd3bc7019d4ea5d547a
-  data.tar.gz: e775ba44b2d04d71587131566e9ed3ced7f40ae93f491b1e1d0b2a59bfdc9587
+  metadata.gz: 2c774c32f9e6c96847e98eb5609b780bb1ffe4a262e029ed5a22f986d04cb1d8
+  data.tar.gz: 02fe4c862fb8c5fd0fc73a9d70b99594fb36c5cb4464d6f0548dbf31f08279aa
 SHA512:
-  metadata.gz: 5ee56dc3eddc33bb872d204b285e940848bc7ac703880350c0406227d7e98ed4f60c9a23496c56a3c3756d107f25faed9e6878989d8499bd0760565000550ae7
-  data.tar.gz: 4bcf89e8bbf02bf876a70fffe7a9d6f1619cc088bf5c6823343a330cda3ce6a67c7c78a180d1bc0b2db1c50a16fbadf13107c12d480e3f210f919d71b0e1eec8
+  metadata.gz: 0031a4963b30ea1b9c5c4caf1525c4a1847f0dfcac3508a8b860b552534afe96755db9ede3d36deb9260e4191286f3e5169a8674e8af6a756f16295a1c076d22
+  data.tar.gz: d39fbf9f08b5e4da39610fa0bd42215c857ff657693174c824695ded74c670ca8f5988c3eacec468cf1b9a713b56a0d50541bb68fcaa9160cbb1a70d98e71d2c

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 # Changelog
 All notable changes to this project will be documented in this file.
-Read `release_notes.md` for commit level details.
+New entries are generated by Release Please. Historical commit-level details through 13.1.0 remain in `release_notes.md`.
+
+## [13.1.1](https://github.com/appium/ruby_lib_core/compare/v13.1.0...v13.1.1) (2026-09-13)
+
+
+### Bug Fixes
+
+* isolate platform commands and correct session regressions ([#703](https://github.com/appium/ruby_lib_core/issues/703)) ([03d2661](https://github.com/appium/ruby_lib_core/commit/03d2661c821d8195c909aadfabd0ab5d86335b9d))
+
+## [13.1.0] - 2026-07-13
+- Compatible with selenium 4.46
 
 ## [13.0.1] - 2026-06-07
 - Update the `rbs_collection.lock.yaml`
@@ -384,8 +394,6 @@ Read `release_notes.md` for commit level details.
         - [test/functional/common_w3c_actions.rb](test/functional/common_w3c_actions.rb)
         - https://www.selenium.dev/documentation/support_packages/mouse_and_keyboard_actions_in_detail/
         - 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
 - `launch_app`, `close_app` and `reset`. Please read [issues#15807](https://github.com/appium/appium/issues/15807) for more details.
     - `activate_app` or a new session request can be alternatives of `launch_app`
     - `terminate_app` or close the session request can be alternatives of `close_app`

data/Gemfile

@@ -3,12 +3,11 @@ source 'https://rubygems.org'
 # Specify your gem's dependencies in appium_lib_core.gemspec
 gemspec
 
-gem 'appium_thor', '~> 2.0'
 gem 'minitest', '~> 5.0'
 gem 'minitest-reporters', '~> 1.1'
 gem 'parallel_tests'
 gem 'rake', '~> 13.0'
-gem 'rubocop', '1.87.0'
+gem 'rubocop', '1.90.0'
 gem 'simplecov'
 gem 'steep', '~> 1.10.0'
 gem 'webmock', '~> 3.26.0'

data/README.md

@@ -114,21 +114,10 @@ $ IGNORE_VERSION_SKIP=true CI=true bundle exec rake test:func:android
     opts = {
       capabilities: { # Append capabilities
         platformName: 'ios',
-        platformVersion: '15.8.3',
+        platformVersion: '26.0',
         deviceName: 'iPhone 17',
         # app: '/path/to/MyiOS.app',  # Without 'app' capability, an appium session starts with the home screen
-        automationName: 'XCUITest',
-        # "appium:bundleId":"com.apple.mobilesafari",
-        # "usePreinstalledWDA": true,
-        useNewWDA: false,
-        browserName: 'Safari',
-        # "webDriverAgentUrl": "http://192.168.4.47:8100",
-        "udid": "00008020-000E5CDA0A23002E",
-        'xcodeOrgId': '47PCFA586Q',
-        'xcodeSigningId': 'iPhone Developer',
-        'updatedWDABundleId': 'com.kazucocoa.wda',
-        allowProvisioningDeviceRegistration: true,
-        # 'appium:skipLogCapture': true
+        automationName: 'XCUITest'
       },
       appium_lib: {
         wait: 30
@@ -198,10 +187,10 @@ class CustomListener < ::Selenium::WebDriver::Support::AbstractEventListener
 end
 capabilities: {
   platformName: :ios,
-  platformVersion: '11.0',
-  deviceName: 'iPhone Simulator',
+  platformVersion: '26',
+  deviceName: 'iPhone',
   automationName: 'XCUITest',
-  app: '/path/to/MyiOS.app'
+  browser: 'safari'
 }
 appium_lib: {
   listener: CustomListener.new
@@ -215,12 +204,10 @@ appium_lib: {
     - https://android.googlesource.com/platform/development/+/master/samples/ApiDemos
 
 # Release
-Use [appium_thor](https://github.com/appium/appium_thor) to release this gem.
+Releases are prepared automatically by Release Please. Review and merge the release
+PR; GitHub Actions then validates and publishes the gem using RubyGems Trusted
+Publishing. See [RELEASING.md](RELEASING.md) for setup, version overrides, and recovery.
 
-```bash
-$ thor bump # bumpy,
-$ thor release
-```
 
 # Contribution
 1. Fork it ( https://github.com/appium/ruby_lib_core/fork )

data/Rakefile

@@ -116,5 +116,5 @@ end
 
 desc('Run Steep type check')
 task :steep do
-  system 'steep check --severity-level=error'
+  sh 'steep check --severity-level=error'
 end

data/appium_lib_core.gemspec

@@ -15,7 +15,7 @@ Gem::Specification.new do |spec|
   spec.homepage      = 'https://github.com/appium/ruby_lib_core/'
   spec.license       = 'Apache-2.0'
   spec.files         = `git ls-files -z`.split("\x0").reject do |f|
-    f.match(%r{(^(doc|docs|test|spec|features|ci-jobs|.github|script)/|release_notes.md|.gitignore|azure-pipelines.yml|.rubocop.yml)})
+    f.match(%r{(^(doc|docs|test|spec|features|ci-jobs|.github|script)/|release_notes.md|RELEASING.md|release-please-config.json|.release-please-manifest.json|.gitignore|azure-pipelines.yml|.rubocop.yml)})
   end
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }

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

@@ -17,8 +17,8 @@ module Appium
     module Android
       module Device
         module Authentication
-          def self.add_methods
-            ::Appium::Core::Device.add_endpoint_method(:finger_print) do
+          def self.add_methods(target)
+            ::Appium::Core::Device.add_endpoint_method(:finger_print, bridge: target.bridge_extensions) do
               def finger_print(finger_id)
                 unless (1..10).cover? finger_id.to_i
                   raise ::Appium::Core::Error::ArgumentError,

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

@@ -19,8 +19,8 @@ module Appium
     module Android
       module Device
         module Clipboard
-          def self.add_methods
-            ::Appium::Core::Device.add_endpoint_method(:get_clipboard) do
+          def self.add_methods(target)
+            ::Appium::Core::Device.add_endpoint_method(:get_clipboard, bridge: target.bridge_extensions) do
               def get_clipboard(content_type: :plaintext)
                 unless ::Appium::Core::Base::Device::Clipboard::CONTENT_TYPE.member?(content_type)
                   raise ::Appium::Core::Error::ArgumentError,
@@ -34,7 +34,7 @@ module Appium
               end
             end
 
-            ::Appium::Core::Device.add_endpoint_method(:set_clipboard) do
+            ::Appium::Core::Device.add_endpoint_method(:set_clipboard, bridge: target.bridge_extensions) do
               def set_clipboard(content:, content_type: :plaintext, label: nil)
                 unless ::Appium::Core::Base::Device::Clipboard::CONTENT_TYPE.member?(content_type)
                   raise ::Appium::Core::Error::ArgumentError,

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

@@ -112,14 +112,14 @@ module Appium
           ## self.emulator_commands
           ####
 
-          def self.add_methods
-            ::Appium::Core::Device.add_endpoint_method(:send_sms) do
+          def self.add_methods(target)
+            ::Appium::Core::Device.add_endpoint_method(:send_sms, bridge: target.bridge_extensions) do
               def send_sms(phone_number:, message:)
                 execute_script 'mobile:sendSms', { phoneNumber: phone_number, message: message }
               end
             end
 
-            ::Appium::Core::Device.add_endpoint_method(:gsm_call) do
+            ::Appium::Core::Device.add_endpoint_method(:gsm_call, bridge: target.bridge_extensions) do
               def gsm_call(phone_number:, action:)
                 raise ::Appium::Core::Error::ArgumentError, "action: should be member of #{GSM_CALL_ACTIONS}. Not #{action}." unless GSM_CALL_ACTIONS.member? action.to_sym
 
@@ -127,7 +127,7 @@ module Appium
               end
             end
 
-            ::Appium::Core::Device.add_endpoint_method(:gsm_signal) do
+            ::Appium::Core::Device.add_endpoint_method(:gsm_signal, bridge: target.bridge_extensions) do
               def gsm_signal(signal_strength)
                 if GSM_SIGNALS[signal_strength.to_sym].nil?
                   raise ::Appium::Core::Error::ArgumentError,
@@ -138,7 +138,7 @@ module Appium
               end
             end
 
-            ::Appium::Core::Device.add_endpoint_method(:gsm_voice) do
+            ::Appium::Core::Device.add_endpoint_method(:gsm_voice, bridge: target.bridge_extensions) do
               def gsm_voice(state)
                 raise ::Appium::Core::Error::ArgumentError, "The state should be member of #{GSM_VOICE_STATES}. Not #{state}." unless GSM_VOICE_STATES.member? state.to_sym
 
@@ -146,7 +146,7 @@ module Appium
               end
             end
 
-            ::Appium::Core::Device.add_endpoint_method(:set_network_speed) do
+            ::Appium::Core::Device.add_endpoint_method(:set_network_speed, bridge: target.bridge_extensions) do
               def set_network_speed(netspeed)
                 unless NET_SPEED.member? netspeed.to_sym
                   raise ::Appium::Core::Error::ArgumentError,
@@ -157,7 +157,7 @@ module Appium
               end
             end
 
-            ::Appium::Core::Device.add_endpoint_method(:set_power_capacity) do
+            ::Appium::Core::Device.add_endpoint_method(:set_power_capacity, bridge: target.bridge_extensions) do
               def set_power_capacity(percent)
                 ::Appium::Logger.warn "The  percent should be between 0 and 100. Not #{percent}." unless (0..100).member? percent
 
@@ -165,7 +165,7 @@ module Appium
               end
             end
 
-            ::Appium::Core::Device.add_endpoint_method(:set_power_ac) do
+            ::Appium::Core::Device.add_endpoint_method(:set_power_ac, bridge: target.bridge_extensions) do
               def set_power_ac(state)
                 raise ::Appium::Core::Error::ArgumentError, "The state should be member of #{POWER_AC_STATE}. Not #{state}." unless POWER_AC_STATE.member? state.to_sym
 

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

@@ -17,14 +17,14 @@ module Appium
     module Android
       module Device
         module Performance
-          def self.add_methods
-            ::Appium::Core::Device.add_endpoint_method(:get_performance_data_types) do
+          def self.add_methods(target)
+            ::Appium::Core::Device.add_endpoint_method(:get_performance_data_types, bridge: target.bridge_extensions) do
               def get_performance_data_types
                 execute_script 'mobile:getPerformanceDataTypes', {}
               end
             end
 
-            ::Appium::Core::Device.add_endpoint_method(:get_performance_data) do
+            ::Appium::Core::Device.add_endpoint_method(:get_performance_data, bridge: target.bridge_extensions) do
               def get_performance_data(package_name:, data_type:)
                 execute_script 'mobile:getPerformanceData', { packageName: package_name, dataType: data_type }
               end

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

@@ -17,14 +17,14 @@ module Appium
     module Android
       module Device
         module Screen
-          def self.add_methods
-            ::Appium::Core::Device.add_endpoint_method(:get_display_density) do
+          def self.add_methods(target)
+            ::Appium::Core::Device.add_endpoint_method(:get_display_density, bridge: target.bridge_extensions) do
               def get_display_density
                 execute_script 'mobile:getDisplayDensity', {}
               end
             end
 
-            ::Appium::Core::Device.add_endpoint_method(:start_recording_screen) do
+            ::Appium::Core::Device.add_endpoint_method(:start_recording_screen, bridge: target.bridge_extensions) do
               def start_recording_screen(remote_path: nil, user: nil, pass: nil, method: 'PUT',
                                          file_field_name: nil, form_fields: nil, headers: nil, force_restart: nil,
                                          video_size: nil, time_limit: '180', bit_rate: nil, bug_report: nil)

data/lib/appium_lib_core/android/device.rb

@@ -243,60 +243,60 @@ module Appium
         ####
 
         class << self
-          def extended(_mod)
+          def extended(target)
             ::Appium::Core::Device.extend_webdriver_with_forwardable
 
-            ::Appium::Core::Device.add_endpoint_method(:open_notifications) do
+            ::Appium::Core::Device.add_endpoint_method(:open_notifications, bridge: target.bridge_extensions) do
               def open_notifications
                 execute_script 'mobile:openNotifications', {}
               end
             end
 
-            ::Appium::Core::Device.add_endpoint_method(:current_activity) do
+            ::Appium::Core::Device.add_endpoint_method(:current_activity, bridge: target.bridge_extensions) do
               def current_activity
                 execute_script 'mobile:getCurrentActivity', {}
               end
             end
 
-            ::Appium::Core::Device.add_endpoint_method(:current_package) do
+            ::Appium::Core::Device.add_endpoint_method(:current_package, bridge: target.bridge_extensions) do
               def current_package
                 execute_script 'mobile:getCurrentPackage', {}
               end
             end
 
-            ::Appium::Core::Device.add_endpoint_method(:get_system_bars) do
+            ::Appium::Core::Device.add_endpoint_method(:get_system_bars, bridge: target.bridge_extensions) do
               def get_system_bars
                 execute_script 'mobile:getSystemBars', {}
               end
             end
             # as alias to get_system_bars
-            ::Appium::Core::Device.add_endpoint_method(:system_bars) do
+            ::Appium::Core::Device.add_endpoint_method(:system_bars, bridge: target.bridge_extensions) do
               def system_bars
                 execute_script 'mobile:getSystemBars', {}
               end
             end
 
-            ::Appium::Core::Device.add_endpoint_method(:toggle_location_services) do
+            ::Appium::Core::Device.add_endpoint_method(:toggle_location_services, bridge: target.bridge_extensions) do
               def toggle_location_services
                 execute_script 'mobile:toggleGps', {}
               end
             end
 
             # Android, Override included method in bridge
-            ::Appium::Core::Device.add_endpoint_method(:hide_keyboard) do
+            ::Appium::Core::Device.add_endpoint_method(:hide_keyboard, bridge: target.bridge_extensions) do
               def hide_keyboard(_close_key = nil)
                 execute_script 'mobile:hideKeyboard', {}
               end
             end
 
             # Android, Override included method in bridge
-            ::Appium::Core::Device.add_endpoint_method(:background_app) do
+            ::Appium::Core::Device.add_endpoint_method(:background_app, bridge: target.bridge_extensions) do
               def background_app(duration = 0)
                 execute_script 'mobile:backgroundApp', { seconds: duration }
               end
             end
 
-            ::Appium::Core::Device.add_endpoint_method(:execute_cdp) do
+            ::Appium::Core::Device.add_endpoint_method(:execute_cdp, bridge: target.bridge_extensions) do
               # SeleniumWebdriver could already define this method
               return if method_defined? :execute_cdp
 
@@ -305,11 +305,11 @@ module Appium
               end
             end
 
-            Screen.add_methods
-            Performance.add_methods
-            Clipboard.add_methods
-            Emulator.add_methods
-            Authentication.add_methods
+            Screen.add_methods(target)
+            Performance.add_methods(target)
+            Clipboard.add_methods(target)
+            Emulator.add_methods(target)
+            Authentication.add_methods(target)
           end
         end
       end # module Device

data/lib/appium_lib_core/android/uiautomator2/device/battery.rb

@@ -18,8 +18,8 @@ module Appium
       module Uiautomator2
         module Device
           module Battery
-            def self.add_methods
-              ::Appium::Core::Device.add_endpoint_method(:battery_info) do
+            def self.add_methods(target)
+              ::Appium::Core::Device.add_endpoint_method(:battery_info, bridge: target.bridge_extensions) do
                 def battery_info
                   response = execute_script 'mobile: batteryInfo', {}
 

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

@@ -42,8 +42,8 @@ module Appium
           ####
 
           class << self
-            def extended(_mod)
-              Battery.add_methods
+            def extended(target)
+              Battery.add_methods(target)
             end
           end # class << self
         end # module Device

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

@@ -47,6 +47,17 @@ module Appium
         # No 'browserName' means the session is native appium connection
         APPIUM_NATIVE_BROWSER_NAME = 'appium'
 
+        # Selenium 4.46 moved server URL configuration from Bridge to the HTTP client.
+        def initialize(url:, http_client: nil)
+          if selenium_bridge_accepts_url?
+            super
+          else
+            http_client ||= ::Selenium::WebDriver::Remote::Http::Default.new
+            http_client.server_url = url
+            super(http_client: http_client)
+          end
+        end
+
         def browser
           @browser ||= begin
             name = @capabilities&.browser_name
@@ -137,6 +148,12 @@ module Appium
 
         private
 
+        def selenium_bridge_accepts_url?
+          ::Selenium::WebDriver::Remote::Bridge.instance_method(:initialize).parameters.any? do |_, name|
+            name == :url
+          end
+        end
+
         def camel_case(str_or_sym)
           str_or_sym.to_s.gsub(/_([a-z])/) { Regexp.last_match(1)&.upcase }
         end

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

@@ -49,8 +49,8 @@ module Appium
           original_opts = opts.dup
 
           # For ::Appium::Core::Waitable
-          @wait_timeout = opts.delete(:wait_timeout)
-          @wait_interval = opts.delete(:wait_interval)
+          @wait_timeout = opts.delete(:wait_timeout) || ::Appium::Core::Wait::DEFAULT_TIMEOUT
+          @wait_interval = opts.delete(:wait_interval) || ::Appium::Core::Wait::DEFAULT_INTERVAL
 
           # Selenium WebDriver attributes
           @devtools = nil
@@ -76,6 +76,7 @@ module Appium
         def create_bridge(**opts)
           # for a new session request
           capabilities = opts.delete(:capabilities)
+          bridge_extensions = opts.delete(:bridge_extensions)
           bridge_opts = { http_client: opts.delete(:http_client), url: opts.delete(:url) }
 
           # for attaching to an existing session
@@ -89,6 +90,7 @@ module Appium
           bridge_clzz = @has_bidi ? ::Appium::Core::Base::BiDiBridge : ::Appium::Core::Base::Bridge
           # steep:ignore:start
           bridge = bridge_clzz.new(**bridge_opts)
+          bridge.extend(bridge_extensions) if bridge_extensions
           # steep:ignore:end
 
           if session_id.nil?

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

@@ -63,14 +63,16 @@ module Appium
           #
           # @return [URI] An instance of URI updated to. Returns default +server_url+ if some of arguments are +nil+
           def update_sending_request_to(scheme:, host:, port:, path:)
-            return @server_url unless validate_url_param(scheme, host, port, path)
+            return server_url unless validate_url_param(scheme, host, port, path)
 
             # Add / if 'path' does not have it
             path = "/#{path}" unless path.start_with?('/')
             path = "#{path}/" unless path.end_with?('/')
 
+            host = "[#{host}]" if host.include?(':') && !host.start_with?('[')
+
             @http = nil
-            @server_url = URI.parse "#{scheme}://#{host}:#{port}#{path}"
+            self.server_url = URI.parse "#{scheme}://#{host}:#{port}#{path}"
           end
 
           private

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

@@ -29,7 +29,7 @@ module Appium
 
           def install_app(path, options = {}) # steep:ignore
             args = { appPath: path }
-            args[:options] = options unless options&.empty?
+            args[:options] = options unless options && options.empty?
 
             execute :install_app, {}, args
           end

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

@@ -20,11 +20,9 @@ module Appium
           def within_context(context)
             existing_context = current_context
             set_context context
-            if block_given?
-              result = yield
-              set_context existing_context
-              result
-            else
+            begin
+              yield if block_given?
+            ensure
               set_context existing_context
             end
           end

data/lib/appium_lib_core/device.rb

@@ -26,8 +26,8 @@ module Appium
 
         # @private
         # Define method in Bridges
-        def add_endpoint_method(method, &block)
-          block_given? ? create_bridge_command(method, &block) : create_bridge_command(method)
+        def add_endpoint_method(method, bridge: ::Appium::Core::Base::Bridge, &block)
+          create_bridge_command(method, bridge: bridge, &block)
 
           delegate_driver_method method
           delegate_from_appium_driver method
@@ -56,8 +56,8 @@ module Appium
           ::Appium::Core::Base::Driver.class_eval { def_delegator :@bridge, method }
         end
 
-        def create_bridge_command(method, &block)
-          ::Appium::Core::Base::Bridge.class_eval do
+        def create_bridge_command(method, bridge:, &block)
+          bridge.class_eval do
             undef_method method if method_defined? method
             block_given? ? class_eval(&block) : define_method(method) { execute method }
           end

data/lib/appium_lib_core/driver.rb

@@ -160,6 +160,10 @@ module Appium
     class Driver
       include Waitable
 
+      # @private Platform-specific methods for this driver
+      # @return [Module]
+      attr_reader :bridge_extensions
+
       # Selenium webdriver capabilities, but the value is provided capabilities basis.
       # @return [Core::Base::Capabilities]
       attr_reader :caps
@@ -388,6 +392,7 @@ module Appium
 
       # @private
       def initialize
+        @bridge_extensions = Module.new
         @delegate_target = self # for testing purpose
         @automation_name = nil # initialise before 'set_automation_name'
       end
@@ -473,6 +478,7 @@ module Appium
         begin
           @driver = ::Appium::Core::Base::Driver.new(listener: @listener,
                                                      http_client: @http_client,
+                                                     bridge_extensions: @bridge_extensions,
                                                      capabilities: @caps, # ::Appium::Core::Base::Capabilities
                                                      url: @custom_url,
                                                      wait_timeout: @wait_timeout,
@@ -531,6 +537,7 @@ module Appium
           @driver = ::Appium::Core::Base::Driver.new(http_client: @http_client,
                                                      url: @custom_url,
                                                      listener: @listener,
+                                                     bridge_extensions: @bridge_extensions,
                                                      existing_session_id: session_id,
                                                      automation_name: automation_name,
                                                      platform_name: platform_name)
@@ -693,23 +700,23 @@ module Appium
       # The path can be local, HTTP/S, Windows Share and other path like 'sauce-storage:'.
       # Use @caps[:app] without modifications if the path isn't HTTP/S or local path.
       def set_app_path
-        # FIXME: maybe `:app` should check `app` as well.
         return unless @caps
 
         app = get_app # for steep reason
-        return unless app && app.empty?
+        return if app.nil? || app.empty?
 
         uri_regex = defined?(URI::RFC2396_PARSER) ? URI::RFC2396_PARSER : URI::DEFAULT_PARSER # steep:ignore
         return if app =~ uri_regex.make_regexp
 
         # steep:ignore
         app_path = File.expand_path(app)
-        @caps['app'] = if File.exist? app_path
-                         app_path
-                       else
-                         ::Appium::Logger.warn("Use #{app} directly since #{app_path} does not exist.")
-                         app
-                       end
+        app_key = [:app, 'app', :'appium:app', 'appium:app'].find { |key| @caps[key] }
+        @caps[app_key] = if File.exist? app_path
+                           app_path
+                         else
+                           ::Appium::Logger.warn("Use #{app} directly since #{app_path} does not exist.")
+                           app
+                         end
       end
 
       # @private

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

@@ -19,8 +19,8 @@ module Appium
     module Ios
       module Device
         module Clipboard
-          def self.add_methods
-            ::Appium::Core::Device.add_endpoint_method(:get_clipboard) do
+          def self.add_methods(target)
+            ::Appium::Core::Device.add_endpoint_method(:get_clipboard, bridge: target.bridge_extensions) do
               def get_clipboard(content_type: :plaintext)
                 unless ::Appium::Core::Base::Device::Clipboard::CONTENT_TYPE.member?(content_type)
                   raise ::Appium::Core::Error::ArgumentError,
@@ -34,7 +34,7 @@ module Appium
               end
             end
 
-            ::Appium::Core::Device.add_endpoint_method(:set_clipboard) do
+            ::Appium::Core::Device.add_endpoint_method(:set_clipboard, bridge: target.bridge_extensions) do
               def set_clipboard(content:, content_type: :plaintext)
                 unless ::Appium::Core::Base::Device::Clipboard::CONTENT_TYPE.member?(content_type)
                   raise ::Appium::Core::Error::ArgumentError,

data/lib/appium_lib_core/ios/device.rb

@@ -70,22 +70,22 @@ module Appium
         ####
 
         class << self
-          def extended(_mod)
+          def extended(target)
             ::Appium::Core::Device.extend_webdriver_with_forwardable
 
-            ::Appium::Core::Device.add_endpoint_method(:touch_id) do
+            ::Appium::Core::Device.add_endpoint_method(:touch_id, bridge: target.bridge_extensions) do
               def touch_id(match = true)
                 execute_script 'mobile:sendBiometricMatch', { 'type': 'touch_id', match: match }
               end
             end
 
-            ::Appium::Core::Device.add_endpoint_method(:toggle_touch_id_enrollment) do
+            ::Appium::Core::Device.add_endpoint_method(:toggle_touch_id_enrollment, bridge: target.bridge_extensions) do
               def toggle_touch_id_enrollment(enabled = true)
                 execute_script 'mobile:enrollBiometric', { 'isEnabled': enabled }
               end
             end
 
-            Clipboard.add_methods
+            Clipboard.add_methods(target)
           end
         end
       end # module Device

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

@@ -18,8 +18,8 @@ module Appium
       module Xcuitest
         module Device
           module Battery
-            def self.add_methods
-              ::Appium::Core::Device.add_endpoint_method(:battery_info) do
+            def self.add_methods(target)
+              ::Appium::Core::Device.add_endpoint_method(:battery_info, bridge: target.bridge_extensions) do
                 def battery_info
                   response = execute_script 'mobile: batteryInfo', {}
 

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

@@ -18,8 +18,8 @@ module Appium
       module Xcuitest
         module Device
           module Performance
-            def self.add_methods
-              ::Appium::Core::Device.add_endpoint_method(:start_performance_record) do
+            def self.add_methods(target)
+              ::Appium::Core::Device.add_endpoint_method(:start_performance_record, bridge: target.bridge_extensions) do
                 def start_performance_record(timeout: 300_000, profile_name: 'Activity Monitor', pid: nil)
                   option = {}
                   option[:timeout] = timeout
@@ -30,7 +30,7 @@ module Appium
                 end
               end
 
-              ::Appium::Core::Device.add_endpoint_method(:get_performance_record) do
+              ::Appium::Core::Device.add_endpoint_method(:get_performance_record, bridge: target.bridge_extensions) do
                 def get_performance_record(save_file_path: './performance', profile_name: 'Activity Monitor',
                                            remote_path: nil, user: nil, pass: nil, method: 'PUT',
                                            file_field_name: nil, form_fields: nil, headers: nil)

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

@@ -18,8 +18,8 @@ module Appium
       module Xcuitest
         module Device
           module Screen
-            def self.add_methods
-              ::Appium::Core::Device.add_endpoint_method(:start_recording_screen) do
+            def self.add_methods(target)
+              ::Appium::Core::Device.add_endpoint_method(:start_recording_screen, bridge: target.bridge_extensions) do
                 def start_recording_screen(remote_path: nil, user: nil, pass: nil, method: 'PUT',
                                            file_field_name: nil, form_fields: nil, headers: nil, force_restart: nil,
                                            video_type: 'mjpeg', time_limit: '180', video_quality: nil,

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

@@ -170,9 +170,9 @@ module Appium
           ####
 
           class << self
-            def extended(_mod)
+            def extended(target)
               # Xcuitest, Override included method in bridge
-              ::Appium::Core::Device.add_endpoint_method(:hide_keyboard) do
+              ::Appium::Core::Device.add_endpoint_method(:hide_keyboard, bridge: target.bridge_extensions) do
                 def hide_keyboard(close_key = nil)
                   option = {}
 
@@ -183,15 +183,15 @@ module Appium
               end
 
               # Xcuitest, Override included method in bridge
-              ::Appium::Core::Device.add_endpoint_method(:background_app) do
+              ::Appium::Core::Device.add_endpoint_method(:background_app, bridge: target.bridge_extensions) do
                 def background_app(duration = 0)
                   execute_script 'mobile:backgroundApp', { seconds: duration }
                 end
               end
 
-              Performance.add_methods
-              Screen.add_methods
-              Battery.add_methods
+              Performance.add_methods(target)
+              Screen.add_methods(target)
+              Battery.add_methods(target)
             end
           end # class << self
         end # module Device

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

@@ -17,8 +17,8 @@ module Appium
     module Mac2
       module Device
         module Screen
-          def self.add_methods
-            ::Appium::Core::Device.add_endpoint_method(:start_recording_screen) do
+          def self.add_methods(target)
+            ::Appium::Core::Device.add_endpoint_method(:start_recording_screen, bridge: target.bridge_extensions) do
               def start_recording_screen(remote_path: nil, user: nil, pass: nil, method: 'PUT',
                                          file_field_name: nil, form_fields: nil, headers: nil, force_restart: nil,
                                          fps: nil, preset: nil, video_filter: nil, time_limit: nil,

data/lib/appium_lib_core/mac2/device.rb

@@ -77,8 +77,8 @@ module Appium
         ####
 
         class << self
-          def extended(_mod)
-            Screen.add_methods
+          def extended(target)
+            Screen.add_methods(target)
           end
         end # class << self
       end # module Device

data/lib/appium_lib_core/version.rb

@@ -14,7 +14,7 @@
 
 module Appium
   module Core
-    VERSION = '13.0.1' unless defined? ::Appium::Core::VERSION
-    DATE    = '2026-06-07' unless defined? ::Appium::Core::DATE
+    VERSION = '13.1.1' unless defined? ::Appium::Core::VERSION
+    DATE    = '2026-09-13' unless defined? ::Appium::Core::DATE # x-release-please-date
   end
 end

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

@@ -17,8 +17,8 @@ module Appium
     module Windows
       module Device
         module Screen
-          def self.add_methods
-            ::Appium::Core::Device.add_endpoint_method(:start_recording_screen) do
+          def self.add_methods(target)
+            ::Appium::Core::Device.add_endpoint_method(:start_recording_screen, bridge: target.bridge_extensions) do
               def start_recording_screen(force_restart: nil, time_limit: nil,
                                          fps: nil, preset: nil, video_filter: nil,
                                          capture_clicks: nil, capture_cursor: nil, audio_input: nil)

data/lib/appium_lib_core/windows/device.rb

@@ -71,8 +71,8 @@ module Appium
         ####
 
         class << self
-          def extended(_mod)
-            Screen.add_methods
+          def extended(target)
+            Screen.add_methods(target)
           end
         end # class << self
       end # module Device

data/rbs_collection.lock.yaml

@@ -74,7 +74,7 @@ gems:
   source:
     type: stdlib
 - name: ffi
-  version: 1.17.2
+  version: 1.17.4
   source:
     type: rubygems
 - name: fileutils
@@ -170,7 +170,7 @@ gems:
     remote: https://github.com/ruby/gem_rbs_collection.git
     repo_dir: gems
 - name: prism
-  version: 1.7.0
+  version: 1.9.0
   source:
     type: rubygems
 - name: rainbow
@@ -253,14 +253,6 @@ gems:
   version: '0'
   source:
     type: stdlib
-- name: thor
-  version: '1.2'
-  source:
-    type: git
-    name: ruby/gem_rbs_collection
-    revision: 3f5e8df1ce89ea06067fa42263012c968b4e583e
-    remote: https://github.com/ruby/gem_rbs_collection.git
-    repo_dir: gems
 - name: time
   version: '0'
   source:

data/sig/gems/selenium/bridge.rbs

@@ -30,7 +30,7 @@ module Selenium
 
         attr_reader capabilities: untyped
 
-        def initialize: (url: String | URI, ?http_client: untyped?) -> void
+        def initialize: (?url: untyped, ?http_client: untyped?) -> void
 
         def cancel_fedcm_dialog: -> nil
 

data/sig/lib/appium_lib_core/android/device/auth_finger_print.rbs

@@ -5,7 +5,7 @@ module Appium
         module Authentication
           include _Bridge
 
-          def self.add_methods: () -> untyped
+          def self.add_methods: (untyped target) -> untyped
         end
       end
     end

data/sig/lib/appium_lib_core/android/device/clipboard.rbs

@@ -5,7 +5,7 @@ module Appium
         module Clipboard
           include _Bridge
 
-          def self.add_methods: () -> untyped
+          def self.add_methods: (untyped target) -> untyped
         end
       end
     end

data/sig/lib/appium_lib_core/android/device/emulator.rbs

@@ -15,7 +15,7 @@ module Appium
 
           POWER_AC_STATE: ::Array[:on | :off]
 
-          def self.add_methods: () -> untyped
+          def self.add_methods: (untyped target) -> untyped
         end
       end
     end

data/sig/lib/appium_lib_core/android/device/performance.rbs

@@ -5,7 +5,7 @@ module Appium
         module Performance
           include _Bridge
 
-          def self.add_methods: () -> untyped
+          def self.add_methods: (untyped target) -> untyped
         end
       end
     end

data/sig/lib/appium_lib_core/android/device/screen.rbs

@@ -5,7 +5,7 @@ module Appium
         module Screen
           include _Bridge
 
-          def self.add_methods: () -> untyped
+          def self.add_methods: (untyped target) -> untyped
         end
       end
     end

data/sig/lib/appium_lib_core/android/uiautomator2/device/battery.rbs

@@ -6,7 +6,7 @@ module Appium
           module Battery
             include _Bridge
 
-            def self.add_methods: () -> untyped
+            def self.add_methods: (untyped target) -> untyped
           end
         end
       end

data/sig/lib/appium_lib_core/common/base/bridge.rbs

@@ -49,6 +49,8 @@ module Appium
         # No 'browserName' means the session is native appium connection
         APPIUM_NATIVE_BROWSER_NAME: "appium"
 
+        def initialize: (url: untyped, ?http_client: untyped?) -> void
+
         def browser: () -> untyped
 
         # Appium only.
@@ -103,6 +105,8 @@ module Appium
 
         private
 
+        def selenium_bridge_accepts_url?: () -> bool
+
         def camel_case: (untyped str_or_sym) -> untyped
 
         def extension_prefix?: (untyped capability_name) -> untyped

data/sig/lib/appium_lib_core/common/base/driver.rbs

@@ -2,6 +2,8 @@ module Appium
   module Core
     class Base
       class Driver < Selenium::WebDriver::Driver
+        extend Forwardable
+
         @wait_timeout: untyped
 
         @wait_interval: untyped

data/sig/lib/appium_lib_core/device.rbs

@@ -5,7 +5,7 @@ module Appium
 
       def self.extended: (untyped _mod) -> untyped
 
-      def self.add_endpoint_method: (untyped method) ?{ () -> untyped } -> untyped
+      def self.add_endpoint_method: (untyped method, ?bridge: Module) ?{ () -> untyped } -> untyped
 
       def self.extend_webdriver_with_forwardable: () -> (nil | untyped)
 
@@ -15,7 +15,7 @@ module Appium
 
       def self.delegate_driver_method: (untyped method) -> (nil | untyped)
 
-      def self.create_bridge_command: (untyped method) ?{ () -> untyped } -> untyped
+      def self.create_bridge_command: (untyped method, bridge: Module) ?{ () -> untyped } -> untyped
     end
   end
 end

data/sig/lib/appium_lib_core/driver.rbs

@@ -79,9 +79,20 @@ module Appium
       attr_reader path: String
 
       def initialize: (Hash[String | Symbol, String] capabilities) -> void
+
+      def valid?: () -> bool
+
+      private
+
+      def resolve_addresses: (String host) -> Array[String]
+
+      def ip_literal?: (String host) -> bool
+
+      def disallowed?: (String ip) -> bool
     end
 
     class Driver
+      attr_reader bridge_extensions: Module
       @delegate_target: self
 
       @automation_name: Symbol

data/sig/lib/appium_lib_core/ios/device/clipboard.rbs

@@ -5,7 +5,7 @@ module Appium
         module Clipboard
           include _Bridge
 
-          def self.add_methods: () -> untyped
+          def self.add_methods: (untyped target) -> untyped
         end
       end
     end

data/sig/lib/appium_lib_core/ios/xcuitest/device/battery.rbs

@@ -6,7 +6,7 @@ module Appium
           module Battery
             include _Bridge
 
-            def self.add_methods: () -> (Symbol | Hash[Symbol, Proc])?
+            def self.add_methods: (untyped target) -> (Symbol | Hash[Symbol, Proc])?
 
             def battery_info: () -> ::Hash[::Symbol, ::Symbol]
           end

data/sig/lib/appium_lib_core/ios/xcuitest/device/performance.rbs

@@ -6,7 +6,7 @@ module Appium
           module Performance
             include _Bridge
 
-            def self.add_methods: () -> untyped
+            def self.add_methods: (untyped target) -> untyped
           end
         end
       end

data/sig/lib/appium_lib_core/ios/xcuitest/device/screen.rbs

@@ -6,7 +6,7 @@ module Appium
           module Screen
             def execute: (Symbol command, ?Hash[untyped, untyped], ?Hash[untyped, untyped]) -> untyped
 
-            def self.add_methods: () -> untyped
+            def self.add_methods: (untyped target) -> untyped
           end
         end
       end

data/sig/lib/appium_lib_core/mac2/device/screen.rbs

@@ -5,7 +5,7 @@ module Appium
         module Screen
           def execute: (Symbol command, ?Hash[untyped, untyped], ?Hash[untyped, untyped]) -> untyped
 
-          def self.add_methods: () -> untyped
+          def self.add_methods: (untyped target) -> untyped
         end
       end
     end

data/sig/lib/appium_lib_core/windows/device/screen.rbs

@@ -5,7 +5,7 @@ module Appium
         module Screen
           def execute: (Symbol command, ?Hash[untyped, untyped], ?Hash[untyped, untyped]) -> untyped
 
-          def self.add_methods: () -> untyped
+          def self.add_methods: (untyped target) -> untyped
         end
       end
     end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: appium_lib_core
 version: !ruby/object:Gem::Version
-  version: 13.0.1
+  version: 13.1.1
 platform: ruby
 authors:
 - Kazuaki MATSUO
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-08 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
@@ -37,7 +36,6 @@ files:
 - README.md
 - Rakefile
 - Steepfile
-- Thorfile
 - appium_lib_core.gemspec
 - bin/console
 - bin/setup
@@ -241,7 +239,6 @@ licenses:
 - Apache-2.0
 metadata:
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -256,8 +253,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.9
-signing_key:
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Minimal Ruby library for Appium.
 test_files: []

data/Thorfile

@@ -1,7 +0,0 @@
-require 'appium_thor'
-
-Appium::Thor::Config.set do
-  gem_name     'appium_lib_core'
-  github_name  'ruby_lib_core'
-  version_file 'lib/appium_lib_core/version.rb'
-end