https://github.com/nolanlawson/pwa-deploy
Deploy a Progressive Web App to a connected Android device or emulator (EXPERIMENTAL - DON'T USE THIS)
https://github.com/nolanlawson/pwa-deploy
Last synced: 11 days ago
JSON representation
Deploy a Progressive Web App to a connected Android device or emulator (EXPERIMENTAL - DON'T USE THIS)
- Host: GitHub
- URL: https://github.com/nolanlawson/pwa-deploy
- Owner: nolanlawson
- License: apache-2.0
- Created: 2016-05-29T01:36:12.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2016-09-11T05:32:40.000Z (over 8 years ago)
- Last Synced: 2025-03-28T22:12:34.116Z (28 days ago)
- Language: Java
- Homepage:
- Size: 2.12 MB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
pwa-deploy
====
⚠️ **Update:** don't use this. Use [Chrome port forwarding](https://developers.google.com/web/tools/chrome-devtools/debug/remote-debugging/local-server) instead. ⚠️
Deploy a Progressive Web App (or any static website) to a connected Android device or emulator.
Designed for quick and easy debugging of PWAs.
This allows you to test Service Worker, since the site will be running on `localhost`.
Install
---
```bash
npm install -g pwa-deploy
```
Usage
---
```bash
pwa-deploy /path/to/www/directory
```
This will deploy the directory to the first available Android
device or emulator, and then open the site in your default mobile browser. Android 4.0+ is supported.
Advanced usage
----
```
Options:
-d, --devices list available devices
-s, --specificDevice specific device id. do `pwa-deploy devices` to see
available
-p port to run on (default: 3000)
-h, --help Show help [boolean]
Examples:
pwa-deploy /path/to/www/ Load webapp on first available device
pwa-deploy /path/to/www/ -s Load webapp on specified device
pwa-deploy devices List all available devices/emulators
```
Troubleshooting Android device issues
----
This tool doesn't require the [Android SDK](https://developer.android.com/studio/index.html),
but it will look for a global `adb` if you have it. Else it will use a prebuilt `adb`.
First off, be sure your device is available for USB debugging:
1. Go into **Settings** > **About phone/tablet** > Tap **Build number** several times until it unlocks developer mode
2. Then **Settings** > **Developer options** > **USB debugging** and enable access when the prompt shows
If you have the Android SDK installed, try checking for attached devices:
```bash
adb devices
```
You should see a list of devices:
```
List of devices attached
010a2f182ccaa952 device
```
If `adb` isn't working, then you can sometimes fix it by doing `adb kill-server && adb start-server`.