A tool to record and replay touchscreen events for testing and automation

Search This thread

kenmark

Member
May 19, 2015
5
0
[code single]appetizer-toolkit[/code] is the core of Appetizer, which provides the ability to:
* record touchscreen events from one device and replay to many (aspect ratios must be the same)
* control multiple devices concurrently (e.g., run a shell command, install an app, etc.)
* mirror the touchscreen events from one device to many in real time (aspect ratios must be the same)

[code single]appetizer-toolkit[/code] is a command line tool, available on Windows 7+, MacOS Mavericks+ and Linux. It also comes with SDK for Python and Nodejs. [code single]appetizer-toolkit[/code] requires [code single]adb[/code] to be present in [code single]PATH[/code].

Please submit an issue for bugs, enhancements and feature requests. Pull requests are welcomed too.

Installation
For Linux and MacOS, download the executable ([code single]appetiezr-toolkit-darwin-x64[/code] for MacOS and [code single]appetizer-toolkit-linux-x64[/code] for Linux); For Windows, download and unzio [code single]appetizer-toolkit-win.zip[/code]. You might want to add to PATH to use the tool globally.

Code:
usage: appetizer-toolkit-linux-x64 [-h] {version,trace,adb,devices,plan} ...

positional arguments:
  {version,trace,adb,devices,plan}
                        commands
    version             Print the version information and exit
    trace               Record and replay touchscreen events
    adb                 Control the local ADB
    devices             Command devices
    plan                Compose and execute a test plan file

optional arguments:
  -h, --help            show this help message and exit

Record and Replay
To record and replay touchscreen events, use [code single]appetizer-toolkit-* trace[/code]:
Code:
usage: appetizer-toolkit-linux-x64 trace [-h] {info,replay,record} ...

positional arguments:
  {info,replay,record}  actions
    info                Get the detail of a trace file
    replay              Replay a touchscreen event trace to some devices
    record              Record a trace of touchscreen events

optional arguments:
  -h, --help            show this help message and exit
vimeo video

Control Multiple Devices and Mirror Touchscreen Events
To work with multiple devices, use [code single]appetizer-toolkit-* devices[/code]:
Code:
usage: appetizer-toolkit-linux-x64 devices [-h]
                                           {list,screenshot,mirror,control}
                                           ...

positional arguments:
  {list,screenshot,mirror,control}
                        actions on the devices
    list                List the details of connected devices
    screenshot          Take a screenshot
    mirror              Mirror the touchscreen events from one device to many
                        in real-time
    control             Control devices

optional arguments:
  -h, --help            show this help message and exit
Mirror the touchscreen events from one device to many in real-time.
vimeo video

## ADB related
[code single]adb[/code] from Android SDK is required for [code single]appetizer-toolkit[/code]. The toolkit itself can detect the existence of the adb binary and control the adb server with it.
Code:
usage: appetizer-toolkit-linux-x64 adb [-h]
                                       
                                       {check-server,start-server,kill-server,detectadb}
                                       ...

positional arguments:
  {check-server,start-server,kill-server,detectadb}
                        actions on the adb server
    check-server        Check the state of the adb server
    start-server        Start the adb server
    kill-server         Kill the adb server
    detectadb           Detect the path to the adb program

optional arguments:
  -h, --help            show this help message and exit

XDA:DevDB Information
Appetizer toolkit, Tool/Utility for all devices (see above for details)

Contributors
kenmark
Source Code: https://github.com/appetizerio/appetizer-toolkit


Version Information
Status: Beta

Created 2017-01-19
Last Updated 2017-01-19