appium_lib_core 5.1.0 → 5.1.1

data/ci-jobs/functional_test.yml

@@ -1,298 +0,0 @@
-# jobs for functional test
-parameters:
-  vmImage: 'macOS-10.15'
-  vmImageForIOS: 'macOS-10.15'
-  xcodeForIOS: 12.2
-  xcodeForTVOS: 12.2
-  androidSDK: 29  # API Level 30 emulators are more unstable than 29
-  appiumVersion: 'beta'
-  ignoreVersionSkip: true
-  CI: true
-
-
-jobs:
-  # Run unit tests on different Node versions
-  - job: func_test_ios_base
-    pool:
-      vmImage: ${{ parameters.vmImageForIOS }}
-    variables:
-      CI: ${{ parameters.ci }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    steps:
-    - template: ./functional/ios_setup.yml
-      parameters:
-        xcodeVersion: ${{ parameters.xcodeForIOS }}
-    - template: ./functional/run_appium.yml
-    - script: bundle exec rake test:func:ios TESTS=test/functional/ios/driver_test.rb,test/functional/ios/patch_test.rb
-      displayName: Run tests func_test_ios_base
-    - template: ./functional/publish_test_result.yml
-
-  - job: func_test_ios_webdriver1
-    pool:
-      vmImage: ${{ parameters.vmImageForIOS }}
-    variables:
-      CI: ${{ parameters.ci }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    steps:
-    - template: ./functional/ios_setup.yml
-      parameters:
-        xcodeVersion: ${{ parameters.xcodeForIOS }}
-    - template: ./functional/run_appium.yml
-    - script: bundle exec rake test:func:ios TESTS=test/functional/ios/webdriver/create_session_test.rb,test/functional/ios/webdriver/w3c_actions_test.rb
-      displayName: Run tests func_test_ios_webdriver1
-    - template: ./functional/publish_test_result.yml
-
-  - job: func_test_ios_webdriver2
-    pool:
-      vmImage: ${{ parameters.vmImageForIOS }}
-    variables:
-      CI: ${{ parameters.ci }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    steps:
-    - template: ./functional/ios_setup.yml
-      parameters:
-        xcodeVersion: ${{ parameters.xcodeForIOS }}
-    - template: ./functional/run_appium.yml
-    - script: bundle exec rake test:func:ios TESTS=test/functional/ios/webdriver/device_test.rb
-      displayName: Run tests func_test_ios_webdriver2
-    - template: ./functional/publish_test_result.yml
-
-  - job: func_test_ios_ios1
-    pool:
-      vmImage: ${{ parameters.vmImageForIOS }}
-    variables:
-      CI: ${{ parameters.ci }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    steps:
-    - template: ./functional/ios_setup.yml
-      parameters:
-        xcodeVersion: ${{ parameters.xcodeForIOS }}
-    - template: ./functional/run_appium.yml
-    - script: bundle exec rake test:func:ios TESTS=test/functional/ios/ios/device_test.rb
-      displayName: Run tests func_test_ios_ios1
-    - template: ./functional/publish_test_result.yml
-
-  - job: func_test_ios_ios2
-    pool:
-      vmImage: ${{ parameters.vmImageForIOS }}
-    variables:
-      CI: ${{ parameters.ci }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    steps:
-    - template: ./functional/ios_setup.yml
-      parameters:
-        xcodeVersion: ${{ parameters.xcodeForIOS }}
-    - template: ./functional/run_appium.yml
-    - script: bundle exec rake test:func:ios TESTS=test/functional/ios/ios/device_wda_attachment_test.rb,test/functional/ios/ios/search_context_test.rb
-      displayName: Run tests func_test_ios_ios2
-    - template: ./functional/publish_test_result.yml
-
-  - job: func_test_ios_ios3
-    pool:
-      vmImage: ${{ parameters.vmImageForIOS }}
-    variables:
-      CI: ${{ parameters.ci }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    steps:
-    - template: ./functional/ios_setup.yml
-      parameters:
-        xcodeVersion: ${{ parameters.xcodeForIOS }}
-    - script: brew install ffmpeg && brew tap wix/brew && brew install applesimutils
-      displayName: Install ffmpeg and applesimutils
-    - template: ./functional/run_appium.yml
-    - script: bundle exec rake test:func:ios TESTS=test/functional/ios/ios/mjpeg_server_test.rb,test/functional/ios/ios/mobile_commands_test.rb
-      displayName: Run tests func_test_ios_ios3
-    - template: ./functional/publish_test_result.yml
-
-  - job: func_test_ios_tvos
-    pool:
-      vmImage: ${{ parameters.vmImage }}
-    variables:
-      CI: ${{ parameters.ci }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    steps:
-    - template: ./functional/ios_setup.yml
-      parameters:
-        xcodeVersion: ${{ parameters.xcodeForTVOS }}
-    - template: ./functional/run_appium.yml
-    - script: bundle exec rake test:func:ios TESTS=test/functional/ios/tv_driver_test.rb
-      displayName: Run tests func_test_ios_tvos
-    - template: ./functional/publish_test_result.yml
-
-# Skip since opencv4nodejs fails to install on the macOS instance
-#  - job: func_test_ios_opencv
-#    pool:
-#      vmImage: ${{ parameters.vmImageForIOS }}
-#    variables:
-#      CI: ${{ parameters.ci }}
-#      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-#      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-#    steps:
-#      - template: ./functional/ios_setup.yml
-#        parameters:
-#          xcodeVersion: ${{ parameters.xcodeForIOS }}
-#      - template: ./functional/run_appium.yml
-#      - script: npm install -g opencv4nodejs@5.1.0
-#        displayName: Install opencv4nodejs@5.1.0
-#      - script: bundle exec rake test:func:ios test/functional/ios/ios/image_comparison_test.rb
-#        displayName: Run tests
-#      - template: ./functional/publish_test_result.yml
-
-
-  - job: func_test_android_base
-    pool:
-      vmImage: ${{ parameters.vmImage }}
-    variables:
-      CI: ${{ parameters.ci }}
-      ANDROID_SDK_VERSION: ${{ parameters.androidSDK }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    strategy:
-      matrix:
-        uiautomator2:
-          AUTOMATION_NAME_DROID: 'uiautomator2'
-        espresso:
-          AUTOMATION_NAME_DROID: 'espresso'
-    steps:
-    - template: ./functional/android_setup.yml
-    - template: ./functional/run_appium.yml
-    - script: bundle exec rake test:func:android TESTS=test/functional/android/driver_test.rb,test/functional/android/patch_test.rb
-      displayName: Run tests func_test_android_base
-    - template: ./functional/publish_test_result.yml
-
-  - job: func_test_android_webdriver
-    pool:
-      vmImage: ${{ parameters.vmImage }}
-    variables:
-      CI: ${{ parameters.ci }}
-      ANDROID_SDK_VERSION: ${{ parameters.androidSDK }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    strategy:
-      matrix:
-        uiautomator2:
-          AUTOMATION_NAME_DROID: 'uiautomator2'
-        espresso:
-          AUTOMATION_NAME_DROID: 'espresso'
-    steps:
-      - template: ./functional/android_setup.yml
-      - template: ./functional/run_appium.yml
-      - script: bundle exec rake test:func:android TESTS=test/functional/android/webdriver/create_session_test.rb,test/functional/android/webdriver/device_test.rb,test/functional/android/webdriver/w3c_actions_test.rb
-        displayName: Run tests func_test_android_webdriver
-      - template: ./functional/publish_test_result.yml
-
-  - job: func_test_android_android1
-    pool:
-      vmImage: ${{ parameters.vmImage }}
-    variables:
-      CI: ${{ parameters.ci }}
-      ANDROID_SDK_VERSION: ${{ parameters.androidSDK }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    strategy:
-      matrix:
-        uiautomator2:
-          AUTOMATION_NAME_DROID: 'uiautomator2'
-        espresso:
-          AUTOMATION_NAME_DROID: 'espresso'
-    steps:
-      - template: ./functional/android_setup.yml
-      - template: ./functional/run_appium.yml
-      - script: bundle exec rake test:func:android TESTS=test/functional/android/android/device_test.rb
-        displayName: Run tests func_test_android_android1
-      - template: ./functional/publish_test_result.yml
-
-  - job: func_test_android_android2
-    pool:
-      vmImage: ${{ parameters.vmImage }}
-    variables:
-      CI: ${{ parameters.ci }}
-      ANDROID_SDK_VERSION: ${{ parameters.androidSDK }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    strategy:
-      matrix:
-        uiautomator2:
-          AUTOMATION_NAME_DROID: 'uiautomator2'
-        espresso:
-          AUTOMATION_NAME_DROID: 'espresso'
-    steps:
-      - template: ./functional/android_setup.yml
-      - template: ./functional/run_appium.yml
-      - script: bundle exec rake test:func:android TESTS=test/functional/android/android/search_context_test.rb,test/functional/android/android/mjpeg_server_test.rb
-        displayName: Run tests func_test_android_android2
-      - template: ./functional/publish_test_result.yml
-
-  - job: func_test_android_android3
-    pool:
-      vmImage: ${{ parameters.vmImage }}
-    variables:
-      CI: ${{ parameters.ci }}
-      ANDROID_SDK_VERSION: ${{ parameters.androidSDK }}
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    strategy:
-      matrix:
-        uiautomator2:
-          AUTOMATION_NAME_DROID: 'uiautomator2'
-        espresso:
-          AUTOMATION_NAME_DROID: 'espresso'
-    steps:
-      - template: ./functional/android_setup.yml
-      - template: ./functional/run_appium.yml
-      - script: bundle exec rake test:func:android TESTS=test/functional/android/android/device_data_test.rb
-        displayName: Run tests func_test_android_android3
-      - template: ./functional/publish_test_result.yml
-
-  - job: func_test_android_mobile_command_espresso
-    pool:
-      vmImage: ${{ parameters.vmImage }}
-    variables:
-      CI: ${{ parameters.ci }}
-      ANDROID_SDK_VERSION: ${{ parameters.androidSDK }}
-      AUTOMATION_NAME_DROID: espresso
-      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-    strategy:
-      matrix:
-        uiautomator2:
-          AUTOMATION_NAME_DROID: 'uiautomator2'
-        espresso:
-          AUTOMATION_NAME_DROID: 'espresso'
-    steps:
-      - template: ./functional/android_setup.yml
-      - template: ./functional/run_appium.yml
-      - script: bundle exec rake test:func:android TESTS=test/functional/android/android/mobile_commands_test.rb
-        displayName: Run tests func_test_android_mobile_command_espresso
-      - template: ./functional/publish_test_result.yml
-
-# Skip since opencv4nodejs fails to install on the macOS instance
-#  - job: func_test_android_opencv
-#    pool:
-#      vmImage: ${{ parameters.vmImage }}
-#    variables:
-#      CI: ${{ parameters.ci }}
-#      ANDROID_SDK_VERSION: ${{ parameters.androidSDK }}
-#      IGNORE_VERSION_SKIP: ${{ parameters.ignoreVersionSkip }}
-#      APPIUM_VERSION: ${{ parameters.appiumVersion }}
-#    strategy:
-#      matrix:
-#        uiautomator2:
-#          AUTOMATION_NAME_DROID: 'uiautomator2'
-#        espresso:
-#          AUTOMATION_NAME_DROID: 'espresso'
-#    steps:
-#      - template: ./functional/android_setup.yml
-#      - template: ./functional/run_appium.yml
-#      - script: npm install -g opencv4nodejs@5.1.0
-#        displayName: Install opencv4nodejs@5.1.0
-#      - script: bundle exec rake test:func:android TESTS=test/functional/android/android/image_comparison_test.rb
-#        displayName: Run tests func_test_android_opencv
-#      - template: ./functional/publish_test_result.yml

data/docs/mobile_command.md

@@ -1,34 +0,0 @@
-# Mobile Command
-
-Appium has `mobile:` command.
-We can invoke them via `execute_script` command with `mobile:` arguments.
-
-- root:
-    - https://github.com/appium/appium/blob/master/commands-yml/commands/mobile-command.yml
-- Android:
-    - https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/android
-- iOS:
-    - https://github.com/appium/appium/tree/master/docs/en/writing-running-appium/ios
-
-
-```ruby
-# Android shell : https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/android/android-shell.md
-args = { command: 'echo', args: 'list' }
-@driver.execute_script 'mobile: shell', args # Run `adb shell echo 'list'`
-
-# iOS performance : https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/ios/ios-xctest-performance.md
-args = { timeout: 60 * 1000, profileName: 'Activity Monitor' }
-@driver.execute_script 'mobile: startPerfRecord', args
-
-@driver.execute_script 'mobile: stopPerfRecord', { profileName: 'Activity Monitor' }
-```
-
-Mobile commands return their error messages. As a selenium client, it usually handles as unknown error.
-To handle it, we would recommend you to handle the error based on the error message.
-
-```ruby
-error = assert_raises ::Selenium::WebDriver::Error::UnknownError do
-  @driver.execute_script 'mobile: scrollToPage', { element: el.id, scrollToPage: -100 }
-end
-assert error.message.include? 'be a non-negative integer'
-```