appium_lib_core 1.6.0 → 1.7.0

data/lib/appium_lib_core/device/value.rb

@@ -0,0 +1,23 @@
+module Appium
+  module Core
+    module Device
+      module Value
+        def self.add_methods
+          ::Appium::Core::Device.add_endpoint_method(:set_immediate_value) do
+            def set_immediate_value(element, *value)
+              keys = ::Selenium::WebDriver::Keys.encode(value)
+              execute :set_immediate_value, { id: element.ref }, value: Array(keys)
+            end
+          end
+
+          ::Appium::Core::Device.add_endpoint_method(:replace_value) do
+            def replace_value(element, *value)
+              keys = ::Selenium::WebDriver::Keys.encode(value)
+              execute :replace_value, { id: element.ref }, value: Array(keys)
+            end
+          end
+        end
+      end # module Value
+    end # module Device
+  end # module Core
+end # module Appium

data/lib/appium_lib_core/driver.rb

@@ -97,8 +97,16 @@ module Appium
         new(target, opts)
       end
 
+      # @private
+      # For testing purpose of delegate_from_appium_driver
+      private def delegated_target_for_test
+        @delegate_target
+      end
+
       # @private
       def initialize(target, opts = {})
+        @delegate_target = target # for testing purpose
+
         opts = Appium.symbolize_keys opts
         validate_keys(opts)
 

data/lib/appium_lib_core/ios/device.rb

@@ -1,111 +1,80 @@
-require 'base64'
+require_relative 'device/clipboard'
 
 module Appium
-  module Ios
-    module Device
-      extend Forwardable
-
-      # @!method touch_id(match = true)
-      # An instance method of Appium::Core::Device .
-      # Simulate Touch ID with either valid (match == true) or invalid (match == false) fingerprint.
-      # @param [Boolean] match fingerprint validity. Defaults to true.
-      # @return [String]
-      #
-      # @example
-      #
-      #   @driver.touch_id true #=> Simulate valid fingerprint
-      #   @driver.touch_id false #=> Simulate invalid fingerprint
-      #
-
-      # @!method toggle_touch_id_enrollment(enabled = true)
-      # An instance method of Appium::Core::Device .
-      # Toggle touch id enrollment on an iOS Simulator.
-      # @param [Boolean] enabled Enable toggle touch id enrollment. Set true by default.
-      # @return [String]
-      #
-      # @example
-      #
-      #   @driver.toggle_touch_id_enrollment       #=> Enable toggle enrolled
-      #   @driver.toggle_touch_id_enrollment true  #=> Enable toggle enrolled
-      #   @driver.toggle_touch_id_enrollment false #=> Disable toggle enrolled
-      #
-
-      # @!method get_clipboard(content_type: :plaintext)
-      #   Set the content of device's clipboard.
-      # @param [String] content_type: one of supported content types.
-      # @return [String]
-      #
-      # @example
-      #
-      #   @driver.get_clipboard #=> "happy testing"
-      #
-
-      # @!method set_clipboard(content:, content_type: :plaintext)
-      #   Set the content of device's clipboard.
-      # @param [String] content_type: one of supported content types.
-      # @param [String] content: Contents to be set. (Will encode with base64-encoded inside this method)
-      #
-      # @example
-      #
-      #   @driver.set_clipboard(content: 'happy testing') #=> {"protocol"=>"W3C"}
-      #
-
-      ####
-      ## class << self
-      ####
-
-      class << self
-        def extended(_mod)
-          ::Appium::Core::Device.extend_webdriver_with_forwardable
-
-          ::Appium::Core::Device.add_endpoint_method(:touch_id) do
-            def touch_id(match = true)
-              execute :touch_id, {}, match: match
-            end
-          end
-
-          ::Appium::Core::Device.add_endpoint_method(:toggle_touch_id_enrollment) do
-            def toggle_touch_id_enrollment(enabled = true)
-              execute :toggle_touch_id_enrollment, {}, enabled: enabled
-            end
-          end
-
-          add_clipboard
-        end
-
-        private
-
-        def add_clipboard
-          ::Appium::Core::Device.add_endpoint_method(:get_clipboard) do
-            def get_clipboard(content_type: :plaintext)
-              unless ::Appium::Core::Device::Clipboard::CONTENT_TYPE.member?(content_type)
-                raise "content_type should be #{::Appium::Core::Device::Clipboard::CONTENT_TYPE}"
+  module Core
+    module Ios
+      module Device
+        extend Forwardable
+
+        # @!method touch_id(match = true)
+        # An instance method of Appium::Core::Device .
+        # Simulate Touch ID with either valid (match == true) or invalid (match == false) fingerprint.
+        # @param [Boolean] match fingerprint validity. Defaults to true.
+        # @return [String]
+        #
+        # @example
+        #
+        #   @driver.touch_id true #=> Simulate valid fingerprint
+        #   @driver.touch_id false #=> Simulate invalid fingerprint
+        #
+
+        # @!method toggle_touch_id_enrollment(enabled = true)
+        # An instance method of Appium::Core::Device .
+        # Toggle touch id enrollment on an iOS Simulator.
+        # @param [Boolean] enabled Enable toggle touch id enrollment. Set true by default.
+        # @return [String]
+        #
+        # @example
+        #
+        #   @driver.toggle_touch_id_enrollment       #=> Enable toggle enrolled
+        #   @driver.toggle_touch_id_enrollment true  #=> Enable toggle enrolled
+        #   @driver.toggle_touch_id_enrollment false #=> Disable toggle enrolled
+        #
+
+        # @!method get_clipboard(content_type: :plaintext)
+        #   Set the content of device's clipboard.
+        # @param [String] content_type: one of supported content types.
+        # @return [String]
+        #
+        # @example
+        #
+        #   @driver.get_clipboard #=> "happy testing"
+        #
+
+        # @!method set_clipboard(content:, content_type: :plaintext)
+        #   Set the content of device's clipboard.
+        # @param [String] content_type: one of supported content types.
+        # @param [String] content: Contents to be set. (Will encode with base64-encoded inside this method)
+        #
+        # @example
+        #
+        #   @driver.set_clipboard(content: 'happy testing') #=> {"protocol"=>"W3C"}
+        #
+
+        ####
+        ## class << self
+        ####
+
+        class << self
+          def extended(_mod)
+            ::Appium::Core::Device.extend_webdriver_with_forwardable
+
+            ::Appium::Core::Device.add_endpoint_method(:touch_id) do
+              def touch_id(match = true)
+                execute :touch_id, {}, match: match
               end
-
-              params = {}
-              params[:contentType] = content_type
-
-              data = execute(:get_clipboard, {}, params)
-              Base64.decode64 data
             end
-          end
 
-          ::Appium::Core::Device.add_endpoint_method(:set_clipboard) do
-            def set_clipboard(content:, content_type: :plaintext)
-              unless ::Appium::Core::Device::Clipboard::CONTENT_TYPE.member?(content_type)
-                raise "content_type should be #{::Appium::Core::Device::Clipboard::CONTENT_TYPE}"
+            ::Appium::Core::Device.add_endpoint_method(:toggle_touch_id_enrollment) do
+              def toggle_touch_id_enrollment(enabled = true)
+                execute :toggle_touch_id_enrollment, {}, enabled: enabled
               end
-
-              params = {
-                contentType: content_type,
-                content: Base64.encode64(content)
-              }
-
-              execute(:set_clipboard, {}, params)
             end
+
+            Clipboard.add_methods
           end
         end
-      end
-    end # module Device
-  end # module iOS
+      end # module Device
+    end # module iOS
+  end # module Core
 end # module Appium

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

@@ -0,0 +1,41 @@
+require 'base64'
+
+module Appium
+  module Core
+    module Ios
+      module Device
+        module Clipboard
+          def self.add_methods
+            ::Appium::Core::Device.add_endpoint_method(:get_clipboard) do
+              def get_clipboard(content_type: :plaintext)
+                unless ::Appium::Core::Device::Clipboard::CONTENT_TYPE.member?(content_type)
+                  raise "content_type should be #{::Appium::Core::Device::Clipboard::CONTENT_TYPE}"
+                end
+
+                params = { contentType: content_type }
+
+                data = execute(:get_clipboard, {}, params)
+                Base64.decode64 data
+              end
+            end
+
+            ::Appium::Core::Device.add_endpoint_method(:set_clipboard) do
+              def set_clipboard(content:, content_type: :plaintext)
+                unless ::Appium::Core::Device::Clipboard::CONTENT_TYPE.member?(content_type)
+                  raise "content_type should be #{::Appium::Core::Device::Clipboard::CONTENT_TYPE}"
+                end
+
+                params = {
+                  contentType: content_type,
+                  content: Base64.encode64(content)
+                }
+
+                execute(:set_clipboard, {}, params)
+              end
+            end
+          end
+        end # module Clipboard
+      end # module Device
+    end # module Ios
+  end # module Core
+end # module Appium

data/lib/appium_lib_core/ios/uiautomation/bridge.rb

@@ -5,7 +5,7 @@ module Appium
         module Bridge
           def self.for(target)
             Core::Ios::SearchContext.extend
-            target.extend Appium::Ios::Device
+            target.extend Appium::Core::Ios::Device
 
             Core::Ios::Uiautomation.patch_webdriver_element
           end

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

@@ -6,8 +6,8 @@ module Appium
           def self.for(target)
             Core::Ios::SearchContext.extend
             Core::Ios::Xcuitest::SearchContext.extend
-            target.extend Appium::Ios::Device
-            target.extend Appium::Ios::Xcuitest::Device
+            target.extend Appium::Core::Ios::Device
+            target.extend Appium::Core::Ios::Xcuitest::Device
           end
         end
       end

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

@@ -1,234 +1,173 @@
-module Appium
-  module Ios
-    module Xcuitest
-      module Device
-        extend Forwardable
-
-        # rubocop:disable Metrics/LineLength
-
-        # @!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.
-        # @param [Symbol] strategy The symbol of the strategy which closes the keyboard.
-        #   XCUITest ignore this argument.
-        #   Default for iOS is `:pressKey`. Default for Android is `:tapOutside`.
-        #
-        # @example
-        #
-        #  @driver.hide_keyboard             # Close a keyboard with the 'Done' button
-        #  @driver.hide_keyboard('Finished') # Close a keyboard with the 'Finished' button
-        #
-
-        # @!method background_app(duration = 0)
-        # 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.
-        #
-        # @example
-        #
-        #   @driver.background_app
-        #   @driver.background_app(5)
-        #   @driver.background_app(-1) #=> the app never come back. https://github.com/appium/appium/issues/7741
-        #
-
-        # @!method start_recording_screen(remote_path: nil, user: nil, pass: nil, method: nil, force_restart: nil, video_type: 'mp4', time_limit: '180', video_quality: 'medium')
-        # @param [String] remote_path: The path to the remote location, where the resulting video should be uploaded.
-        #                             The following protocols are supported: http/https, ftp.
-        #                             Null or empty string value (the default setting) means the content of resulting
-        #                             file should be encoded as Base64 and passed as the endpount response value.
-        #                             An exception will be thrown if the generated media file is too big to
-        #                             fit into the available process memory.
-        #                             This option only has an effect if there is screen recording process in progreess
-        #                             and `forceRestart` parameter is not set to `true`.
-        # @param [String] user: The name of the user for the remote authentication.
-        # @param [String] pass: The password for the remote authentication.
-        # @param [String] method: The http multipart upload method name. The 'PUT' one is used by default.
-        # @param [Boolean] force_restart: Whether to try to catch and upload/return the currently running screen recording
-        #                                 (`false`, the default setting on server) or ignore the result of it
-        #                                 and start a new recording immediately (`true`).
-        # @param [String] video_type: The format of the screen capture to be recorded.
-        #                            Available formats: "h264", "mp4" or "fmp4". Default is "mp4".
-        #                            Only works for Simulator.
-        # @param [String] time_limit: Recording time. 180 seconds is by default.
-        # @param [String] video_quality: The video encoding quality (low, medium, high, photo - defaults to medium).
-        #                               Only works for real devices.
-        #
-        # @example
-        #
-        #    @driver.start_recording_screen
-        #    @driver.start_recording_screen video_type: 'h264', time_limit: '260'
-        #
-
-        # @since 1.3.4
-        # @!method start_performance_record(timeout: 300000, profile_name: 'Activity Monitor')
-        #
-        # This is a blocking application.
-        # @param [Integer|String] timeout: The maximum count of milliseconds to record the profiling information.
-        # @param [String] profile_name: The name of existing performance profile to apply.
-        #                               Execute `instruments -s` to show the list of available profiles.
-        #                               Note, that not all profiles are supported on mobile devices.
-        # @param [Integer|String] pid: The ID of the process to measure the performance for.
-        #                              Set it to `current` in order to measure the performance of
-        #                              the process, which belongs to the currently active application.
-        #                              All processes running on the device are measured if
-        #                              pid is unset (the default setting). Setting process ID while
-        #                              device under test is Simulator might require `instruments` to be launched
-        #                              with sudo privileges, which is not supported and will throw a timeout exception.
-        # @return nil
-        #
-        # @example
-        #
-        #   @driver.start_performance_record # default: (timeout: 300000, profile_name: 'Activity Monitor')
-        #   @driver.start_performance_record(timeout: 300000, profile_name: 'Activity Monitor')
-        #
-
-        # @since 1.3.4
-        # @!method get_performance_record(save_file_path: './performance', profile_name: 'Activity Monitor', remote_path: nil, user: nil, pass: nil, method: 'PUT')
-        #
-        # This is a blocking application.
-        #
-        # @param [String] save_file_path: A path to save data as zipped .trace file
-        # @param [String] profile_name: The name of existing performance profile to apply.
-        #                               Execute `instruments -s` to show the list of available profiles.
-        #                               Note, that not all profiles are supported on mobile devices.
-        # @param [String] save_file_path: The name of existing performance profile to apply.
-        #                              Execute `instruments -s` to show the list of available profiles.
-        #                              Note, that not all profiles are supported on mobile devices.
-        # @param [String] remote_path: The path to the remote location, where the resulting zipped .trace file should be uploaded.
-        #                              The following protocols are supported: http/https, ftp.
-        #                              Null or empty string value (the default setting) means the content of resulting
-        #                              file should be zipped, encoded as Base64 and passed as the endpount response value.
-        #                              An exception will be thrown if the generated file is too big to
-        #                              fit into the available process memory.
-        # @param [String] user: The name of the user for the remote authentication. Only works if `remotePath` is provided.
-        # @param [String] pass: The password for the remote authentication. Only works if `remotePath` is provided.
-        # @param [String] method: The http multipart upload method name. Only works if `remotePath` is provided.
-        #
-        # @example
-        #
-        #   @driver.get_performance_record
-        #   @driver.get_performance_record(save_file_path: './performance', profile_name: 'Activity Monitor')
-
-        # @since 1.6.0
-        # @!method battery_info
-        #
-        # Get battery information.
-        #
-        # @return [Hash]  Return battery level and battery state from the target real device. (Simulator has no battery.)
-        #                 https://developer.apple.com/documentation/uikit/uidevice/ 's `batteryLevel` and `batteryState`.
-        #                 Battery level in range [0.0, 1.0], where 1.0 means 100% charge. -1 is returned
-        #                 if the actual value cannot be retrieved from the system.
-        #                 Battery state. The following symbols are possible
-        #                 `:unplugged, :charging, :full`
-        #
-        # @example
-        #
-        #   @driver.battery_info #=> { state: :full, level: 0.7 }
-        #
-
-        # rubocop:enable Metrics/LineLength
+require_relative 'device/performance'
+require_relative 'device/screen'
+require_relative 'device/battery'
 
-        ####
-        ## class << self
-        ####
-
-        class << self
-          def extended(_mod)
-            # Override
-            ::Appium::Core::Device.add_endpoint_method(:hide_keyboard) do
-              def hide_keyboard(close_key = nil, strategy = nil)
-                option = {}
-
-                option[:key] = close_key if close_key
-                option[:strategy] = strategy if strategy
-
-                execute :hide_keyboard, {}, option
-              end
-            end
-
-            # Override
-            ::Appium::Core::Device.add_endpoint_method(:background_app) do
-              def background_app(duration = 0)
-                # https://github.com/appium/ruby_lib/issues/500, https://github.com/appium/appium/issues/7741
-                # `execute :background_app, {}, seconds: { timeout: duration_milli_sec }` works over Appium 1.6.4
-                duration_milli_sec = duration.nil? ? nil : duration * 1000
-                execute :background_app, {}, seconds: { timeout: duration_milli_sec }
-              end
-            end
-
-            add_performance
-            add_screen_recording
-            add_battery_info
-          end
-
-          private
-
-          def add_battery_info
-            Appium::Core::Device.add_endpoint_method(:battery_info) do
-              def battery_info
-                response = execute_script 'mobile: batteryInfo', {}
-
-                state = case response['state']
-                        when 1, 2, 3
-                          ::Appium::Core::Device::BatteryStatus::IOS[response['state']]
-                        else
-                          Appium::Logger.warn("The state is unknown or undefined: #{response['state']}")
-                          ::Appium::Core::Device::BatteryStatus::IOS[0] # :unknown
-                        end
-                { state: state, level: response['level'] }
-              end
-            end
-          end
-
-          def add_performance
-            Appium::Core::Device.add_endpoint_method(:start_performance_record) do
-              def start_performance_record(timeout: 300_000, profile_name: 'Activity Monitor', pid: nil)
-                option = {}
-                option[:timeout] = timeout
-                option[:profileName] = profile_name
-                option[:pid] = pid if pid
-
-                execute_script 'mobile: startPerfRecord', option
+module Appium
+  module Core
+    module Ios
+      module Xcuitest
+        module Device
+          extend Forwardable
+
+          # rubocop:disable Metrics/LineLength
+
+          # @!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.
+          # @param [Symbol] strategy The symbol of the strategy which closes the keyboard.
+          #   XCUITest ignore this argument.
+          #   Default for iOS is `:pressKey`. Default for Android is `:tapOutside`.
+          #
+          # @example
+          #
+          #  @driver.hide_keyboard             # Close a keyboard with the 'Done' button
+          #  @driver.hide_keyboard('Finished') # Close a keyboard with the 'Finished' button
+          #
+
+          # @!method background_app(duration = 0)
+          # 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.
+          #
+          # @example
+          #
+          #   @driver.background_app
+          #   @driver.background_app(5)
+          #   @driver.background_app(-1) #=> the app never come back. https://github.com/appium/appium/issues/7741
+          #
+
+          # @!method start_recording_screen(remote_path: nil, user: nil, pass: nil, method: nil, force_restart: nil, video_type: 'mp4', time_limit: '180', video_quality: 'medium')
+          # @param [String] remote_path: The path to the remote location, where the resulting video should be uploaded.
+          #                             The following protocols are supported: http/https, ftp.
+          #                             Null or empty string value (the default setting) means the content of resulting
+          #                             file should be encoded as Base64 and passed as the endpount response value.
+          #                             An exception will be thrown if the generated media file is too big to
+          #                             fit into the available process memory.
+          #                             This option only has an effect if there is screen recording process in progreess
+          #                             and `forceRestart` parameter is not set to `true`.
+          # @param [String] user: The name of the user for the remote authentication.
+          # @param [String] pass: The password for the remote authentication.
+          # @param [String] method: The http multipart upload method name. The 'PUT' one is used by default.
+          # @param [Boolean] force_restart: Whether to try to catch and upload/return the currently running screen recording
+          #                                 (`false`, the default setting on server) or ignore the result of it
+          #                                 and start a new recording immediately (`true`).
+          # @param [String] video_type: The format of the screen capture to be recorded.
+          #                            Available formats: "h264", "mp4" or "fmp4". Default is "mp4".
+          #                            Only works for Simulator.
+          # @param [String] time_limit: Recording time. 180 seconds is by default.
+          # @param [String] video_quality: The video encoding quality (low, medium, high, photo - defaults to medium).
+          #                               Only works for real devices.
+          #
+          # @example
+          #
+          #    @driver.start_recording_screen
+          #    @driver.start_recording_screen video_type: 'h264', time_limit: '260'
+          #
+
+          # @since 1.3.4
+          # @!method start_performance_record(timeout: 300000, profile_name: 'Activity Monitor')
+          #
+          # This is a blocking application.
+          # @param [Integer|String] timeout: The maximum count of milliseconds to record the profiling information.
+          # @param [String] profile_name: The name of existing performance profile to apply.
+          #                               Execute `instruments -s` to show the list of available profiles.
+          #                               Note, that not all profiles are supported on mobile devices.
+          # @param [Integer|String] pid: The ID of the process to measure the performance for.
+          #                              Set it to `current` in order to measure the performance of
+          #                              the process, which belongs to the currently active application.
+          #                              All processes running on the device are measured if
+          #                              pid is unset (the default setting). Setting process ID while
+          #                              device under test is Simulator might require `instruments` to be launched
+          #                              with sudo privileges, which is not supported and will throw a timeout exception.
+          # @return nil
+          #
+          # @example
+          #
+          #   @driver.start_performance_record # default: (timeout: 300000, profile_name: 'Activity Monitor')
+          #   @driver.start_performance_record(timeout: 300000, profile_name: 'Activity Monitor')
+          #
+
+          # @since 1.3.4
+          # @!method get_performance_record(save_file_path: './performance', profile_name: 'Activity Monitor', remote_path: nil, user: nil, pass: nil, method: 'PUT')
+          #
+          # This is a blocking application.
+          #
+          # @param [String] save_file_path: A path to save data as zipped .trace file
+          # @param [String] profile_name: The name of existing performance profile to apply.
+          #                               Execute `instruments -s` to show the list of available profiles.
+          #                               Note, that not all profiles are supported on mobile devices.
+          # @param [String] save_file_path: The name of existing performance profile to apply.
+          #                              Execute `instruments -s` to show the list of available profiles.
+          #                              Note, that not all profiles are supported on mobile devices.
+          # @param [String] remote_path: The path to the remote location, where the resulting zipped .trace file should be uploaded.
+          #                              The following protocols are supported: http/https, ftp.
+          #                              Null or empty string value (the default setting) means the content of resulting
+          #                              file should be zipped, encoded as Base64 and passed as the endpount response value.
+          #                              An exception will be thrown if the generated file is too big to
+          #                              fit into the available process memory.
+          # @param [String] user: The name of the user for the remote authentication. Only works if `remotePath` is provided.
+          # @param [String] pass: The password for the remote authentication. Only works if `remotePath` is provided.
+          # @param [String] method: The http multipart upload method name. Only works if `remotePath` is provided.
+          #
+          # @example
+          #
+          #   @driver.get_performance_record
+          #   @driver.get_performance_record(save_file_path: './performance', profile_name: 'Activity Monitor')
+
+          # @since 1.6.0
+          # @!method battery_info
+          #
+          # Get battery information.
+          #
+          # @return [Hash]  Return battery level and battery state from the target real device. (Simulator has no battery.)
+          #                 https://developer.apple.com/documentation/uikit/uidevice/ 's `batteryLevel` and `batteryState`.
+          #                 Battery level in range [0.0, 1.0], where 1.0 means 100% charge. -1 is returned
+          #                 if the actual value cannot be retrieved from the system.
+          #                 Battery state. The following symbols are possible
+          #                 `:unplugged, :charging, :full`
+          #
+          # @example
+          #
+          #   @driver.battery_info #=> { state: :full, level: 0.7 }
+          #
+
+          # rubocop:enable Metrics/LineLength
+
+          ####
+          ## class << self
+          ####
+
+          class << self
+            def extended(_mod)
+              # Override
+              ::Appium::Core::Device.add_endpoint_method(:hide_keyboard) do
+                def hide_keyboard(close_key = nil, strategy = nil)
+                  option = {}
+
+                  option[:key] = close_key if close_key
+                  option[:strategy] = strategy if strategy
+
+                  execute :hide_keyboard, {}, option
+                end
               end
-            end
-
-            Appium::Core::Device.add_endpoint_method(:get_performance_record) do
-              # rubocop:disable Metrics/ParameterLists
-              def get_performance_record(save_file_path: './performance', profile_name: 'Activity Monitor',
-                                         remote_path: nil, user: nil, pass: nil, method: 'PUT')
-                option = ::Appium::Core::Device::ScreenRecord.new(
-                  remote_path: remote_path, user: user, pass: pass, method: method
-                ).upload_option
-
-                option[:profileName] = profile_name
-                result = execute_script 'mobile: stopPerfRecord', option
 
-                File.open("#{save_file_path}.zip", 'wb') { |f| f << result.unpack('m')[0] }
+              # Override
+              ::Appium::Core::Device.add_endpoint_method(:background_app) do
+                def background_app(duration = 0)
+                  # https://github.com/appium/ruby_lib/issues/500, https://github.com/appium/appium/issues/7741
+                  # `execute :background_app, {}, seconds: { timeout: duration_milli_sec }` works over Appium 1.6.4
+                  duration_milli_sec = duration.nil? ? nil : duration * 1000
+                  execute :background_app, {}, seconds: { timeout: duration_milli_sec }
+                end
               end
-              # rubocop:enable Metrics/ParameterLists
-            end
-          end
-
-          def add_screen_recording
-            Appium::Core::Device.add_endpoint_method(:start_recording_screen) do
-              # rubocop:disable Metrics/ParameterLists
-              def start_recording_screen(remote_path: nil, user: nil, pass: nil, method: nil, force_restart: nil,
-                                         video_type: 'mp4', time_limit: '180', video_quality: 'medium')
-                option = ::Appium::Core::Device::ScreenRecord.new(
-                  remote_path: remote_path, user: user, pass: pass, method: method, force_restart: force_restart
-                ).upload_option
 
-                option[:videoType] = video_type
-                option[:timeLimit] = time_limit
-                option[:videoQuality] = video_quality
-
-                execute(:start_recording_screen, {}, { options: option })
-              end
-              # rubocop:enable Metrics/ParameterLists
+              Performance.add_methods
+              Screen.add_methods
+              Battery.add_methods
             end
-          end
-        end # class << self
-      end # module Device
-    end # module Xcuitest
-  end # module Ios
+          end # class << self
+        end # module Device
+      end # module Xcuitest
+    end # module Ios
+  end # module Core
 end # module Appium