README.md

🔌 ADB Interface for VSCode

This simple ADB wrapper try to makes easy connect to android devices over wifi, without console use, and do other things.

Chinese Guide 简体中文指南

You can help with Code or with Energy everthing are welcome ;)

⚠️ ONLY TESTED IN WINDOWS (For while, you need have ADB Interface installed in your system)

Attach ADB to an Device via WIFI

1. First connect your device trough USB
2. Run ADB:📱 Disconnect from any devices
3. And run ADB:📱 Reset connected devices port to :5555
4. And Then ADB:📱 Connect to device IP enter your device (settings > status > ip address) IP address and be fine

Installing APK files throught ADB

1. Pick apk file with command ADB:📱 Pick .APK file and install
2. Allow ADB install on device screen
3. Wait until copy de file and icon appear
4. Now you can run the APP

Table of contents

• 🔌 ADB Interface for VSCode

• 📱 Demo GIFs

  • Attach ADB to an Device via WIFI
  • Installing APK files throught ADB

• Table of contents

• Commands Available

• How it works

  • ADB location resolution strategy

• Tests

  <!--te-->
  

Commands Available

• ADB:📱 Reset connected devices port to :5555 (Open current device port with (equivalent adb tcpip 5555))
• ADB:📱 Connect to device IP (Need type the IP from device (equivalent adb connect ${your ip}:5555))
• ADB:📱 Disconnect from any devices (Disconnect ever device attached (equivalent adb disconnect))
• ADB:📱 Connect to device from List (Show an list from devices attached to connect (equivalent adb devices))
• ADB:📱 Pick .APK file and install (Install on current active device (Will prompt user on Android Screen))
• ADB:📱 Setup custom ADB location (Configure location of ADB)
• ADB:📱 Remove custom ADB location (Clear custom ADB location)
• ADB:🔥 Enable Firebase events debug mode (Run firebase events in debug mode)
• ADB:🔥 Disable Firebase events debug mode (Run firebase events in debug mode)
• ADB:⚠️ Kill ADB server (Kill ADB Server runing (equivalent adb kill-server))

How it works

ADB location resolution

By default the extension is looking for ADB in the following locations:

• Linux - $HOME/Android/Sdk
• MacOS - $HOME/Library/Android/sdk/platform-tools
• Windows - %USERPROFILE%\AppData\Local\Android\Sdk\platform-tools (if the %USERPROFILE% environment variable is not defined the path to the profile directory of the current user will be used as the starting point)

The extension will resolve the ADB location each time an ADB command is executed.

The ADB location can be customized using the Setup custom ADB location command. The custom ADB location can be cleared using the Remove custom ADB location command.

Tests

All done with Jest you can read more about here.

We need help to incrase test coverage report, if you can learn, send a pull request !

How to run tests:

➥ npm run test

You can also use the project alias that watch file changes while developing:

➥ npm run test:watch

Commits

All commits are done runing the command npm run cm to ensure some rules used during CHANGELOG.md generation with npm run release-it

➥ npm run cm

Type your commit info like type, scope, short.

➥ npm run release

Confirm information to create new release and update CHAGELOG.md

Now we can run npm publish to publish new version.