From 1c334a403c74de7f99e7012d3c976ea043ce91c4 Mon Sep 17 00:00:00 2001 From: shreybansal-lambdatest Date: Thu, 27 Mar 2025 21:52:31 +0530 Subject: [PATCH 1/2] gpsLocation capability update --- docs/espresso-supported-capabilities.md | 1 + docs/getting-started-with-flutter-dart-android-automation.md | 1 + docs/getting-started-with-flutter-dart-ios-automation.md | 1 + docs/xcui-supported-capibilities.md | 3 ++- 4 files changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/espresso-supported-capabilities.md b/docs/espresso-supported-capabilities.md index 0e7475f17..4a9ebac88 100644 --- a/docs/espresso-supported-capabilities.md +++ b/docs/espresso-supported-capabilities.md @@ -61,6 +61,7 @@ This document provide details about the features and capabilities supported for | network.har | Boolean | To generate the network logs in .har format, pass the value as `network.har: true` only works with `network:true` | | build | String | To set the Espresso build name. Example: `build: My Espresso Build`. | | geoLocation | String | Set the geolocation country code if you want to enable the same in your test. Example - `geoLocation: FR`| +| gpsLocation | String & Float | The capability should be defined to override the device’s default GPS coordinates and should be provided as a comma-separated string. Example: `"gpsLocation": "-73.935242,40.730610"`.| | tunnel, tunnelName | Boolean | To activate the tunnel mode, pass the value as `tunnel: true` and provide the name of your tunnel as `tunnelName: NewTunnel` | | disableAnimation | Boolean | Set this to `true` if you want to disable animations for espresso tests. **Default:** `false` | | clearPackageData | Boolean | Set this to `true` if you want to clear the app data after each test has completed running. **Default**: `false` | diff --git a/docs/getting-started-with-flutter-dart-android-automation.md b/docs/getting-started-with-flutter-dart-android-automation.md index 9bd10b7fa..3dbd07872 100644 --- a/docs/getting-started-with-flutter-dart-android-automation.md +++ b/docs/getting-started-with-flutter-dart-android-automation.md @@ -283,6 +283,7 @@ The following capabilities are supported: 7. **deviceLog:** Boolean value to generate device logs. Example: `true`. 8. **build:** Set the name of your Flutter test build. Example: `My Flutter Build`. 9. **autoGrantPermissions:** Boolean value to automatically grant the required permissions based on the [Android manifest](https://developer.android.com/guide/topics/manifest/manifest-intro) in the app’s **.apk** Example: `true`. +10. **gpsLocation:** This capability should be defined to override the device’s default GPS coordinates and should be provided as a comma-separated string. Example: `"gpsLocation": "-73.935242,40.730610"`. diff --git a/docs/getting-started-with-flutter-dart-ios-automation.md b/docs/getting-started-with-flutter-dart-ios-automation.md index 51e69bcc2..af48f35e4 100644 --- a/docs/getting-started-with-flutter-dart-ios-automation.md +++ b/docs/getting-started-with-flutter-dart-ios-automation.md @@ -183,6 +183,7 @@ The following capabilities are supported: 8. **tunnel:** Boolean value to run build via Tunnel. Example: `true`. 9. **tunnelName:** Name of the tunnel to be used in conjunction with `tunnel` capability. 10. **region:** String to device the region from which device will be allocated. Example - `eu`,`us`,`ap`. +11. **gpsLocation:** This capability should be defined to override the device’s default GPS coordinates and should be provided as a comma-separated string. Example: `"gpsLocation": "-73.935242,40.730610"`. ## Running Tests in Parallel diff --git a/docs/xcui-supported-capibilities.md b/docs/xcui-supported-capibilities.md index 197bf0494..fd85f97ea 100644 --- a/docs/xcui-supported-capibilities.md +++ b/docs/xcui-supported-capibilities.md @@ -59,7 +59,8 @@ This document provide details about the features and capabilities supported for | deviceLog | Boolean | To generate the device logs, pass the value as `deviceLog: true` | | network | String | To generate the network logs, pass the value as `network: true`. | | build | String | To set the Espresso build name. Example: `build: My Espresso Build`. | -| geoLocation | String | Set the geolocation country code if you want to enable the same in your test. Example - `geoLocation: FR`| +| geoLocation | String | Set the geolocation country code if you want to enable the same in your test. Example: `geoLocation: FR`| +| gpsLocation | String & Float | The capability should be defined to override the device’s default GPS coordinates and should be provided as a comma-separated string. Example: `"gpsLocation": "-73.935242,40.730610"`.| | tunnel, tunnelName | Boolean | To activate the tunnel mode, pass the value as `tunnel: true` and provide the name of your tunnel as `tunnelName: NewTunnel` | | resignApp

Not supported in **Virtual Devices** | Boolean | Set this to `false` if you want to to prevent the apps from being re-signed. The app should be built for enterprise distribution. | From 45e7d76d6b1a030a608bbcdbf85af5facc0144df Mon Sep 17 00:00:00 2001 From: shreybansal-lambdatest Date: Thu, 27 Mar 2025 22:18:22 +0530 Subject: [PATCH 2/2] updated gpslocation with note and correct data type --- docs/espresso-supported-capabilities.md | 8 +++++++- ...etting-started-with-flutter-dart-android-automation.md | 5 ++++- docs/getting-started-with-flutter-dart-ios-automation.md | 6 +++++- docs/xcui-supported-capibilities.md | 6 +++++- 4 files changed, 21 insertions(+), 4 deletions(-) diff --git a/docs/espresso-supported-capabilities.md b/docs/espresso-supported-capabilities.md index 4a9ebac88..aa7530b37 100644 --- a/docs/espresso-supported-capabilities.md +++ b/docs/espresso-supported-capabilities.md @@ -61,11 +61,17 @@ This document provide details about the features and capabilities supported for | network.har | Boolean | To generate the network logs in .har format, pass the value as `network.har: true` only works with `network:true` | | build | String | To set the Espresso build name. Example: `build: My Espresso Build`. | | geoLocation | String | Set the geolocation country code if you want to enable the same in your test. Example - `geoLocation: FR`| -| gpsLocation | String & Float | The capability should be defined to override the device’s default GPS coordinates and should be provided as a comma-separated string. Example: `"gpsLocation": "-73.935242,40.730610"`.| +| gpsLocation | Decimal | The capability should be defined to override the device’s default GPS coordinates and should be provided as a comma-separated string. Example: `"location": {"lat": "-50","long": "150.028333"}`| | tunnel, tunnelName | Boolean | To activate the tunnel mode, pass the value as `tunnel: true` and provide the name of your tunnel as `tunnelName: NewTunnel` | | disableAnimation | Boolean | Set this to `true` if you want to disable animations for espresso tests. **Default:** `false` | | clearPackageData | Boolean | Set this to `true` if you want to clear the app data after each test has completed running. **Default**: `false` | | singleRunnerInvocation | Boolean | Set this to `true` if you want to execute test cases together with a `single test runner invocation`.This can help significantly speed up the test execution time. By default, each test case is invoked separately. **Default:** `false` | + +:::note +Ensure that the latitude is between -90 and 90, and the longitude is between -180 and 180. Otherwise, an error will occur like "Invalid GPS location: Latitude must be between -90 and +90, Longitude must be between -180 and +180." +::: + + :::caution Important You can either use **GeoLocation** or **Tunnel** in single execute command. They both are mutually exclusive. diff --git a/docs/getting-started-with-flutter-dart-android-automation.md b/docs/getting-started-with-flutter-dart-android-automation.md index 3dbd07872..0576c3933 100644 --- a/docs/getting-started-with-flutter-dart-android-automation.md +++ b/docs/getting-started-with-flutter-dart-android-automation.md @@ -283,8 +283,11 @@ The following capabilities are supported: 7. **deviceLog:** Boolean value to generate device logs. Example: `true`. 8. **build:** Set the name of your Flutter test build. Example: `My Flutter Build`. 9. **autoGrantPermissions:** Boolean value to automatically grant the required permissions based on the [Android manifest](https://developer.android.com/guide/topics/manifest/manifest-intro) in the app’s **.apk** Example: `true`. -10. **gpsLocation:** This capability should be defined to override the device’s default GPS coordinates and should be provided as a comma-separated string. Example: `"gpsLocation": "-73.935242,40.730610"`. +10. **gpsLocation:** This capability should be defined to override the device’s default GPS coordinates and should be provided as a comma-separated string. Example: `"location": {"lat": "-50","long": "150.028333"}`. +:::note +Ensure that the latitude is between -90 and 90, and the longitude is between -180 and 180. Otherwise, an error will occur like "Invalid GPS location: Latitude must be between -90 and +90, Longitude must be between -180 and +180." +::: ## Running Tests in Parallel diff --git a/docs/getting-started-with-flutter-dart-ios-automation.md b/docs/getting-started-with-flutter-dart-ios-automation.md index af48f35e4..59604dce6 100644 --- a/docs/getting-started-with-flutter-dart-ios-automation.md +++ b/docs/getting-started-with-flutter-dart-ios-automation.md @@ -183,7 +183,11 @@ The following capabilities are supported: 8. **tunnel:** Boolean value to run build via Tunnel. Example: `true`. 9. **tunnelName:** Name of the tunnel to be used in conjunction with `tunnel` capability. 10. **region:** String to device the region from which device will be allocated. Example - `eu`,`us`,`ap`. -11. **gpsLocation:** This capability should be defined to override the device’s default GPS coordinates and should be provided as a comma-separated string. Example: `"gpsLocation": "-73.935242,40.730610"`. +11. **gpsLocation:** This capability should be defined to override the device’s default GPS coordinates and should be provided as a comma-separated string. Example: `"location": {"lat": "-50","long": "150.028333"}`. + +:::note +Ensure that the latitude is between -90 and 90, and the longitude is between -180 and 180. Otherwise, an error will occur like "Invalid GPS location: Latitude must be between -90 and +90, Longitude must be between -180 and +180." +::: ## Running Tests in Parallel diff --git a/docs/xcui-supported-capibilities.md b/docs/xcui-supported-capibilities.md index fd85f97ea..4b90cc062 100644 --- a/docs/xcui-supported-capibilities.md +++ b/docs/xcui-supported-capibilities.md @@ -60,10 +60,14 @@ This document provide details about the features and capabilities supported for | network | String | To generate the network logs, pass the value as `network: true`. | | build | String | To set the Espresso build name. Example: `build: My Espresso Build`. | | geoLocation | String | Set the geolocation country code if you want to enable the same in your test. Example: `geoLocation: FR`| -| gpsLocation | String & Float | The capability should be defined to override the device’s default GPS coordinates and should be provided as a comma-separated string. Example: `"gpsLocation": "-73.935242,40.730610"`.| +| gpsLocation | Decimal | The capability should be defined to override the device’s default GPS coordinates and should be provided as a comma-separated string. Example: `"location": {"lat": "-50","long": "150.028333"}`.| | tunnel, tunnelName | Boolean | To activate the tunnel mode, pass the value as `tunnel: true` and provide the name of your tunnel as `tunnelName: NewTunnel` | | resignApp

Not supported in **Virtual Devices** | Boolean | Set this to `false` if you want to to prevent the apps from being re-signed. The app should be built for enterprise distribution. | +:::note +Ensure that the latitude is between -90 and 90, and the longitude is between -180 and 180. Otherwise, an error will occur like "Invalid GPS location: Latitude must be between -90 and +90, Longitude must be between -180 and +180." +::: + :::caution Important You can either use **GeoLocation** or **Tunnel** in single execute command. They both are mutually exclusive. ::: \ No newline at end of file