Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
pr4bh4sh authored Oct 20, 2023
1 parent 1c91c08 commit bfbcfb5
Showing 1 changed file with 20 additions and 12 deletions.
32 changes: 20 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,33 @@
# adb-wifi-setting-manager
Control wifi connection with adb

Here's some usecases
1. Switch between wifi network when running automation tests without manual intervention.
2. You have 2 wifi network, one fast one slow and you want to create automated tests for the app's behaviour on low bandwidth.
3. You have two wifi network, one is in internal network and other outside of internal network and you want to test the app behaviour on both network.
4. You have several wifi networks, and you are too lazy to type it the wifi passwords everytime you setup a new Android phone. Just create a shell script or copy paste the command to setup the new device.
Here are some use-cases
1. Switch between wifi networks when running automation tests without manual intervention.
2. You have 2 wifi networks, one fast and one slow and you want to create automated tests for the app's behaviour on low bandwidth.
3. You have two Wi-Fi networks, one in the internal network and the other outside the internal network, and you want to test the app behaviour on both networks.
4. You have several wifi networks, and you are too lazy to type the wifi passwords every time you set up a new Android phone. Just create a shell script or copy-paste the command to set up the new device.

## Note
```diff
- This app is created for interacting with wifi networks while running automated tests.
- Due to the security messures of Android OS, this app can't manupulate(delete, update) existing
- wifi networks unless it was added by 'adb-wifi-setting-manager' app.
- So if you wish to have full controll of the SSID saved on the device with this app,
- please remove all saved wifi networks on your device manually and use this app for all action
- e.g. adding, removing new wifi networks.
- This app is created for interacting with Wi-Fi networks while running automated tests.
- Due to the security measures of Android OS, this app can't manipulate(delete, update) existing
- wifi networks unless it was added by the 'adb-wifi-setting-manager' app.
- So if you wish to have full control of the SSID saved on the device with this app,
- please remove all saved Wi-Fi networks on your device manually and use this app for all action
- e.g. adding, or removing new Wi-Fi networks.
```

## Commands:
---

To download apk:

`wget https://github.com/pr4bh4sh/adb-wifi-setting-manager/releases/download/1.0/adb-wifi-setting-manager-debug.apk`

To install apk

`adb install adb-wifi-setting-manager-debug.apk`

To enable wifi:

`adb shell 'am start -n 'com.adbwifisettingsmanager/.WifiSettingsManagerActivity' --esn enableWifi'`
Expand All @@ -40,7 +48,7 @@ Connect to Wifi with user name and Password:

`adb shell am start -n 'com.adbwifisettingsmanager/.WifiSettingsManagerActivity' --esn connect -e ssid <ssid_name> -e userName <user_name> -e password <password>'`

Forget a saved Wifi SSID
Forget a saved Wi-Fi SSID
1. Forget a specific SSID

`adb shell am start -n 'com.adbwifisettingsmanager/.WifiSettingsManagerActivity' --esn remove -e ssid <ssid_name>'`
Expand Down

0 comments on commit bfbcfb5

Please sign in to comment.