mirror of
https://github.com/openstf/stf
synced 2025-10-06 03:50:04 +02:00
Tweak feature list and other claims.
This commit is contained in:
parent
a7a5258e51
commit
1147fb4a02
1 changed files with 55 additions and 42 deletions
97
README.md
97
README.md
|
@ -1,61 +1,74 @@
|
||||||
# STF
|
# STF
|
||||||
===
|
|
||||||
STF (Smartphone Test Farm) is a full featured SaaS for remotely debugging real smartphone devices from the comfort of your browser.
|
|
||||||
|
|
||||||
Features
|
STF (or Smartphone Test Farm) is a web application for debugging smartphones, smartwatches and other gadgets remotely, from the comfort of your browser.
|
||||||
===
|
|
||||||
- Support Android devices from 2.3 to 5.0, including Android M
|
|
||||||
- Fast device screen transfer
|
|
||||||
- Remote mouse and keyboard input
|
|
||||||
- Multitouch support
|
|
||||||
- Browse to URL
|
|
||||||
- Auto-detect installed browsers
|
|
||||||
- Realtime logging and filtering
|
|
||||||
- Copy and Paste text
|
|
||||||
- APK Upload by drag & drop
|
|
||||||
- Screen rotation
|
|
||||||
- Search devices on your own devices farm
|
|
||||||
- See who is using which device
|
|
||||||
- Execute shell commands directly
|
|
||||||
- Remote debug for native and web apps
|
|
||||||
- Chrome remote debug tools
|
|
||||||
- Automated Play Store user input
|
|
||||||
- Reverse port forwarding for development
|
|
||||||
- Device hardware specific information
|
|
||||||
|
|
||||||
Requirements
|
It is currently being used at [CyberAgent](https://www.cyberagent.co.jp/en/) to control a growing collection of more than 160 devices.
|
||||||
===
|
|
||||||
- NodeJS
|
|
||||||
- Bower
|
|
||||||
- RethinkDB
|
|
||||||
|
|
||||||
Getting Started
|
## Features
|
||||||
===
|
|
||||||
|
* OS support
|
||||||
|
- Android
|
||||||
|
* Supports versions 2.3.3 (SDK level 10) to 5.1 (SDK level 22), plus Android M Developer Preview
|
||||||
|
* Supports Wear 5.1 (but not 5.0 due to missing permissions)
|
||||||
|
* Supports Fire OS, CyanogenMod, and other heavily Android based distributions
|
||||||
|
* Remote control any device from your browser
|
||||||
|
- Real-time screen view
|
||||||
|
* Refresh speed can reach 30-40 FPS depending on specs and Android version. See [minicap](https://github.com/openstf/minicap) for more information.
|
||||||
|
* Rotation support
|
||||||
|
- Supports typing text from your own keyboard
|
||||||
|
* Supports meta keys
|
||||||
|
* Copy and paste support (although it can be a bit finicky on older devices, you may need to long-press and select paste manually)
|
||||||
|
* May sometimes not work well with non-Latin languages unfortunately.
|
||||||
|
- Multitouch support on touch screens, two finger pinch/rotate/zoom gesture support on regular screens by pressing `Alt` while dragging
|
||||||
|
- Drag & drop installation and launching of `.apk` files
|
||||||
|
* Launches main launcher activity if specified in the manifest
|
||||||
|
- Reverse port forwarding
|
||||||
|
* Access your local server directly from the device, even if it's not on the same network
|
||||||
|
- Open websites easily in any browser
|
||||||
|
* Installed browsers are detected in real time and shown as selectable options
|
||||||
|
* Default browser is detected automatically if selected by the user
|
||||||
|
- Execute shell commands and see real-time output
|
||||||
|
- Display and filter device logs
|
||||||
|
- Use `adb connect` to connect to a remote device as if it was plugged in to your computer, regardless of [ADB](http://developer.android.com/tools/help/adb.html) mode and whether you're connected to the same network
|
||||||
|
* Run any `adb` command locally, including shell access
|
||||||
|
* [Android Studio](http://developer.android.com/tools/studio/index.html) and other IDE support, debug your app while watching the device screen on your browser
|
||||||
|
* Supports [Chrome remote debug tools](https://developer.chrome.com/devtools/docs/remote-debugging)
|
||||||
|
* Manage your device inventory
|
||||||
|
- See which devices are connected, offline/unavailable (indicating a weak USB connection), unauthorized or unplugged
|
||||||
|
- See who's using a device
|
||||||
|
- Search devices by phone number, IMEI, ICCID, Android version, operator, product name and/or many other attributes with easy but powerful queries
|
||||||
|
- Show a bright red screen with identifying information on a device you need to locate physically
|
||||||
|
- Track battery level and health
|
||||||
|
- Rudimentary Play Store account management
|
||||||
|
* List, remove and add new accounts (adding may not work on all devices)
|
||||||
|
- Display hardware specs
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
* [Node.js](https://nodejs.org/) >= 0.12
|
||||||
|
* [Bower](http://bower.io/)
|
||||||
|
* [RethinkDB](http://rethinkdb.com/) >= 2.0.0
|
||||||
|
* [GraphicsMagick](http://www.graphicsmagick.org/) (for resizing screenshots)
|
||||||
|
* [ZeroMQ](http://zeromq.org/) libraries installed
|
||||||
|
|
||||||
|
## Getting Started
|
||||||
|
|
||||||
See [GETTING_STARTED.md](GETTING_STARTED.md).
|
See [GETTING_STARTED.md](GETTING_STARTED.md).
|
||||||
|
|
||||||
|
## Updating
|
||||||
Updating
|
|
||||||
===
|
|
||||||
|
|
||||||
See [UPDATING.md](UPDATING.md).
|
See [UPDATING.md](UPDATING.md).
|
||||||
|
|
||||||
|
## Testing
|
||||||
Testing
|
|
||||||
===
|
|
||||||
|
|
||||||
See [TESTING.md](TESTING.md).
|
See [TESTING.md](TESTING.md).
|
||||||
|
|
||||||
Contributing
|
## Contributing
|
||||||
===
|
|
||||||
See [CONTRIBUTING.md](CONTRIBUTING.md).
|
See [CONTRIBUTING.md](CONTRIBUTING.md).
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
License
|
|
||||||
===
|
|
||||||
See [LICENSE](LICENSE).
|
See [LICENSE](LICENSE).
|
||||||
|
|
||||||
Copyright © CyberAgent, Inc. All Rights Reserved.
|
Copyright © CyberAgent, Inc. All Rights Reserved.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue