This page concerns only measure on android device, if you want to measure on iPhone, you can follow this link:
Lancer un script gdsl avec le testrunner sur iOS (sans mesure physique)
1. Install UIAutomatorViewer
Install Android Studio if you don’t have it
Open Android Studio
Click on More Actions > SDK Manager (or Tools > SDK Manager if a project is open)
Click on the SDK tools tab, uncheck option "Hide Obsolete Packages"
Check option “Android SDK Tools” and install version 26.1.1
UIAutomatorViewer is now installed in Android SDK directory
Add UIAutomatorViewer to your path:
On Linux: add the line
export PATH=$HOME/Android/Sdk/tools/bin:$PATH
in the .bashrc file and run the command "source ~/.bashrc"On Mac: add the line
export PATH=$HOME/Library/Android/sdk/tools/bin:$PATH
in the .bash_profile file and run the command "source ~/.bash_profile"On Windows: Windows start menu > Settings > System > About > Advanced settings > Environment variables > Path > Modify > Add the path
C:\Users\[username]\AppData\Local\Android\Sdk\tools\bin
. Replace username by the name of the user.
UIAutomatorViewer needs a JDK 1.8 by default to work
2. Launch UIAutomatorViewer
2.1. Launch UIAutomatorViewer without installing a JDK 1.8 (recommended)
To avoid installing a different version of java, you could set environment variables for your PC profile:
Linux | Mac | Windows | |
---|---|---|---|
ANDROID_HOME | Edit the ~/.bashrc file:
| Edit the ~/.bash_profile file:
| Windows start menu > Settings > System > About > Advanced settings > Environment variables > Path > Add:
Replace username by the name of the user. |
JAVA_HOME | Edit the ~/.bashrc file:
If jbr is not present (old version Android Studio) replace by jre. | Edit the ~/.bash_profile file:
| Windows start menu > Settings > System > About > Advanced settings > Environment variables > Path > Add:
If jbr is not present (old version Android Studio) replace by jre. |
PATH | Edit the ~/.bashrc file:
| Edit the ~/.bash_profile file:
| Windows start menu > Settings > System > About > Advanced settings > Environment variables > Path > Add:
|
After adding the variables, you can open a new terminal (this is important to open a new terminal to take into account the variable you have just set) and use the following command to open uiautomatorviewer :
For Windows :
java -Xmx1600M -Dcom.android.uiautomator.bindir="%ANDROID_HOME%\tools" -cp "%ANDROID_HOME%\tools\lib\x86_64\swt.jar";"%ANDROID_HOME%\tools\lib\*" com.android.uiautomator.UiAutomatorViewer
For Linux :
java -Xmx1600M -Dcom.android.uiautomator.bindir="$ANDROID_HOME/tools" -cp "$ANDROID_HOME/tools/lib/x86_64/swt.jar":"$ANDROID_HOME/tools/lib/*" com.android.uiautomator.UiAutomatorViewer
The following program appears :
2.2. Launch UIAutomatorViewer with JDK 1.8
It could be difficult to have the good jdk version to work with your sdk
On Linux, do this on a new terminal :
# Install java 8 sudo apt-get install openjdk-8-jdk # Check java version java -version # Update the java default version use by your system (if you have several) sudo update-alternatives --config java
On Windows, install Java 8 by getting it on Oracle site web, need to create an account
On Linux, on a new terminal, go to the directory
$HOME/Android/Sdk/tools/bin
and tap the following command :
uiautomatorviewer
On Windows, on a new terminal, go to the directory
C:\Users\[username]\AppData\Local\Android\Sdk\tools\bin
and tap the following command:
uiautomatorviewer.bat
The following program appears :
On macOS, interactions may be impossible with uiautomatorviewer.
If it is the case, do the following steps:
Download swt here: https://www.eclipse.org/downloads/download.php?file=/eclipse/downloads/drops4/R-4.20-202106111600/swt-4.20-cocoa-macosx-x86_64.zip
Extract the folder and open it
Rename swt.jar file to swt2.jar
Copy the file in the following folder: $HOME/Library/Android/sdk/tools/lib/x86_64
Launch uiautomatorviewer and resize the window
3. Use UIAutomatorviewer
When UIAutomatorViewer is opened, you can
Plug your usb on your smartphone
Click on button “Device screenshot”
A screen capture and a dump of view hierarchy appears on the screen
On screenshot (left), you can select the element for which you want to retrieve information and find it on the right:
In this case, the tab “Actu” have the field ‘text’ set with ‘Actu’. So in GDSL we can search the text Actu to find this tab (if there is no other element with the same text in the screen).
Each element of a view can be retrieve by field ‘text’, ‘resource-id’, ‘class’ or ‘content-desc’. GDSL commands are made to find an element by searching on this field
clickById,exampleid : click on an element which have exampleid in resource-id field
waitUntilText,Actu : Wait an element which have ‘Actu’ in text field