Evinced announces first end-to-end mobile (iOS & Android) accessibility solution

Android Connection Guide

Easily connect your device and run your first test on any Android device

Automatically pinpoint accessibility issues in your Android mobile applications on any device or simulator and generate actionable reports.

This page contains guidance for:

  • General Setup
  • Wireless Connection
  • Wired Connection

Environment Setup

Evinced Desktop Client Setup

Download and launch the Evinced Mobile Flow Analyzer desktop application. Once you have done so either sign up for an Evinced account or log in with your existing account. Once logged in, select the Android connection option. The Evinced Flow Analyzer for mobile's desktop app welcome screen. The heading is saying "Welcome to Evinced!" beneath the heading, a paragraph is saying "Let's scan your mobile app to analyze accessibility issues. Choose your mobile app OS:" Then there are two buttons to choose between iOS and Android.

A QR code as well as an IP address should be visible. Note: The IP address may differ from the one in the image. The Android connection page from the Evinced Flow Analyzer for mobile. Instructions for connection as well as a QR code and IP address.

Companion App Setup

Download the Evinced Mobile Flow Analyzer companion app from the Google Play store on your Android device. The Evinced Mobile Flow Analyzer page from the Google Play Store. Screenshots, installation options, and app information are available.

Once installed, open the Mobile Flow Analyzer companion app on your Android device and click “Get Started”. Then, click “Go to Settings” to enable the Evinced Accessibility Service. This gives Evinced the permissions needed to scan applications on the device. The enable android accessibility service page from the Evinced Android companion app. On the top a heading is saying "enable android accessibility service" and below there is a text saying "To start using the Evinced Flow Analyzer, the accessibility service on your device should be enabeled. And below there is a single button labeled go to settings.

Turn on the service and accept the permissions pop-ups.

The Android Settings page with a switch that turns on the Evinced Flow Analyzer service.

Creating an Android Emulator

To create an Android Emulator launch Android Studio and select the AVD Manager from the “Tools” menu. Select “+ Create Virtual Device..” and select any device that has the Play Store available. This is required in order to download the Evinced companion app. The Select Hardware window with a list of Android devices. The Play Store icon is highlighted. Complete the flow and launch the emulator. Download and launch the Evinced companion app as described above.

Wireless Connection

Connect to your device over a Wi-Fi network, no cables required!

Note: If your device is not on the same Wi-Fi network or the desktop/workstation is connected to a VPN or other proxy the device may not be able to connect and we would recommend the wired connection option below.

We have two options to connect, by QR code or IP address. The connection settings state from the Evinced Android companion app. Two buttons are present, one for QR code and the other for IP address.

Connecting via QR code (Recommended for physical devices)

Select the “QR Code” option and hold the device up to the screen of the desktop client and capture the QR code displayed within the boundaries presented within the companion app. The device will automatically connect to the companion app. The Evinced Android companion app scanning a QR code.

Connecting via IP Address (Recommended for Emulators)

Select the “IP Address” option and copy the IP address from the desktop client to the mobile app and click “Connect”.

Note: The IP address may differ from the one in the image. The Evinced Android companion app IP address state. An IP address is displayed with a single button to connect.

Troubleshooting a Wireless Connection

If the device is having trouble connecting, here are a few steps to try.

  1. Confirm you aren’t connected to a VPN or proxy that may interfere with the wireless connection.
  2. Confirm your workstation allows the creation of a websocket server on your workstation.
  3. Confirm the IP address seen in the mobile application matches the one in the desktop client.
  4. If connection issues remain, try creating a Wi-Fi hotspot from your device and then connecting your workstation to this Wi-Fi network. Retry the QR code or IP address connection steps
  5. If connection issues remain, try a wired connection as described below.

Wired Connection

Along with connecting via Wi-Fi, the Evinced Mobile Flow Analyzer can also connect via USB cable. Below are the steps to enable this connection.

Device Setup

One time configuration is needed to enable the developer options on the device and allow communication permissions to the workstation that the device is plugged in to.

Device Developer Options

To enable Developer mode on your device go to the “Settings” app and go to About phone > Software information and tap the “Build numberseven times. This will enable the “Developer options” menu in the main page of the “Settings” app.

The Android Settings app screen with Developer options highlighted.

Within the “Developer Options” enable “USB Debugging The Android developer options page with the USB debugging switch in the on position.

NOTE: There may be slight differences between Android versions and manufactures. For complete instructions see the Android developer documentation.

Android Debug Bridge Setup

In order to connect to the device our workstation needs the Android Debug Bridge installed. We can download adb as part of the SDK Platform Tools for Mac or Windows here. Add the file path to the platform tools directory that contains the adb executable to your PATH environment variable.

Windows

To add the file path to your PATH environment variable on Windows open the “Settings” app and search for “Environment Variable”. The settings app from Windows 10 with Environment Variables entered into the search bar. Two options are present one to edit the system environment variables and the other to edit the environment variables for your account.

Then add the correct file path to your Path system variable. The Windows Environment Variables window. Contains user variables and system variables with the Path system variable highlighted.

Mac

To add a file path to your PATH environmental variable on a Mac open a terminal window and type open .zshrc if you don’t have a .zshrc file go ahead and create one by entering touch .zshrc. Then, inside the .zshrc file add the following:

export PATH=$PATH:~/path/to/adb

To verify that the file path has been added type echo $PATH and verify that you see the path to adb.

Connection

adb

Now that we have adb installed and our device ready, let's connect our device to our workstation via a USB cable. Once the device is connected, open a terminal or command prompt window and type adb devices . This will print out a list of devices connected to the workstation. If you see unauthorized next to your device, open the device screen and accept the permission prompts. Once completed you should see the following: A Mac terminal window showing the output from an adb devices command. One devices is attached.

Evinced Desktop Client Setup

Open the Evinced Desktop Client and take note of the port number. In the example below the port number is 8000 but it might be different in your desktop client. The Android connection page from the Evinced Flow Analyzer for mobile. Instructions for connection as well as a QR code and IP address.

Now, in your terminal type the following command adb reverse tcp:8000 tcp:8000. Remember to enter the port displayed in your desktop client. You should see a response of the port number you used. A Mac terminal window showing the return from the command adb reverse tcp8000 tcp8000. The return is 8000.

Next, open the Evinced companion app on your device and click “Get Started” and then “Enter IP address manually”. Enter the following wss://127.0.0.1:8000. Remember, your port may be different, so be sure and enter the port number you see in the desktop client. Also, disregard the IP address you see in the desktop client. Ensure that you are using 127.0.0.1. Then click connect. your desktop client. You should see a response of the port number you used. The Evinced Android companion app page with an input to paste your IP address. IP address listed is 127001 port 8000.

Finally, enable the accessibility service on your device and you are ready to scan!

Troubleshooting a Wired Connection

  • Confirm you have permissions to connect a device to your workstation via USB cable.
  • Still having trouble? Please reach out to support@evinced.com and we would be happy to help!