io.appium.settings 8.4.2 → 8.4.5

package/CHANGELOG.md

@@ -3,6 +3,28 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [8.4.5](https://github.com/appium/appium-android/compare/io.appium.settings@8.4.4...io.appium.settings@8.4.5) (2026-10-28)
+
+**Note:** Version bump only for package io.appium.settings
+
+
+
+
+
+## [8.4.4](https://github.com/appium/appium-android/compare/io.appium.settings@8.4.3...io.appium.settings@8.4.4) (2026-10-23)
+
+### Bug Fixes
+
+* **adb:** use AsyncLock from asyncbox instead of async-lock ([#45](https://github.com/appium/appium-android/issues/45)) ([fe41904](https://github.com/appium/appium-android/commit/fe4190403e1bc3f66a2ead346caf7eb16002626b))
+
+
+## [8.4.3](https://github.com/appium/appium-android/compare/io.appium.settings@8.4.2...io.appium.settings@8.4.3) (2026-10-23)
+
+### Miscellaneous Chores
+
+* **deps:** bump gradle-wrapper in /packages/settings ([#43](https://github.com/appium/appium-android/issues/43)) ([0e5c018](https://github.com/appium/appium-android/commit/0e5c0183b6d5c3a667d9c782ace729f71e00a2a2))
+
+
 ## [8.4.2](https://github.com/appium/appium-android/compare/io.appium.settings@8.4.1...io.appium.settings@8.4.2) (2026-10-17)
 
 ### Miscellaneous Chores

package/README.md

@@ -40,7 +40,7 @@ You may also consider using the latest [Android Studio](https://developer.androi
 ### Enable access to non-SDK interfaces
 
 [Restrictions on non-SDK interfaces](https://developer.android.com/guide/app-compatibility/restrictions-non-sdk-interfaces#test-for-non-sdk) could affect some functionalities.
-Changing of the system locale in API Level 34 or later demonstrates the above restriction. Please [enable access to non-SDK interfaces](https://developer.android.com/guide/app-compatibility/restrictions-non-sdk-interfaces#how_can_i_enable_access_to_non-sdk_interfaces) via `adb`. [This issue comment](https://github.com/appium/io.appium.settings/issues/180#issuecomment-2156279885) is adb logcat output when the non-SDK interfaces are enabled, or disabled (system default). Please try out a device reboot if the same logcat continues even after setting the hidden api policy.
+Changing of the system locale in API Level 34 or later demonstrates the above restriction. Please [enable access to non-SDK interfaces](https://developer.android.com/guide/app-compatibility/restrictions-non-sdk-interfaces#how_can_i_enable_access_to_non-sdk_interfaces) via `adb`. [This issue comment](https://github.com/appium/io.appium.settings/issues/180#issuecomment-2156279885) is adb logcat output when the non-SDK interfaces are enabled, or disabled (system default). If `io.appium.settings` was already running before the hidden API policy was updated, restart the app process (`adb shell am force-stop io.appium.settings && adb shell am start -n io.appium.settings/.Settings -a android.intent.action.MAIN -c android.intent.category.LAUNCHER`) or reboot the device so the updated policy takes effect.
 
 ## Building
 
@@ -72,7 +72,7 @@ $ adb uninstall io.appium.settings
 
 ## Using the JavaScript wrapper
 
-This module exports the [SettingsApp](./lib/client.js) class, which allows you to automate the below interactions with JavaScript.
+This module exports the [SettingsApp](./lib/client.ts) class, which allows you to automate the below interactions with JavaScript.
 The wrapper expects you to also have the [appium-adb](https://github.com/appium/appium-adb) module listed
 in your dependencies. The actual version of the appium-adb module must satisfy the same semver requirement this module
 has in its [devDependencies](./package.json).
@@ -104,7 +104,7 @@ main();
 ```
 
 The module also exports various constants containing its service and action names, that could be useful in your
-scripts. Check [constants.js](./lib/constants.js) for more details.
+scripts. Check [constants.ts](./lib/constants.ts) for more details.
 
 ## Changing of system settings
 
@@ -291,8 +291,9 @@ $ adb shell am broadcast -a io.appium.settings.notifications
 The notifications listener service is running in the background and collects
 all the active and newly created notifications into the internal buffer with maximum
 size of `100`. The collected data (e.g. the properties and texts of each notification)
-is returned as JSON-formatted string. An error description string is returned instead if the
-notifications list cannot be retrieved.
+is returned as JSON-formatted string (with `result=-1`, which corresponds to Android's
+`Activity.RESULT_OK` on ordered broadcasts). An error description string is returned with
+`result=0` (`Activity.RESULT_CANCELED`) if the notifications list cannot be retrieved.
 The example of the resulting data:
 ```json
 {
@@ -434,7 +435,7 @@ either a sequence of JPEG frames or an H.264/HEVC video (with an optional interl
 audio track), instead of writing a file. This is a **raw local-socket protocol**, not an
 HTTP/MJPEG server: the app opens a local abstract socket on-device, and the consumer is
 expected to `adb forward` it to a host TCP port and parse the (simple, length-prefixed)
-frame protocol itself. The [SettingsApp](./lib/client.js) wrapper (`makeJpegStreamSession()` /
+frame protocol itself. The [SettingsApp](./lib/client.ts) wrapper (`makeJpegStreamSession()` /
 `makeVideoStreamSession()`) already does this for you and is the recommended way to consume
 either stream; talking to the socket directly is only needed for other languages/tools.
 
@@ -562,7 +563,7 @@ Voila!
 
 ## Caveats
 
-There are certain system services which cannot be accessed through an application. Two ones central here are `airplane_mode` and `gps`.
+There are certain system services which cannot be accessed through an application. Two ones central here are `airplane_mode` and `gps`. Wi-Fi hotspot (tethering) is also not managed by Appium Settings; on supported Android versions it can be invoked via `adb shell cmd wifi start-softap`.
 
 
 ## License

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "io.appium.settings",
-  "version": "8.4.2",
+  "version": "8.4.5",
   "description": "App for dealing with Android settings",
   "keywords": [
     "android",
@@ -51,7 +51,7 @@
   },
   "dependencies": {
     "@appium/logger": "^2.0.0-rc.1",
-    "asyncbox": "^6.0.1",
+    "asyncbox": "^6.5.0",
     "semver": "^7.5.4",
     "teen_process": "^4.0.4"
   },
@@ -60,12 +60,12 @@
     "@appium/types": "^1.0.0-rc.1",
     "@types/node": "^26.6.5",
     "@types/sinon": "^22.0.0",
-    "appium-adb": "^16.1.0",
+    "appium-adb": "^16.1.2",
     "sinon": "^22.0.0"
   },
   "engines": {
     "node": "^20.19.0 || ^22.12.0 || >=24.0.0",
     "npm": ">=10"
   },
-  "gitHead": "d57a84b179d512c372791da430dcea62610f7864"
+  "gitHead": "dd7fac6576be570d54de8ff2874b88426b4446dd"
 }