appium_lib_core 4.1.0 → 9.0.0

data/README.md

@@ -10,7 +10,14 @@ This library wraps [selenium-webdriver](https://github.com/SeleniumHQ/selenium/w
 
 # Documentation
 
-- http://www.rubydoc.info/github/appium/ruby_lib_core
+- https://www.rubydoc.info/gems/appium_lib_core
+    - You can find working API examples in test code, [test/functional](test/functional)
+- Appium 2.0
+    - https://appium.github.io/appium/docs/en/2.0/ (Not completed yet)
+
+# Migration from v4 to v5
+
+Please read [`[5.0.0]`](CHANGELOG.md#500---2021-11-05) section in [CHANGELOG](CHANGELOG.md)
 
 # Related library
 - https://github.com/appium/ruby_lib
@@ -18,27 +25,36 @@ This library wraps [selenium-webdriver](https://github.com/SeleniumHQ/selenium/w
 # How to start
 ## Run tests
 ### Unit Tests
-Run unit tests which check each method and commands, URL, using the webmock.
+Run unit tests which check each method and command, URL, using the webmock.
 
 ```bash
 $ bundle install
 $ bundle exec parallel_test test/unit/
 ```
 
+or
+
+```bash
+$ bundle install
+$ bundle exec rake test:unit
+```
+
 ### Functional Tests
 Run functional tests which require the Appium server and real device, Simulator/Emulator.
 
-- Start Appium server
+- Start Appium server (Appium 2.0 base)
 ```bash
-$ npm install -g appium opencv4nodejs
-$ appium --relaxed-security # To run all tests in local
+$ npm install --location=global appium
+$ appium driver install xcuitest
+$ appium driver install uiautomator2 # etc
+$ appium --base-path=/wd/hub --relaxed-security # To run all tests in local
 ```
 
 - Conduct tests
 ```bash
 $ bundle install
 $ rake test:func:android # Andorid, uiautomator2
-$ AUTOMATION_NAME_DROID=espresso rake test:func:android # Andorid, uiautomator2
+$ APPIUM_DRIVER=espresso rake test:func:android # Andorid, uiautomator2
 $ rake test:func:ios     # iOS
 ```
 
@@ -78,7 +94,7 @@ $ PARALLEL=1 bundle exec parallel_test test/functional/ios -n 2
 
 - Runs on CI environment (on Azure)
     - Non `IGNORE_VERSION_SKIP` or `IGNORE_VERSION_SKIP=true` runs all tests ignoring `skip` them by Appium versions
-    - `IGNORE_VERSION_SKIP=false` skips the following tests if the Appium version is lower than the requirement  
+    - `IGNORE_VERSION_SKIP=false` skips the following tests if the Appium version is lower than the requirement
 
 ```
 $ IGNORE_VERSION_SKIP=true CI=true bundle exec rake test:func:android
@@ -92,14 +108,14 @@ $ IGNORE_VERSION_SKIP=true CI=true bundle exec rake test:func:android
     ```ruby
     require 'rubygems'
     require 'appium_lib_core'
-    
+
     opts = {
-      desired_capabilities: { # or { caps: {....} }
-        platformName: :ios,
+      capabilities: { # Append capabilities
+        platformName: 'ios',
         platformVersion: '11.0',
         deviceName: 'iPhone Simulator',
-        automationName: 'XCUITest',
-        app: '/path/to/MyiOS.app'
+        # app: '/path/to/MyiOS.app',  # Without 'app' capability, an appium session starts with the home screen
+        automationName: 'XCUITest'
       },
       appium_lib: {
         wait: 30
@@ -107,7 +123,7 @@ $ IGNORE_VERSION_SKIP=true CI=true bundle exec rake test:func:android
     }
     @core = Appium::Core.for(opts) # create a core driver with `opts`
     @driver = @core.start_driver
-    
+
     # Launch iPhone Simulator and `MyiOS.app`
     @driver.find_element(:accessibility_id, 'some accessibility') # find an element
     ```
@@ -115,18 +131,52 @@ $ IGNORE_VERSION_SKIP=true CI=true bundle exec rake test:func:android
     ```bash
     # shell 1
     $ appium --log-level warn:error # show only warning and error logs
-    
+
     # shell 2
     $ ruby test.rb
     ```
 
-More examples are in [test/functional](test/functional)    
+[Appium::Core.for](https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Driver#for-class_method) documentation has more example to build a new driver instance.
+
+More examples are in [test/functional](test/functional)
+
+As of version 5.8.0, the client can attach to an existing session. The main purpose is for debugging.
+
+```ruby
+# @driver is the driver instance of an existing session
+attached_driver = ::Appium::Core::Driver.attach_to @driver.session_id, url: 'http://127.0.0.1:4723/wd/hub', automation_name: 'XCUITest', platform_name: 'ios'
+assert attached_driver.session_id == @driver.session_id
+attached_driver.page_source
+```
 
 ### Capabilities
 
 Read [Appium/Core/Driver](https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Driver) to catch up with available capabilities.
 Capabilities affect only ruby_lib is [Appium/Core/Options](https://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Options).
 
+
+### Gives custom listener
+
+An example to define a customer listener with [Selenium::WebDriver::Support::AbstractEventListener](https://www.selenium.dev/selenium/docs/api/rb/Selenium/WebDriver/Support/AbstractEventListener.html)
+
+```ruby
+class CustomListener < ::Selenium::WebDriver::Support::AbstractEventListener
+  // something
+end
+capabilities: {
+  platformName: :ios,
+  platformVersion: '11.0',
+  deviceName: 'iPhone Simulator',
+  automationName: 'XCUITest',
+  app: '/path/to/MyiOS.app'
+},
+appium_lib: {
+  listener: CustomListener.new
+}
+@core = Appium::Core.for capabilities: capabilities, appium_lib: appium_lib
+@core.start_driver
+```
+
 # Development
 - Demo app
     - https://android.googlesource.com/platform/development/+/master/samples/ApiDemos

data/Rakefile

@@ -38,6 +38,7 @@ namespace :test do
   namespace :unit do
     desc('Run all iOS related unit tests in test directory')
     Rake::TestTask.new(:ios) do |t|
+      ENV['UNIT_TEST'] = '1'
       t.libs << 'test'
       t.libs << 'lib'
       t.test_files = FileList['test/unit/ios/**/*_test.rb']
@@ -45,6 +46,7 @@ namespace :test do
 
     desc('Run all Android related unit tests in test directory')
     Rake::TestTask.new(:android) do |t|
+      ENV['UNIT_TEST'] = '1'
       t.libs << 'test'
       t.libs << 'lib'
       t.test_files = FileList['test/unit/android/**/*_test.rb']
@@ -52,6 +54,7 @@ namespace :test do
 
     desc('Run all common related unit tests in test directory')
     Rake::TestTask.new(:common) do |t|
+      ENV['UNIT_TEST'] = '1'
       t.libs << 'test'
       t.libs << 'lib'
       t.test_files = FileList['test/unit/common/**/*_test.rb']
@@ -59,6 +62,7 @@ namespace :test do
 
     desc('Run all Windows related unit tests in test directory')
     Rake::TestTask.new(:windows) do |t|
+      ENV['UNIT_TEST'] = '1'
       t.libs << 'test'
       t.libs << 'lib'
       t.test_files = FileList['test/unit/windows/**/*_test.rb']
@@ -109,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

@@ -4,7 +4,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'appium_lib_core/version'
 
 Gem::Specification.new do |spec|
-  spec.required_ruby_version = '>= 2.4'
+  spec.required_ruby_version = Gem::Requirement.new('>= 3.0')
 
   spec.name          = 'appium_lib_core'
   spec.version       = Appium::Core::VERSION
@@ -16,25 +16,22 @@ 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|test|spec|features)/})
+    f.match(%r{(^(doc|docs|test|spec|features|ci-jobs|.github|script)/|release_notes.md|.gitignore|azure-pipelines.yml|.rubocop.yml)})
   end
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
 
-  spec.add_runtime_dependency 'selenium-webdriver', '~> 3.14', '>= 3.14.1'
+  spec.add_runtime_dependency 'selenium-webdriver', '~> 4.2'
   spec.add_runtime_dependency 'faye-websocket', '~> 0.11.0'
 
-  spec.add_development_dependency 'bundler', '>= 1.14'
   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.11.0'
-  spec.add_development_dependency 'rubocop', '1.7.0'
-  spec.add_development_dependency 'appium_thor', '~> 1.0'
-  spec.add_development_dependency 'pry'
-  spec.add_development_dependency 'pry-byebug'
+  spec.add_development_dependency 'webmock', '~> 3.23.0'
+  spec.add_development_dependency 'rubocop', '1.63.5'
+  spec.add_development_dependency 'appium_thor', '~> 2.0'
   spec.add_development_dependency 'parallel_tests'
   spec.add_development_dependency 'simplecov'
 end

data/bin/console

@@ -6,9 +6,5 @@ require "appium_lib_core"
 # You can add fixtures and/or initialization code here to make experimenting
 # with your gem easier. You can also use a different console, if you like.
 
-# (If you use this, don't forget to add pry to your Gemfile!)
-# require "pry"
-# Pry.start
-
 require "irb"
 IRB.start(__FILE__)

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

@@ -20,8 +20,11 @@ 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 ArgumentError, "finger_id should be integer between 1 to 10. Not #{finger_id}"
+                  raise ::Appium::Core::Error::ArgumentError,
+                        "finger_id should be integer between 1 to 10. Not #{finger_id}"
                 end
 
                 execute(:finger_print, {}, { fingerprintId: finger_id.to_i })

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,45 @@ module Appium
         #   @driver.toggle_data
         #
 
+        # @deprecated Use 'mobile: getConnectivity' extension instead.
+        # @!method location
+        # Get the location of the device.
+        #
+        # @return [::Appium::Location]
+        #
+        # @example
+        #
+        #   driver.location #=> ::Appium::Location.new(10, 10, 10)
+        #
+
+        # @!method location=
+        # Set the location of the device.
+        #
+        # @param [::Appium::Location] location Set the location.
+        #
+        # @example
+        #
+        #   driver.location = ::Appium::Location.new(10, 10, 10)
+        #
+
+        # @!method set_location
+        # Set the location of the device.
+        #
+        # @param [String, Number] latitude Set the latitude.
+        # @param [String, Number] longitude Set the longitude.
+        # @param [String, Number] altitude Set the altitude.
+        # @param [String, Number] speed Set the speed to apply the location on Android real devices
+        #                               in meters/second @since Appium 1.21.0 and in knots for emulators @since Appium 1.22.0.
+        # @param [String, Number] satellites Sets the count of geo satellites being tracked in range 1..12 @since Appium 1.22.0.
+        #                                    This number is respected on Emulators.
+        # @param [::Appium::Location]
+        #
+        # @example
+        #
+        #   driver.set_location 10, 10, 0
+        #
+
+        # @deprecated Use 'mobile: toggleGps' extension instead.
         # @!method toggle_location_services
         #   Switch the state of the location service
         #
@@ -116,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
         #
@@ -124,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.
@@ -139,12 +188,7 @@ module Appium
         #  @driver.hide_keyboard(nil, :tapOutside) # Close a keyboard with tapping out side of keyboard
         #
 
-        # @!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.
         #
@@ -169,6 +213,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.
@@ -191,6 +236,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.
@@ -201,6 +247,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
@@ -280,6 +327,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.
         #
@@ -290,18 +338,22 @@ module Appium
         #   @driver.finger_print 1
         #
 
-        # @!method execute_cdp(cmd, params)
+        # @!method execute_cdp(cmd, **params)
         #     Execute Chrome Devtools protocol commands
         #     https://chromedevtools.github.io/devtools-protocol
         #
         # @param [String] cmd The name of command
-        # @param [Hash] params The parameter for the command as hash.
+        # @option params The parameter for the command as keyword options.
         #
         # @example
         #
-        #   @driver.execute_cdp 'Page.captureScreenshot', { quality: 50, format: 'jpeg' }
+        #   @driver.execute_cdp 'Page.captureScreenshot', quality: 50, format: 'jpeg'
         #   @driver.execute_cdp 'Page.getResourceTree'
         #
+        #   # for Ruby 2,7 and 3+ compatibility
+        #   params = {'timezoneId': 'Asia/Tokyo'}
+        #   driver.execute_cdp 'Emulation.setTimezoneOverride', **params
+        #
 
         ####
         ## class << self
@@ -315,42 +367,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 = {}
@@ -388,6 +454,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
@@ -400,14 +468,9 @@ module Appium
             # Android, Override included method in bridge
             ::Appium::Core::Device.add_endpoint_method(:background_app) do
               def background_app(duration = 0)
-                execute :background_app, {}, seconds: duration
-              end
-            end
+                ::Appium::Logger.warn "[DEPRECATION] Please use 'mobile: backgroundApp' extension instead"
 
-            # TODO: TEST ME
-            ::Appium::Core::Device.add_endpoint_method(:end_coverage) do
-              def end_coverage(path, intent)
-                execute :end_coverage, {}, path: path, intent: intent
+                execute :background_app, {}, seconds: duration
               end
             end
 
@@ -415,7 +478,7 @@ module Appium
               # SeleniumWebdriver could already define this method
               return if method_defined? :execute_cdp
 
-              def execute_cdp(cmd, params = {})
+              def execute_cdp(cmd, **params)
                 execute :chrome_send_command, {}, { cmd: cmd, params: params }
               end
             end