appium-uiautomator2-driver 2.9.0 → 2.9.1

package/README.md

@@ -102,7 +102,7 @@ appium:buildToolsVersion | The version of Android build tools to use. By default
 appium:skipLogcatCapture | Being set to `true` disables automatic logcat output collection during the test run. `false` by default
 appium:suppressKillServer | Being set to `true` prevents the driver from ever killing the ADB server explicitly. Could be useful if ADB is connected wirelessly. `false` by default
 appium:ignoreHiddenApiPolicyError | Being set to `true` ignores a failure while changing hidden API access policies. Could be useful on some devices, where access to these policies has been locked by its vendor. `false` by default.
-appium:mockLocationApp | Sets the package identifier of the app, which is used as a system mock location provider since Appium 1.18.0+. This capability has no effect on emulators. If the value is set to `null` or an empty string, then Appium will skip the mocked location provider setup procedure. Defaults to Appium Setting package identifier (`io.appium.settings`).
+appium:mockLocationApp | Sets the package identifier of the app, which is used as a system mock location provider since Appium 1.18.0+. This capability has no effect on emulators. If the value is set to `null` or an empty string, then Appium will skip the mocked location provider setup procedure. Defaults to Appium Setting package identifier (`io.appium.settings`). Termination of a mock location provider application resets the mocked location data.
 appium:logcatFormat | The log print format, where `format` is one of: `brief` `process` `tag` `thread` `raw` `time` `threadtime` `long`. `threadtime` is the default value.
 appium:logcatFilterSpecs | Series of `tag[:priority]` where `tag` is a log component tag (or * for all) and priority is: `V    Verbose`, `D    Debug`, `I    Info`, `W    Warn`, `E    Error`, `F    Fatal`, `S    Silent (supress all output)`. '*' means '*:d' and `tag` by itself means `tag:v`. If not specified on the commandline, filterspec is set from ANDROID_LOG_TAGS. If no filterspec is found, filter defaults to '*:I'.
 appium:allowDelayAdb | Being set to `false` prevents emulator to use `-delay-adb` feature to detect its startup. See https://github.com/appium/appium/issues/14773 for more details.
@@ -1214,7 +1214,7 @@ happens. Add a timer and wait for a couple of seconds before giving up on the el
 still fails after the timeout and your non-xpath locator is used then, most likely, it contains a typo, or the
 destination element is not present. There is not much that could be done in UIA2 to change/influence that, since it passes such lookup calls directly to Google's UiAutomator framework.
 
-In case of xpath locators you could also try to change values of the following settings:
+In case of _xpath_ locators you could try to change values of the following settings:
 
 1. [allowInvisibleElements](#settings-api)
 2. [ignoreUnimportantViews](#settings-api)
@@ -1229,6 +1229,12 @@ that are normally hidden, because of their unimportance.
 
 The third setting being set to `true` extends the page source by adding the actual content of other windows that are currently present on the device's screen. For example, the on-screen keyboard in Android is not a part of the current app hierarchy, but rather belongs to a separate window.
 
+In case of _id_ locators you could try to change the value of the following setting:
+
+1. [disableIdLocatorAutocompletion](#settings-api)
+
+The general resources naming convention for Android apps is `<app_id>:id/<resource_name>`. This should guarantee uniqueness of each identifier accross the user interface. Although, this is only a convention and it is still allowed to have various resource names that do not follow it. If you have gotten one of such applications for automated testing then consider assigning `disableIdLocatorAutocompletion` setting value to `true`, so UiAutomator2 driver does not automatically rewrite supplied id values by adding `<app_id>:id/` prefixes to them.
+
 > **Warning**
 > Default values for settings above have been selected to optimize xpath lookup and page source generation performance.
 > Having these settings always different from their default values may sometimes significantly (especially in case of huge accessbility hierarchies) reduce xpath lookup and page source generation speed.
@@ -1236,6 +1242,10 @@ The third setting being set to `true` extends the page source by adding the actu
 > **Warning**
 > All items above are settings, not capabilities.
 
+### ClassCastException: java.util.ArrayList$ListItr cannot be cast to org.eclipse.wst.xml.xpath2.processor
+
+This exception happens due to a known bug in the [Eclipse's Psychopath](https://wiki.eclipse.org/PsychoPathXPathProcessor) library used by UiAutomator2 driver to support [XPath2](https://www.w3.org/TR/xpath20/) syntax. The issue has been observed while using `following::` or `preceding::` axes in xpath queries. Unfortunately, this library has not been maintained for quite a while, and there is no good open source alternative to it. The only known workaround would be to forcefully switch the driver's XPath processor to the standard Android's Apache Harmony-based XPath1, which does not have this issue (but also does not support XPath2 syntax). See the Appium issue [#16142](https://github.com/appium/appium/issues/16142#issuecomment-1003954166) for more details.
+
 
 ## Usage Examples
 

package/npm-shrinkwrap.json

@@ -1,16 +1,16 @@
 {
   "name": "appium-uiautomator2-driver",
-  "version": "2.9.0",
+  "version": "2.9.1",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "appium-uiautomator2-driver",
-      "version": "2.9.0",
+      "version": "2.9.1",
       "license": "Apache-2.0",
       "dependencies": {
         "@babel/runtime": "^7.0.0",
-        "appium-adb": "^9.10.9",
+        "appium-adb": "^9.10.14",
         "appium-android-driver": "^5.6.0",
         "appium-chromedriver": "^5.2.1",
         "appium-uiautomator2-server": "^5.7.0",
@@ -265,7 +265,7 @@
       }
     },
     "node_modules/@babel/parser": {
-      "version": "7.19.4",
+      "version": "7.20.0",
       "extraneous": true,
       "license": "MIT",
       "bin": {
@@ -276,10 +276,10 @@
       }
     },
     "node_modules/@babel/runtime": {
-      "version": "7.19.4",
+      "version": "7.20.0",
       "license": "MIT",
       "dependencies": {
-        "regenerator-runtime": "^0.13.4"
+        "regenerator-runtime": "^0.13.10"
       },
       "engines": {
         "node": ">=6.9.0"
@@ -961,7 +961,7 @@
       }
     },
     "node_modules/@types/node": {
-      "version": "18.11.2",
+      "version": "18.11.7",
       "license": "MIT"
     },
     "node_modules/@types/normalize-package-data": {
@@ -1167,7 +1167,7 @@
       "license": "MIT"
     },
     "node_modules/appium-adb": {
-      "version": "9.10.12",
+      "version": "9.10.14",
       "license": "Apache-2.0",
       "dependencies": {
         "@appium/support": "^2.60.0",
@@ -1190,7 +1190,7 @@
       }
     },
     "node_modules/appium-android-driver": {
-      "version": "5.6.0",
+      "version": "5.7.0",
       "license": "Apache-2.0",
       "dependencies": {
         "@babel/runtime": "^7.0.0",
@@ -1222,7 +1222,7 @@
       }
     },
     "node_modules/appium-chromedriver": {
-      "version": "5.2.4",
+      "version": "5.2.5",
       "hasInstallScript": true,
       "license": "Apache-2.0",
       "dependencies": {
@@ -1248,7 +1248,7 @@
       }
     },
     "node_modules/appium-uiautomator2-server": {
-      "version": "5.7.0",
+      "version": "5.7.1",
       "license": "Apache-2.0",
       "engines": {
         "node": ">=14",
@@ -1312,6 +1312,10 @@
         "url": "https://github.com/sponsors/isaacs"
       }
     },
+    "node_modules/archiver-utils/node_modules/isarray": {
+      "version": "1.0.0",
+      "license": "MIT"
+    },
     "node_modules/archiver-utils/node_modules/readable-stream": {
       "version": "2.3.7",
       "license": "MIT",
@@ -2672,7 +2676,7 @@
       }
     },
     "node_modules/io.appium.settings": {
-      "version": "4.2.1",
+      "version": "4.2.2",
       "license": "Apache-2.0",
       "engines": {
         "node": ">=14",
@@ -2882,10 +2886,6 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
-    "node_modules/isarray": {
-      "version": "1.0.0",
-      "license": "MIT"
-    },
     "node_modules/isexe": {
       "version": "2.0.0",
       "license": "ISC"
@@ -3040,6 +3040,10 @@
         "node": ">= 0.6.3"
       }
     },
+    "node_modules/lazystream/node_modules/isarray": {
+      "version": "1.0.0",
+      "license": "MIT"
+    },
     "node_modules/lazystream/node_modules/readable-stream": {
       "version": "2.3.7",
       "license": "MIT",
@@ -5039,7 +5043,7 @@
       "license": "ISC"
     },
     "node_modules/ws": {
-      "version": "8.9.0",
+      "version": "8.10.0",
       "license": "MIT",
       "engines": {
         "node": ">=10.0.0"
@@ -5325,13 +5329,13 @@
       }
     },
     "@babel/parser": {
-      "version": "7.19.4",
+      "version": "7.20.0",
       "extraneous": true
     },
     "@babel/runtime": {
-      "version": "7.19.4",
+      "version": "7.20.0",
       "requires": {
-        "regenerator-runtime": "^0.13.4"
+        "regenerator-runtime": "^0.13.10"
       }
     },
     "@colors/colors": {
@@ -5805,7 +5809,7 @@
       }
     },
     "@types/node": {
-      "version": "18.11.2"
+      "version": "18.11.7"
     },
     "@types/normalize-package-data": {
       "version": "2.4.1"
@@ -5947,7 +5951,7 @@
       "version": "1.1.0"
     },
     "appium-adb": {
-      "version": "9.10.12",
+      "version": "9.10.14",
       "requires": {
         "@appium/support": "^2.60.0",
         "@babel/runtime": "^7.0.0",
@@ -5965,7 +5969,7 @@
       }
     },
     "appium-android-driver": {
-      "version": "5.6.0",
+      "version": "5.7.0",
       "requires": {
         "@babel/runtime": "^7.0.0",
         "appium-adb": "^9.10.9",
@@ -5989,7 +5993,7 @@
       }
     },
     "appium-chromedriver": {
-      "version": "5.2.4",
+      "version": "5.2.5",
       "requires": {
         "@babel/runtime": "^7.0.0",
         "@xmldom/xmldom": "^0.x",
@@ -6006,7 +6010,7 @@
       }
     },
     "appium-uiautomator2-server": {
-      "version": "5.7.0"
+      "version": "5.7.1"
     },
     "aproba": {
       "version": "2.0.0"
@@ -6049,6 +6053,9 @@
             "path-is-absolute": "^1.0.0"
           }
         },
+        "isarray": {
+          "version": "1.0.0"
+        },
         "readable-stream": {
           "version": "2.3.7",
           "requires": {
@@ -6943,7 +6950,7 @@
       }
     },
     "io.appium.settings": {
-      "version": "4.2.1"
+      "version": "4.2.2"
     },
     "ipaddr.js": {
       "version": "1.9.1",
@@ -7051,9 +7058,6 @@
         "call-bind": "^1.0.2"
       }
     },
-    "isarray": {
-      "version": "1.0.0"
-    },
     "isexe": {
       "version": "2.0.0"
     },
@@ -7172,6 +7176,9 @@
         "readable-stream": "^2.0.5"
       },
       "dependencies": {
+        "isarray": {
+          "version": "1.0.0"
+        },
         "readable-stream": {
           "version": "2.3.7",
           "requires": {
@@ -8490,7 +8497,7 @@
       "version": "1.0.2"
     },
     "ws": {
-      "version": "8.9.0",
+      "version": "8.10.0",
       "requires": {}
     },
     "xhr": {

package/package.json

@@ -7,7 +7,7 @@
     "automated testing",
     "android"
   ],
-  "version": "2.9.0",
+  "version": "2.9.1",
   "author": "Appium Contributors",
   "license": "Apache-2.0",
   "repository": {
@@ -55,7 +55,7 @@
   ],
   "dependencies": {
     "@babel/runtime": "^7.0.0",
-    "appium-adb": "^9.10.9",
+    "appium-adb": "^9.10.14",
     "appium-android-driver": "^5.6.0",
     "appium-chromedriver": "^5.2.1",
     "appium-uiautomator2-server": "^5.7.0",