1. SUPPORT PLATFORMS 2. INSTALLATION GUIDE Install Android SDK

Transcription

1 TABLE CONTENT 1. SUPPORT PLATFORMS INSTALLATION GUIDE Install Android SDK Setup environment Setup Android environment Set developer environment on Android Install the WebDriver APK on device or emulator REMOTE DEBUGGING FOR ANDOID Remote debugging Chrome Remote debugging Firefox Enable remote debugging on Firefox of Android device Enable remote debugging on Firefox of the desktop DELOY AUTOMATION TEST ON ANDROID... 11

2 1. SUPPORT PLATFORMS In the sense of automation testing for Android mobile device, Android WebDriver (in androidserver.apk) allows to run automated end-to-end tests that ensure your site works correctly when viewed from the Android browser. Run the tests on Android require environment supports as below: Windows XP (32-bit), Vista (32- or 64-bit), or Windows 7 (32- or 64-bit) JDK 7u60 and JRE 7 and later in (JDK version as same as JRE version) Android SDK Tools: depend on Android version to download Android SDK, see revision platforms. For example: o Android SDK r19 or higher is required for Android 4.4 o Android SDK r18 or higher is required for Android 4.3 o Android WebDriver: o android-server-2.16.apk support to Android Froyo (API level 8) o The lastest version (android-server apk, android-server apk ) support to Android 2.3.x Gingerbread (API level 9 ~ 10) Android 3.x Honeycomb (API level 11 ~ 13) Android 4.0.x Ice Cream Sandwich (API level 14 ~ 15) Android 4.1 ~ 4.3 Jelly Bean (API level 16 ~ 18) Android 4.4 KitKat (API level 19) Note that: - there is an emulator bug on Gingerbread that might cause WebDriver to crash - android-server apk is difficult to detect elements on website for automation For installing mobile emulator: o Genymotion with VirtualBox (this version includes Oracle VirtualBox ) 2. INSTALLATION GUIDE 2.1. Install Android SDK - Install Java SE Development Kit (JDK) Go to > Downloads > Java SE > JDK - Install Android SDK

3 Go to > View all download and size> SDK Tools only > Select the compressed file with your platform Extract the downloaded package to the folder name Android-sdk-xxx which have platforms, add-ons and tools Open android file in tools folders to active Android SDK Manager, stick the newest version of Android (e.g. Android API19) and install them. Note: install Google USB driver to directly run test case on device Setup environment Setup Android environment Run the test on emulators or real devices for phone and tablets a. Set up the Emulator (using Geneymotion) Registry a free account on and active new account by , then login with new account and download a package Genymotion(with VirtualBox) Go to Geneymotion application via login your account. Create a new virtual device by choosing the device (HTC One, Xperia Z, Samsung Galaxy S4, Nexus, tablet ) and clicking next to download it.

4 After finishing the download, double click your virtual machine to deploy device. b. Set up the device Simply connect your Android device through USB to your machine. Install the mobile driver on desktop to detect your device (e.g. need LGUnitedMobileDriver for LG devices).

5 Set developer environment on Android On emulator/device, go to Settings > Developer options > Turn on USB Debugging On Android 4.2 and newer, Developer options is hidden by default. To make it available, go to Settings > About phone and tap Build number 7 times. Return to the previous screen to find Developer options and check USB debugging Install the WebDriver APK on device or emulator To get the desktop and the Android device talking to each other using the adb command-line tool in Android SDK. Every device or emulator has a serial ID. Take the command line to go to android_sdk/platform-tools and run this command to get the serial ID of the device or emulator you want to use: adb devices Ex: root>adb devices Download the Android server from To install the application do: (recommend version android-server apk) adb -s <serialid> -e install -r android-server.apk Ex: root>adb s :5555 -e install r android-server apk

6 Then it appears a Webdriver application on device/emulator. Start the Android WebDriver application through the UI of the device or by running this command: adb -s <serialid> shell am start -a android.intent.action.main -n org.openqa.selenium.android.app/.mainactivity Make the android server available at from the host machine by a terminal type: adb -s <serialid> forward tcp:8080 tcp:8080 Ex: root>adb -s :5555 forward tcp:8080 tcp: REMOTE DEBUGGING FOR ANDOID

7 3.1. Remote debugging Chrome (limitation to Android 4 and up, Chrome 32 and up) Recommend this debug because it s easy to check and detect the xpath of objects on Android than Remote debugging Firefox. Check all available devices which connect to the desktop by command line adb devices Call remote Chrome devtools to detect objects of website on your device: Root>adb -s <serialid> forward tcp:9222 localabstract:chrome_devtools_remote Ex: root>adb -s :5555 forward tcp:9222 localabstract:chrome_devtools_remote To enable USB discovery in Chrome, on your desktop Chrome browser, go to chrome://inspect. Alternatively, to get to the same screen, you can select Chrome menu > Tools > Inspect Devices. Confirm that Discover USB Devices is checked:

8 There will be presented with the set of thumbnails for pages currently open in tabs on your mobile Chrome. Choose inspect link at the page you would like to debug and it will show the corresponding developer tools. To get xpath of any element on page, on tab Elements of Developer Tools, Enter Ctrl +F > type keywords to find the element which you want to detect > right click at the right element and choose Copy XPath Remote debugging Firefox (limitation to Android 2.2 and up, Firefox 24 and up) Enable remote debugging on Firefox of Android device. Type about:config on address bar of Firefox for Android, type "devtools" into the search box and press the Search key. You'll see all the devtools preferences. Find the devtools.debugger.remoteenabled preference, and press "Toggle". Open the menu, select "Settings", then "Developer tools" (on some Android devices you may need to select "More" to see the "Settings" option). Check the "Remote debugging" box: Come back the Firefox of Android device and go to the site which you want to debug (e.g. )

9 Enable remote debugging on Firefox of the desktop On the desktop, remote debugging is enabled in Developer Tools. On menu bar, choose Tools > Web Developers > Toggle Tools, then it show the DevTools in the end of page, choose Settting icon and check "Enable remote debugging": Check all available devices which connect to the desktop by command line adb devices Firefox Developer Tools can debug remote devices by default port So make connection to remote devices via default port: adb -s <serialid> forward tcp:6000 tcp:6000 On Firefox of desktop, choose Tools > Web Developers > Connect > set the suitable value and click Connect, then Firefox browser of remote devices will show the message: Press OK

10 Open the Developer Tools for remote site by choosing the link of your site on Connect page

11 4. DELOY AUTOMATION TEST ON ANDROID Note: if URL is IP address, you must install Certificate of site for Devices 1. Install certificate: 1.1. Export Certificate of site on FF: - Click on Lock icon > click on More Information button - Choose Security tab > View Certificate - Choose Details tab > click on Export - At Save as type field: choose X.509 Certificate with chain (PEM) (*.crt;*.pem) and click Save button Import Certificate into Devices: - Store Certificate file which have just exported into Devices - Go to Setting > Security > Install from SD card - Go to Folder where you store Certificate file and click on it to install - Enter Certificate Name: enter info you like, credential use: choose wifi, click on OK - Here, system require Pass for devices, don t worry, let do it. We will remove it in the moment - On Security tab, choose Screen lock > choose None. Done - Security > Trusted credentials > User. Check to make sure Certificate imported 2. Configure default driver in Capybara 1. Go to \RWFramework\Configuration 2. Open spec_helper.rb (by notepad++ or other editor) 3. Config driver to Android Webdriver

12 4. Save and close the file spec_helper.rb