tanxulong / adb-gui

ADB-GUI - GitHub Page

UI wrapper around ADB to make life easier for Android Developer and QA

Medium post about ADB-GUI-Tool (27.01.2017)

Install
Submit an issue
Use Cases
Abilities
Share 'command batch' / 'intent' with your team
Known Isseus

Install:

• You should have Java and adb (comes with android studio) installed.

1. Dowload: ADB-GUI-Tool 0.1.9v

2. Unzip to a path without spaces

3. MAC: give running permission to: ADB-GUI-Tool.jar

4. Run: ADB-GUI-Tool.jar (Double press from finder / explorer or run: java -jar ADB-GUI-Tool.jar from terminal)

5. On first run: change 'adb path' in preference screen to point to your local adb

Submit an issue

If you encountered a problem, something is not working, please open an issue.
But before you do so please go to the app path, open 'preference' file,
Change: "debug":false -> "debug":true
Try to recreate your error and send me the last logs (both the error and regular one) created at: 'app-logs' directory under you app directory.

Use Cases:

1. Automate login forms via Batch Commands
2. Automate device readiness for QA (install multiple APKs and copy files) via Batch Commands
3. Take snapshots easily
4. Install APKs
5. Test deep linking via Inten / Broadcasts
6. Get APKs from device
7. Run monkey runner with a simple click

And much more...

Abilities:

The app devided into Device Panel 7 Tabs and status line

Status line:

Appears at the bottom, most of the commands will update it.

• Black color text: command is running
• Green color text: command executed succesfully
• Red color text: command failed

Some commands will appear green result even if the command failed

Device Panel:

1. Device selection: all device commands that you will execute will be executed on the device you select here

2. Connect device via WiFi: click in order to start working via WiFi

• Device should be on the same network as the pc
• After pressed there should be an extra device in the list and you can disconnect it from usb.
• Connection will be lost if adb / device restarts

3. Take snapshot: opens an 'device view' screen

• Screen will be updated by itself
• Press 'Save' to save a snapshot
• You can save as many snapshots as you like in one session

4. Send quick text to device: enter the text you want to send and press enter

5. Change emulator date: opens a dilog for changing emulator time

• Works only on emulators
• Will also disable the auto date / time zone update
• If you move to the clock extensively it can jump back

6. Open developer settings on the device

7. Open app directory: open the directory where all the files stored on your pc

Tabs

1. Batch command

• Create and execute batch adb commands
• You don't need to know the adb command behind it, just use the command wizard tool

2. Applications

• Clear app data
• Uninstall app
• Kill all apps process, only on debugble apps, to emulate android memory clean
• Get installed APK from device
• Run monkey runner on any app

3. APKs

• Install APK for pc (can configure to show several folders)
• Run de-obfuscation tool (need to be downloaded separately)

4. Intent / Broadcasts

• Send broadcast / intents to device
• Save you popular ones for future use

5. Log / Exceptions

• See logcat
• Browse through exceptions
• Save exception / log to file

6. Terminal

• Expirement with adb commands

7. Preference

• Edit app preference

Share 'command batch' / 'intent' with your team

You can easily send you team an 'command batch' or 'intent' they both saved in a JSON file.
Just find the right file under your app directory and send it to your team mate.
Ask him to put it into the right directory and that it, he got it!

Known Issues

Was developed and tested on MAC, windows and linux support is limited some features may not work (It should but was partialy tested). Was tested on variety of devices mainly on NEXUS 5x and emulators

1. Unothorized device: some times the adb devices command will retrive one of the devices as unothorized in this case you should:

• Press "Kill ADB"
• Open terminal / command line and write "adb devices" (Running this command from the App not working for some reason)
• Press "Start monitoring" to get the device list back

2. Some of the functions will not work if the app is placed in path with spaces