appium-espresso-driver 3.3.1 → 3.5.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [3.5.0](https://github.com/appium/appium-espresso-driver/compare/v3.4.0...v3.5.0) (2024-09-23)
+
+### Features
+
+* Document mobile geolocation APIs ([#1029](https://github.com/appium/appium-espresso-driver/issues/1029)) ([a288990](https://github.com/appium/appium-espresso-driver/commit/a288990f5d90720969d2be25c782e883b7a071c7))
+
+## [3.4.0](https://github.com/appium/appium-espresso-driver/compare/v3.3.1...v3.4.0) (2024-09-17)
+
+### Features
+
+* Bump android driver ([#1028](https://github.com/appium/appium-espresso-driver/issues/1028)) ([0207af4](https://github.com/appium/appium-espresso-driver/commit/0207af4ce96b948b25969f612c57220ce8f5a5e1))
+
 ## [3.3.1](https://github.com/appium/appium-espresso-driver/compare/v3.3.0...v3.3.1) (2024-07-31)
 
 ### Bug Fixes

package/README.md

@@ -817,6 +817,37 @@ Name | Type | Required | Description | Example
 --- | --- | --- | --- | ---
 timeoutMs | number | no | The maximum number of milliseconds to block until GPS cache is refreshed. If the API call does not receive a confirmation about successful cache refresh within this timeout then an error is thrown. Providing zero or a negative value to it skips waiting completely and does not check for any errors. 20000 ms by default. | 60000
 
+### mobile: setGeolocation
+
+Sets emulated geolocation coordinates on the device under test.
+
+#### Arguments
+
+Name | Type | Required | Description | Example
+--- | --- | --- | --- | ---
+latitude | number | yes | [Latitude](https://en.wikipedia.org/wiki/Latitude) value | 32.456
+longitude | number | yes | [longitude](https://en.wikipedia.org/wiki/Longitude) value | 32.456
+altitude | number | no | [Altitude](https://en.wikipedia.org/wiki/Altitude) value. Zero by default | 5.678
+
+### mobile: getGeolocation
+
+Retrieves current geolocation coordinates from the device under test. If coordinates are mocked/emulated
+then these coordinates would be returned.
+
+#### Returned Result
+
+A map with the following entries:
+
+Name | Type | Description | Example
+--- | --- | --- | ---
+latitude | number | [Latitude](https://en.wikipedia.org/wiki/Latitude) value | 32.456
+longitude | number | [longitude](https://en.wikipedia.org/wiki/Longitude) value | 32.456
+altitude | number | [Altitude](https://en.wikipedia.org/wiki/Altitude) value | 5.678
+
+### mobile: resetGeolocation
+
+Resets mocked geolocation provider to the default/system one. Only works for real devices.
+
 ### mobile: pullFile
 
 Pulls a remote file from the device.

package/espresso-server/library/src/main/java/io/appium/espressoserver/lib/helpers/Version.kt

@@ -2,6 +2,6 @@ package io.appium.espressoserver.lib.helpers
 
 // This value is updated automatically by the NPM versioning script
 // It should be in sync with the NPM module version from package.json
-private const val VERSION = "3.3.1"
+private const val VERSION = "3.5.0"
 
 fun getEspressoServerVersion() = VERSION