Mobile web emulation launcher

The mobile web emulation launcher is a command line tool that allows users to quickly capture web element(s) on a website which will render in a mobile device, without requiring a device.

Setup prerequisites

  • Ensure Chrome browser is installed in a recognized location.
  • Download the ChromeDriver binary for your platform and place it under the following directory {TA_DATA_DIR}\Automation\webdriver_server for example: C:\Users\Public\LogiGear\TestArchitect\Automation\webdriver_server .
  • Attention:
    Your ChromeDriver binary version should be compatible with the installed Chrome browser’s version.

Download and extract the launcher

Configuration

  • The launcher is pre-configured with default location when installing TestArchitect. If you install TestArchitect in custom location, you have to re-configure the launcher with following steps

    1. Manually open launcher.bat with a text editor
    2. Update {TA_INSTALL_DIR} with your TestArchitect installed directory
    3. Update {TA_DATA_DIR} with your TestArchitect data directory

Usage

  • Close all opening Chrome browser instance(s)
  • Open CMD from the downloaded launcher folder to execute launcher.bat file
  • The launcher will launch a web mobile emulator and you can start using Interface Viewer to capture web element(s) of your website on it.
  • Attention:
    The launcher uses the network port 9222 internally. Please ensure that network port is available before using the launcher.
  • Tip: 
    If your machine has installed PowerShell, you can check the process which uses the 9222 port with command
Get-Process -Id (Get-NetTCPConnection -LocalPort 9222).OwningProcess

Syntax

.\launcher.bat "<device name>" "<url>"

Arguments

ArgumentDescription
device name (Required)

Specify the device name for emulating. Example: “Nexus 5”

url (Required)

The url of your website. Example: “https://demo.testarchitect.com”

  • Notes: 
    See section Standard emulated device list for list of emulated device name supported by current Chrome browser version (107.0.5304.88). The list of available device name may be different on different versions of Chrome browser.

  • Tip: 
    If you use Chrome browser version other than 107.0.5304.88, you can see the list of available device from your installed Chrome browser by performing below steps:

    • Open Chrome browser, press F12 to open Chrome’s DevTools
    • Press Shift + ? to open DevTools’s Settings
    • Select Devices tab on Settings column

Stop the launcher

  • Tip: 
    You can manually type Ctrl + C on the opening CMD console to stop the launcher

Sub-commands

When the CMD console of the launcher is opening, you can continuously enter sub-command on the console to perform below browser-related functions

  • Navigate to the a url. Example: to https://demo.testarchitect.com

    to <url>
    
  • Refresh the current page

    refresh
    
  • Go back to previous page

    back
    
  • Forward to next page

    forward
    

Standard emulated deivce list

iPhone SE
iPhone XR
iPhone 12 Pro
Pixel 3 XL
Pixel 5
Samsung Galaxy S8+
Samsung Galaxy S20 Ultra
iPad Air
iPad Mini
Surface Pro 7
Surface Duo
Galaxy Fold
Nest Hub Max
Nest Hub
iPhone 4
iPhone 5/SE
iPhone 6/7/8
iPhone 6/7/8 Plus
iPhone X
BlackBerry Z30
Nexus 4
Nexus 5
Nexus 5X
Nexus 6
Nexus 6P
Pixel 2
Pixel 2 XL
Pixel 3
Pixel 4
LG Optimus L70
Nokia N9
Nokia Lumia 520
Microsoft Lumia 550
Microsoft Lumia 950
Galaxy S III
Galaxy S5
Galaxy S8
Galaxy S9+
Galaxy Tab S4
JioPhone 2
Kindle Fire HDX
iPad
iPad Pro
Blackberry PlayBook
Nexus 10
Nexus 7
Galaxy Note 3
Galaxy Note II
Moto G4

Copyright © 2023 LogiGear Corporation. All rights reserved. LogiGear is a registered trademark, and Action Based Testing and TestArchitect are trademarks of LogiGear Corporation. All other trademarks contained herein are the property of their respective owners.

LogiGear Corporation

1730 S. Amphlett Blvd. Suite 200, San Mateo, CA 94402

Tel: +1(800) 322-0333