Troubleshooting automated mobile testing

  • Please read Installation and Set-up guide first to set up your mobile. The information below is provided for those who can't get their mobile testing work properly after going through the set-up guide.
Issue Solution
Connected device is not displayed in 'Device Name' list. iOS
  • Connect your device to Xcode.
  • Go to Settings -> Developer > turn ON UIAutomation.
  • Check if your device is recognized using the following commands on Terminal.

    cd /Applications/Katalon\ 
    idevice_id -l

    If your iOS version is iOS 11, make sure Katalon Studio's version is 5.3+.

  • Developer option is turned on.
  • A trusted connection is established by tapping 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 <Android SDK folder>\platform-tools.
    • Type in "adb devices" and observe devices listed there. Make sure that your corrected device is listed there with online status. 
xcodebuild exited with code '65' and signal 'null'.

Your .ipa application and/or WebDriverAgent is not signed correctly.

  • Sign and rebuild the WebDriverAgent XCode project with your developer certificate.
  • Uncheck 'Automatically Signing' option from WebDriverAgentRunner and select valid provisioning profile (profile displayed as Eligible from the list).
Xcode fails to create a provisioning profile for the WebDriverAgentRunner target.

This necessitates manually changing the bundle id for the target by going into the "Build Settings" tab, and changing the "Product Bundle Identifier" from com.facebook.WebDriverAgentRunner to something that Xcode will accept.

Fail to start Appium server in 30 seconds. Katalon Studio can't start Appium server within 30 seconds (default timeout). You can increase this timeout value from this settings: Project → Settings → Execution → Default → Default wait for elements timeout (in seconds).
  • Fail to start the Appium server in 60 seconds.
  • Original error: 'x.x.SplashActivity' never started.

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: 

[debug] [ADB] Running '..\adb.exe' with args: [...] 
[debug] [ADB] Found package: '' 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 capabilities: 

 - 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).

Carthage is not found. Known issue of Appium 1.7 with Xcode 9:, so please use Katalon Studio to avoid this message.
Unable to Start Application on this device: Appium directory is invalid.

Katalon Studio cannot locate the provided Appium directory. Please double check your Appium directory to make sure it should be as shown below:

Windows: (Window → Katalon Studio Preferences → Mobile → Appium Directory).


MacOS/Linux: (Katalon Studio → Preferences → Mobile → Appium Directory).

com.kms.katalon.core.appium.exception.AppiumStartException: Appium directory is not set.

When running tests with Katalon Runtime Engine, by default Katalon checks the Appium directory at:

  • APPIUM_HOME environment variable (*).
  • Windows: C:\Users\AppData\Roaming\npm\node_modules\appium.
  • macOS and Linux: /usr/local/lib/node_modules/appium.

(*) To set Appium location by using APPIUM_HOME environment variable:

  • Windows:
  • macOS and Linux:
    export APPIUM_HOME=/usr/local/lib/node_modules/appium
  • java.util.concurrent.ExecutionException: org.openqa.selenium.WebDriverException: An unknown server-side error occurred while processing the command. Original error: Could not proxy command to the remote server. Original error: timeout of 240000ms exceeded.


    1. Install Webdriveragent.
    2. Kill the running appium proccesses with the following command:
      killall -9 node
    3. Start the AUT again.
    Katalon Mobile Recorder and SetText keyword cannot perform on an EditText element of the Flutter-based application


    1. Create a SetText Custom keyword.
    2. Run the test again in script mode.