Maestro is an open-source mobile testing framework for end-to-end testing automation. It is used to automate testing of various flows within the Edge Wallet.
- If you have previously set up your machine as a development environment for
react-native, please install Maestro directly via the installation & getting started documentation.
-
macOS 13.x (Both Apple Silicon and Intel are supported)
-
An Android device with USB debugging enabled and connected via USB to your computer.
- Open the Terminal app (Located in the Applications/Utilities folder).
- Install Apple Command Line Tools by pasting the following command in your terminal, and pressing enter:
xcode-select --installThis will open a dialog box. Click "Install", followed by "Agree" to the license terms. This will start the installation of the Apple Command Line Tools.
Note: Downloading and installing the Apple Command Line Tools can take between 10 minutes to an hour depending on your internet connection speed.
- Once Apple Command Line Tools has finished installing, run the following command to verify that the installation was successful:
xcode-select -p
# /Library/Developer/CommandLineTools
- Next, run the convenience shell script to install all dependencies required for Maestro, including Maestro itself:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/EdgeApp/edge-react-gui/develop/maestro.sh)"- Once the script has finished installing all dependencies & Maestro, the command
maestro --versionshould successfully return the version number:
maestro --version
# 1.27.0To run Maestro tests, ensure you are in the edge-react-gui directory:
cd ~/edge/edge-react-gui🚀:
yarn maestroMaestro Studio, an in-browser app that ships with Maestro, provides a simple way to create Maestro tests. Make sure to have your Android phone connected via USB, and run:
maestro studioThis will open a browser tab on localhost:9999 and allow you to create tests. Please consult the maestro studio documentation for further information.