Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Install Node.js

  • Download and install Node.js using the Windows installer on: https://nodejs.org/en/download

    Info
    Make sure you install Node.js into a location where you have full Read and Write permissions.
  • When installing Node.js, make sure that the Add to PATH option is checked.


    Info

    To make sure Node.js is installed correctly, you can open Windows command line and type the command: where node to see if system can find Node.js.

Install Appium

  • Open Command Prompt of Windows and input following command to install Appium:

    Code Block
    languagepowershell
    themeRDark
    npm install -g appium

Setup Devices

  • Install USB Driver for your phone, you can download it from the device manufacturer site. (If your Android phone is one of Google Nexus series, please skip this step because Android SDK already include the driver)
  • Turn on the phone developer mode (go to Settings -> Developer options).
  • Connect your Android device to the computer using USB cable. Just confirm if prompted for accepting/trusting the phone.

Test Execution

  • Launch Katalon Studio
  • Open a test project
  • Open a test case or test suite
  • Select the option to execute with the Android device from the Run button of the main toolbar. (Katalon Studio for Windows only supports Android devices).
  • Select your device from the Android Devices list. Click OKImage Removed

    Image Added


Troubleshooting

 

Info

Please read Installation and Setup guide first to setup your mobile. Below information are provided for those who can't get their mobile testing work properly after going through setup guide.

  1. My connected device is not displayed in 'Device Name' list:
    Please double check on the following items:
    - Developer option is turned on.
    Trusted connection is established by tap on 'Trust this computer' whenever this dialog is displayed on your device.
    - Check if the device is listed using adb command:
    On Windows command line/ MacOS terminal: Navigate to platform-tools folder in <Katalon Studio folder>\configuration\resources\tools\android_sdk\platform-tools 
    Type in "adb devices" and observe devices listed there. Make sure that your corrected device is listed there with online status. 

  2. Does Katalon Studio support emulator?
    Yes, we do. 

  3. "Fail to start the Appium server in xx seconds" error message is displayed when I start an application from Record/Spy:
    First of all, please set your Appium Log Level to "Debug" which you can find this option in Windows > Katalon Studio Preferences > Katalon > Mobile to generate debug logs of Appium. After this change is applied, retry your record/spy session and then open generated .appium file in the project folder. 
    Somewhere in this file you are likely will see these lines:
Code Block
themeRDark
[debug] [ADB] Running 'C:\Users\admin\Downloads\Katalon_Studio_Windows_64-4.8\configuration\resources\tools\android_sdk\platform-tools\adb.exe' with args: ["-P",5037,"-s","xxxxxxxxxx","shell","dumpsys","window","windows"] [debug] [ADB] Found package: 'com.abc.def.xyz' and fully qualified activity name : 'com.egh.jik' [debug] [ADB] Incorrect package and activity. Retrying.

  The root cause is Katalon Studio can't start application due to incorrect package and activity by default, so you need to add additional settings to desired capabilites:

 - Navigate to Mobile settings (Project > Settings > Execution > Default > Mobile > Android) 
 - Add the following key
   Name: appWaitActivity 
   Value: com.* (based on the prefix of 'Found package' log)

 

Table of Contents
classkat_toc