Troubleshooting automated mobile testing overview

📄️ Common iOS dependencies installation issues

The following are some common issues you may encounter when install iOS dependencies.

📄️ Common WebDriverAgent installation issues

The following are some common issues you may encounter when install WebDriverAgent.

📄️ An unknown server-side error occurred while processing the command

When you encounter the error java.util.concurrent.ExecutionException An unknown server-side error occurred while processing the command. Original error timeout of 240000ms exceeded.

📄️ Appium directory is not set

When you encounter the following error com.kms.katalon.core.appium.exception.AppiumStartException: Appium directory is not set.

📄️ Carthage is not found

This is a known issue of ADppium 1.7 with Xcode 9. To learn more about this issue, you can refer to this GitHub thread: Appium 1.7 with Xcode 9 known issues.Use Katalon Studio 5.1.0.2+ to avoid this issue.

📄️ Conflicting Apple Developer accounts

Cannot record/playback the application because of multiple Apple Developer accounts conflict.

📄️ Connected device not displayed in 'Device Name' list

When you cannot see the connected device displayed in the Device Name list, it can be because one of the following causes:

📄️ Encounter 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).D

📄️ 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 element timeout (in seconds).

📄️ Fail to start the Appium server in 60 seconds

When you encounter one of the following errors 'x.x.SplashActivity' never started.

📄️ Failed to launch process with bundle identifier on iOS device

Failed to launch process with bundle identifier such as com.johndoe.WebDriverAgentRunner.xctrunner. Underlying Error: The operation couldn't be completed. Unable to launch com.johndoe.WebDriverAgentRunner.xctrunner because it has an invalid code signature, inadequate entitlements or its profile has not been explicitly trusted by the user.

📄️ How to resolve "No Driver Found" error in mobile testing?

This error message shows when executing mobile tests No driver found{"\n"}

📄️ How to uninstall and re-install Appium

There are some cases we cannot define the rootcauses for iOS devices' issues. The best practice is to re-install Appium.

📄️ Error "HTTP method that is not supported by the mapped resource" when Tap/Swipe on Mobile

You are unable to perform the Swipe action on your device and might encounter the following error org.openqa.selenium.UnsupportedCommandException: The requested resource could not be found, or a request was received using an HTTP method that is not supported by the mapped resourceRefer to the two causes below to identify your solutions.

📄️ Unable to save test steps in Mobile Recorder

You encounter the following error message: The file path is too long. You should shorten the name and try again.

📄️ Unable to Start Application on this device: Appium directory is invalid

Katalon Studio cannot locate the provided Appium directory.Double check your Appium directory to make sure it should be as shown below (Windows > Katalon Studio Preferences > Mobile > Appium Directory).C (Katalon Studio > Preferences > Mobile > Appium Directory)./usr/local/lib/nodemodules/appium

📄️ Unable to Start Application while running Android tests on a Windows machine

1. Upgrade to the latest version of Appium.

📄️ Unable to start application

This happens when:Missing one or more dependencies.Outdated or incompatible dependencies.Wrong dependencies installation order.Broken WebDriverAgent build package.Reinstall dependencies.Rebuild WebDriverAgent. Learn how to rebuild WebDriverAgent at Install WebDriverAgent.

📄️ 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.

📄️ No Chromedriver found that can automate Chrome '<chrome_version>'

While testing web apps on mobile browsers, you might encounter a ChromeDriver related error No Chromedriver found that can automate Chrome_version

📄️ Set proxy certificate when connecting to remote devices

When spying, recording, or executing mobile tests with remote devices through a proxy, you may encounter the issue where Katalon Studio cannot create remote session org.openqa.selenium.SessionNotCreatedException PKIX path building failed {"\n"}unable to find valid certification path to requested target

📄️ Unable to create a new remote session with iOS real devices

You encounter the following error org.openqa.selenium.SessionNotCreatedException An unknown server-side error occurred while processing the command. Original error xcodebuild failed with code 65

📄️ Unable to detect all elements during mobile testing on BrowserStack

When running mobile tests on BrowserStack, Katalon Studio may fail to detect all elements during test execution.

📄️ Unable to execute tests with iOS on macOS Ventura and XCode 14.x

macOS Ventura no longer supports older Xcode versions. To test from it, you must have Xcode 14.x. However, there's an issue when using Xcode 14.x with Appium 1.x due to the outdated built-in XCUITest driver. To use Xcode 14.x with Appium 1.x, you need to update the XCUITest driver to a newer version.Install Appium XCUITest driver version 4.32.24 or newerNavigate to nodemodules/appium-webdriveragent and open WebDriverAgent.xcodeproj file in Xcode with the following commandUncheck Automatically manage signing.Select Target &gt; WebDriverAgentRunner.Select Signing &amp; Capabilities.Select Provisioning Profile. Make sure you have installed Certificate &amp; Wildcard Provisioning Profile on your machine.Select Product &gt; Test.

📄️ Unable to start the application. Original error: socket hang up on iOS 15.5

When recording with real mobile devices using Katalon Studio's Mobile Recorder, the following error shows up socket hang up.