@yume-chan/adb-backend-webusb

Backend for @yume-chan/adb using WebUSB API.

Usage no npm install needed!

<script type="module">
  import yumeChanAdbBackendWebusb from 'https://cdn.skypack.dev/@yume-chan/adb-backend-webusb';
</script>

README

@yume-chan/adb-backend-webusb

Backend for @yume-chan/adb using WebUSB API.

Note

WebUSB API requires a secure context (basically means HTTPS).

Chrome will treat localhost as secure, but if you want to access a dev server running on another machine, you need to add the domain to the allowlist:

  1. Open chrome://flags/#unsafely-treat-insecure-origin-as-secure
  2. Add the protocol and domain part of your url (e.g. http://192.168.0.100:9000) to the input box
  3. Choose Enable from the dropdown menu
  4. Restart your browser

pickDevice

static async pickDevice(): Promise<AdbWebBackend | undefined>

WebUSB API (MDN) (Spec)

Request browser to present a list of connected Android devices to let the user choose from.

Returns undefined if the user canceled the picker.

fromDevice

static async fromDevice(device: USBDevice): Promise<AdbWebBackend>

WebUSB API (MDN) (Spec)

Create an AdbWebBackend instance from an exist USBDevice instance.

read/write

WebUSB API (MDN) (Spec)

Read/write data from/to the underlying USBDevice instance.

generateKey

Web Crypto API (MDN)

Web Storage API (MDN)

Generate a RSA private key and store it into LocalStorage.

iterateKeys

Return the stored RSA private key. (This backend only supports a single key)