Skip to content

Commit

Permalink
Merge branch 'main' into android-doc-custom-logger
Browse files Browse the repository at this point in the history
  • Loading branch information
BartoszLitwiniuk authored Sep 4, 2024
2 parents b1f916e + 93a0f43 commit 15db72b
Show file tree
Hide file tree
Showing 3 changed files with 13 additions and 10 deletions.
2 changes: 1 addition & 1 deletion docs/dev/test-configuration-options.md
Original file line number Diff line number Diff line change
Expand Up @@ -1702,7 +1702,7 @@ driver.executeScript("sauce: network-conditions", ImmutableMap.of(
Execute ADB shell commands, through Appium's `mobile: shell` capability.

:::note
Sauce Labs now supports ADB commands for Appium. To use ADB and `mobile: shell` commands, please [sign up for our BETA through this form](https://forms.gle/42qv8U1RukqC62x86) and indicate the desired ADB commands you would like to run. We will be supporting a limited list of ADB commands through `mobile: shell`. Please refer to the list of [allowed commands](https://docs.saucelabs.com/mobile-apps/mobile-faq/#im-encountering-errors-when-executing-adb-shell-commands-what-could-be-the-issue) or contact support for assistance.
Sauce Labs now supports ADB commands for Appium. We are supporting a limited list of ADB commands through `mobile: shell`. Please refer to the list of [allowed commands](/mobile-apps/mobile-faq/#im-encountering-errors-when-executing-adb-shell-commands-what-could-be-the-issue) or contact support for assistance.
:::


Expand Down
14 changes: 11 additions & 3 deletions docs/mobile-apps/mobile-faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,7 @@ Yes, by using virtual USB, but only on private Android devices. Currently, iOS d
#### **I'm encountering errors when executing ADB shell commands. What could be the issue?**

If you're facing challenges with ADB shell commands during your automated Appium tests, ensure that you are using the
[mobile: shell script](https://docs.saucelabs.com/dev/test-configuration-options/#mobile-shell) correctly.
[mobile: shell script](/dev/test-configuration-options/#mobile-shell) correctly.

We maintain an allowlist of commands that can be executed within our Real Device Cloud. Please refer to the list of allowed commands to ensure compatibility:
* am start
Expand All @@ -86,13 +86,21 @@ We maintain an allowlist of commands that can be executed within our Real Device
* getprop
* am compat enable
* cmd connectivity airplane-mode (enable|disable)
* settings put global (animator_duration_scale|transition_animation_scale|window_animation_scale) {`<value>`}
* setprop debug.firebase.analytics.app {`<value>`}
* settings put global (animator_duration_scale|transition_animation_scale|window_animation_scale) {`<VALUE>`}
* setprop debug.firebase.analytics.app {`<VALUE>`}
* setprop (log.tag.FA|log.tag.FA-SVC) (ERROR|WARN|INFO|DEBUG|VERBOSE)
* setprop (log.tag.FA|log.tag.FA-SVC|log.tag.GAv4|log.tag.GAv4-SVC) (ERROR|WARN|INFO|DEBUG|VERBOSE)
* appops set {`<PACKAGE_NAME>`} REQUEST_INSTALL_PACKAGES allow

If the command you require is not listed, you can submit a request through this [form](https://docs.google.com/forms/d/1t4MCf6ClHlLxX80RP5bNU9wVJBhQOd4ll6IjP0ecMgc)
or reach out to your Customer Success Manager or Sauce Labs Support for assistance.

:::note Appium alternatives

- am broadcast: use [mobile: broadcast](https://github.com/appium/appium-uiautomator2-driver?tab=readme-ov-file#mobile-broadcast)

:::

### Security

#### **Is my app safe in the Real Device Cloud?**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -34,12 +34,7 @@ Sauce Connect Proxy can be configured using:
* Command line arguments.

All of these options are supported in containers, and you can use them interchangeably.

:::note
At the moment `api-address` may only be specified as environment variable `SAUCE_API_ADDRESS`, and not in the configuration file.
See [Sauce Connect Proxy API Server](/secure-connections/sauce-connect-5/operation/api-server#docker) for more information.
:::


### Configuration file

To use a configuration file, mount the file to the container at `/etc/sauce-connect/sauce-connect.yaml`.
Expand Down

0 comments on commit 15db72b

Please sign in to comment.