chore: add deprecated in docstrings for start_logs_broadcast/stop_logs_broadcast (#1095)

* chore: add deprecated in docstrings for start_logs_broadcast/stop_logs_broadcast

* add one more todo

Author: KazuCocoa

appium_lib.gemspec

@@ -13,6 +13,7 @@ Gem::Specification.new do |s|
   s.homepage      = 'https://github.com/appium/ruby_lib' # published as appium_lib
   s.require_paths = ['lib']
 
+  # TODO: We must remove start_logs_broadcast/stop_logs_broadcast to bump the appium_lib_core version to v12+.
   s.add_dependency 'appium_lib_core', '>= 9.2.1', '< 12.0'
   s.add_dependency 'nokogiri', '~> 1.8', '>= 1.8.1'
   s.add_dependency 'tomlrb', '>= 1.1', '< 3.0'

lib/appium_lib/android/common/command/command.rb

@@ -31,6 +31,8 @@ def shell(command, arguments)
         @driver.execute_script 'mobile: shell', args
       end
 
+      # @deprecated Please use BiDi implementation via `$driver.driver.bidi` directly instead.
+      #
       # Starts Android logcat broadcast websocket
       #
       # @param [String] logcat_file A file path to write messages from a logcat WebSocket client
@@ -46,6 +48,8 @@ def start_logs_broadcast(logcat_file = 'logcat.log')
         @logcat_client = ::Appium::Common::Command::WsLogcat.new(url: socket_url, output_file: logcat_file)
       end
 
+      # @deprecated Please use BiDi implementation directly instead.
+      #
       # Stop Android logcat broadcast websocket
       #
       # @example

lib/appium_lib/common/command/ws_logcat.rb

@@ -15,6 +15,7 @@
 module Appium
   module Common
     module Command
+      # TODO: Remove this implementation after dropping start_logs_broadcast
       class WsLogcat < ::Appium::Core::WebSocket
         def initialize(url:, output_file: 'logcat.log')
           super(url: url)

lib/appium_lib/ios/xcuitest/command.rb

@@ -22,6 +22,8 @@ module Appium
   module Ios
     module Xcuitest
       module Command
+        # @deprecated Please use BiDi implementation via `$driver.driver.bidi` directly instead.
+        #
         # Starts iOS syslog broadcast websocket
         #
         # @param [String] syslog_file A file path to write messages from a syslog WebSocket client
@@ -37,6 +39,8 @@ def start_logs_broadcast(syslog_file = 'syslog.log')
           @logcat_client = ::Appium::Common::Command::WsLogcat.new(url: socket_url, output_file: syslog_file)
         end
 
+        # @deprecated Please use BiDi implementation directly instead.
+        #
         # Stop iOS syslog broadcast websocket
         #
         # @example