User Guide

Installation

  • 1. Windows
    • 1-1. Download from http://gaider.ajuqms.co.kr/download
    • 1-2. Execute the file “G+AIDER_Personal_v1.2.6-alpha6_x64.exe” (windows version)
    • 1-3. Finish the installing as below;
    • 1-4. After complete installation, you will see the icon from the start menu. Recommend using Window 10
      Window 7 Window 10
  • 2. Mac
    • 2-1. Download from http://gaider.ajuqms.co.kr/download
    • 2-2. Expand the zip archive and open the .dmg file.
    • 2-3. Open the mounted image and copy the G+AIDER into convenient folder (“Application” for example)
    • 2-4. Double click the G+AIDER to launch after copying is finished.
  • 3. Mac - OCR
    • 3-1. For using OCR (Optical character recognition), you will need to install the Tesseract; The easiest way of installing Tesseract on MacOS is using HomeBrew or MacPorts.
      • 3-1-1. Install using HomeBrew (http://brew.sh/) To install Tesseract run this command in Terminal: brew install tesseract Training directories can be found using brew list tesseract Possible location can be /use/local/Cellar/tesseract/3.05.02/share/tessdata/
      • 3-1-2. Install using MacPorts (https://www.macports.org/) To install Tesseract run this command in Terminal: sudo port install tesseract To install any language data, run: sudo port install tesseract- List of available langcodes can be found on MacPorts tesseract page. (https://ports.macports.org/?search=tesseract-&search_by=name)
  • 4. Mac – iOS agent For testing iPhone, you need to install the iOS agent on the iPhone. (iPhone only can test on Mac) Also, you need to connect the iPhone via WiFi. (Differ from the Android phone)
    • 4-1. Prerequisites
      • 4-1-1. Mac with the latest MacOS
      • 4-1-2. Downloaded iOS agent project (including G+AIDER Mac package)
      • 4-1-3. Latest Xcode
      • 4-1-4. Valid Apple developer account
    • 4-2. Install iOS Agent
      • 4-2-1. Download & extract iOS agent
      • 4-2-2. Open iOS Agent folder
      • 4-2-3. Open “WebDriverAgent.xcodeproj”
      • 4-2-4. Setup correct signing settings. Check ”Automatically manage signing” and select the correct team for the development.
      • 4-2-5. Select the device for testing. You can select the real device or the simulator.
      • 4-2-6. Go to “Product” ”Test” or press Command+U (command and U key on the keyboard) to start the iOS agent.
      • 4-2-7. When iOS agent finishes launching, you will see a message with the server URL in the application output console.
      • 4-2-8. Now you can connect and start testing the iOS device with the G+AIDER iOS agent.
      • 4-2-9. If you see the pop-up message, please proceeded as below,

License

  • 3. Import License Move to folders where the license has been downloaded. Click the file.

Common troubles during the installation

  • 1. Error Error message as below;
    When it takes too much time for loading the library,it shows the message. Click Refresh
    • 1-1. Several solutions as below:
      • 1-1-1. Run the “run.exe” file in the G+AIDER folder
      • 1-1-2. Turn off the Anti-Virus program(Delete the current version Re-download Install G+AIDER)

Tutorial

  • 1. Tutorial For the beginners, G+AIDER provides the tutorial test cases. The cases are deigned for the game, called Tap Tap Zombie Hunter. Need to download the game, in order to execute the tutorial project. Also, you can see the structure of test cases.

G+AIDER Overview

  • 1. G+AIDER Overview
    • 1 Basic Function
      • Object Manager Tool
      • Connect device
      • Run the current script
      • Run all opened script
      • Stop testing
      • Record / Stop device gestures on mirrored screen
      • Change Language
    • 2 Script List: Manage project, scenario and scripts
    • 3 Workspace : Writing automated scripts
      • Save script
      • Refresh Script Must click after changes in the object manager (=container)
    • 4 Device Screen: Show mirrored device screen and control the device
      • Connect device
      • Stop connect device
      • Separate widow
      • Disconnect device
      • Manual test mode
      • Home
      • Take a snapshot
      • Screenshot
      • Burstshot
      • Input Text
      • Recent APP.
      • Back
      • Notification
      • Turn on
      • Turn off
    • 5 Device Manager : Manage multi devices (activating after connecting more than two devices)
      • Activate device
      • Disconnect
      • Remove device from list
    • 6 Log: testing log and validation result
      • Delete the Log
    • 7 Basic Function
      • Refresh
      • Create a project
      • Create a object container(GAME)
      • Import Project
      • Export Project
      • Start Project

G+AIDER Preparing test

  • 1. Load a project If you want to start testing from previous projects. Initial status: Show the project window
  • 2. Creating a project If you need to create a new project
  • 3. Creating a scenario & a script After creating a project
  • 4. Importing & Exporting
  • 5. Connecting device - Android Window & Mac is same for connection
    • 5-1. From Device: Setting – Developers options – Activate the “USB debugging”
    • 5-2. Using USB cable, transferring data, connect the device to PC. (USB cable, only for charging, is not working)
    • 5-3. Check connection with device. (If devices is not connecting, download the driver from the manufacture homepage and install the driver – it mainly happens for LG phones)
    • 5-4. From Device, you have to “Allow” for all request when it connects to PC for first time.
    USB debugging mode in the device
    For Business version, with chargeable USB hub, you can connect up to 7 devices
  • 6. Connecting device - iPhone iPhone only can be tested on the Mac, and device and Mac has connect same WiFi network.
    iPhone testing is little slower than Android on mirroring screen.
    • 6-1. If you download the new version of the G+AIDER, you have to delete the agent from Device and reinstall it.
  • 7. Connecting multi-devices (Business version Only)
    • 7-1. - Support up to 7 devices
    • 7-2. - Multi device window is additional application. If you click the studio, it will hide behind it. When you finish the script work, make small size for the studio, then you can see the all devices is testing at the same time.
    • 7-3. - Testing speed would be vary for each devices.
    • If the connection has been lost, please click the “Activate device” again.

Automated script & testing

  • 1. Record & Replay Generate scripts from user gesture on mirroring screen
    • ▶Record & Replay is not recording video. It generates scripts of user gestures.
  • 2. Image recognition script
    • 3
      • Click the cropped image
      • Validate the cropped image
      • Convert the image to text from the cropped image
  • 3. Automated script
    • 3-1. Basic Step
      • 3-1-1. Choose the script and drag into workspace
      • 3-1-2. Combine blocks on your demand
  • 4. Run & stop test
  • 5. Report

Automated Script Block

  • 1. General information about using the block
    Workspace View
    Block Description
    Basic
    • Copy & Paste, undo by hotkey (Ctrl + C, V & Z)
    • For more option for the scripts when it has setting or scroll bar icon.
    Enable to combine on top and on bottom
    Right click on block
    • Duplicate
    • Add Comment
    • Delete Blocks
    Enable to combine on top
    Variable hexagon script cannot work alone, need to insert other scripts by the shape. (Ex: Hexagon, round, etc.)
    Enable to insert the hexagon variable script
    Setting: additional option for the script
    Round variable script. More option in the scroll bar
    Enable to insert the round script. More option in the scroll bar.
    Text script (Appears pop up window for typing text)
    Default zoom
    Zoom In
    Zoom Out
    Delete script (Also, drag to right side until the script category)
  • 2. Object block
    Workspace View
    Block Description
    Object script (saved image by object manger)
    Validate the object
    Convert the word image to text on the target area
    Option for the OCR block
    • Default: fully automatic page segmentation (find any character in the image)
    • Text Line: recognize the image as one line of characters
    • Word: recognize the image as a single word
    • Word in a circle: recognize the image as a single word in a circle
    • Character: recognize the image as a single character
    • Orientation Script Detection: detect the orientation of image and script
    • Page Segmentation with OSD: Automatic page segmentation with OSD
    • Page Segmentation with OCR: page segmentation
    • Column of text of variable sizes: recognize the image as a single column of text of variable sizes.
    • Uniform block of vertically aligned text: recognize the image as a single uniform block of vertically aligned text
    • Uniform block of text: recognize the image as single uniform block of text
    Validate the text with the converted test from OCR
    Click the object when it found, or else
    Repeat until found the object, or else
    Repeat until not found the object, or else
    Object block: Select the object from the list
    Select objects from Operation blocks
  • 3. Operation block
    Workspace View
    Block Description
    For using Operation block, you need know the coordinate (x,y) from device. (You can get the information by clicking during record)
    Click the point of X, Y
    Click the object
    Long click the point of X,Y, and set duration
    Drag from one point to another
    Swipe from one point to another
    Open Notification
    Press Back
    Press Recent application
    Input text to the mobile device (Only support for English)
    Take a screenshot to the report
  • 4. Logic block
    Workspace View
    Block Description
    Boolean block (true / false)
    Arithmetic block (+ - / * ^)
    Comparison block (=, ≠, <, ≤, >, ≥)
    Condition block (and / or)
    If block in setting can select else if, else
    If – else block
    Repeat block – Enable to change repetition
    Repeat while block - While or Until
    Break block - continue with next iteration
    Number variable
    Text variable
    Print “text” block
    Print log block (include report)
    Wait block Enable to change the period 1000ms = 1 s
    Comment / UnComment 블록 (Comment : 내부 블록 실행 Skip Uncomment : 내부 블록 실행)
    Convert block
    • String
    • Number
    • Boolean
    Item probability block
    • alculate the probability of the items.
  • 5. Functions block
    Workspace View
    Block Description
    Function block
    • Setting: You can add inputs
    • ? : add comment
    Function & return value blocks
    • Setting: You can add inputs
    • ? : add comments
    Return value after “if” condition
    Function & return value blocks
    • Setting: You can add inputs
    • ? : add comments
    Function & return value blocks
    • Setting: You can add inputs
    • ? : add comments

G+AIDER Object Manager

  • 1. Preparation for the using Object Manager Before run the Object Manager, you need the screenshots from the mirrored screen. Object manager will make the object, for recognizing images, based on the screenshots.
    • 1-1. Taking screenshots from mirrored screen
    • 1-2. Taking continuous shots
  • 2. Run Object Manager Object Manager is useful tool for the working many objects. You just need to take all the screenshots you need ahead of time.
    • 1
      • Refresh
      • Create a new object container (game)
      • Click after the choose the object container
    • 2 Previous Object Container(game) list
  • 3. Object Manager layout
    • 1
      • Open Object container window
      • Create object container
      • Change language
    • 2
      • Load screenshots
    • 3 Auto selection
    • 4
      • Create object
      • Delete object
    • 5
      • Delete the cropped images
    • 6 Workspace (Appeared screenshot after loading)
      • Zoom In
      • Zoom Out
      • Set full screen
    • 7 Screenshots list (You can load the screenshots more than one)
      • Delete the cropped images
    • 1 Object Container(game) list
    • 2 New Object container name Write the description of the creating object container
  • 4. Load screenshots Select the screenshots and click “Open” (you can load more than one screenshot)
    • 1 Loaded screenshot
    • 2 List of screenshots
  • 5. Create object
    • 1 Objects list
    • 2 Create object window (Name & Description)
    • 3 Create object name
    • 4 Create object description
  • 6. Cropping screenshot
    • 1 Select a object
    • 2 Cropping image
      • - Select the area for cropping image
      • - Right click after selecting area
      • - If the next image’s size is same as current image, just move the box and right click
      • - Resize the area from current box. (When mouse point turn RED on corner of the box
    • 3 Images for the object (You can set more than one image for a object)
    • ▶ For better recognition, save many images as an object (including distance, angle, and background)
    • ▶ For multi device testing, get a screenshots and objects from the testing devices.
    • ▶ Must click “Refresh” in the Studio after you work in the Object Manager.
  • 7. Auto Selection
    • 1 Activate “Auto selection”: Detects the recommended images on the screenshot
    • 2
      • - Recommend all objects in the screenshot
      • - Enable to resize the recommend object
      • - Left click: select the object, Right click: Save as object
      • - After activate “Auto selection”, it recommend the object for the next screenshot until the deactivated.

G+AIDER Manual test mode

  • 1. Manual test mode Features
    • 1-1. Performance monitoring (Android only), Start/Stop performance monitoring ▶ Start/stop recording video clip & performance report
    • 1-2. Take screenshot on your demand
    • 1-3. User must control the device. (Unable to play on the mirrored screen.)
    • 1 Click “Manual test mode” on the mirrored screen
    • 2 Manual mode
    • 3 Performance Measuring
    • 4 Start/Stop Performance Measuring
    • 5 Screenshot (or spacebar) ▶ Must control from device
  • 2. Manual test mode setting
    • 1 Change measuring interval from 1s to 5s
    • 2 Set the save path
  • 3. Device performance measuring
    • 1 Start/Stop performance measure (Start/stop record video & performance report)
    • 2 Measuring CPU, MEM, FPS, BATT., TEMP
    • 3 Close manual test mode
    • 1 Click for stop performance measurements
    • 2 When stop measuring
      • - Performance measurement report (CSV)
      • - Video clip
      • - Video clip subtitle file
    • 3 “Testing video clip”
      Subtitle shows the measurement (need to turn on)
    • 4 Sample “Performance Report”
  • 4. Screenshots
    • 1 Click or spacebar for taking screenshot
    • 2 Select the screenshots for saving after close the manual test mode