Katalon Studio无法启动Android设备录制或对象识别求助

Hey there! Even though I can't see your error screenshot, I’ve run into tons of similar issues setting up Katalon mobile automation on macOS, so let’s walk through the most common fixes that usually resolve these problems:

• Verify Xcode Command Line Tools Configuration
  Open your Terminal and run xcode-select --install to make sure the tools are fully installed. Once done, set the correct path with:

  sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
  

  Restart Katalon after this—incorrect Xcode paths are one of the top culprits for iOS automation failures.

• Double-Check Android SDK Environment Variables
  Make sure ANDROID_HOME and PATH are properly set in your system:

  1. Run echo $ANDROID_HOME in Terminal—it should return your Android SDK path (typically ~/Library/Android/sdk).
  2. Run echo $PATH and confirm it includes $ANDROID_HOME/platform-tools and $ANDROID_HOME/tools.
     If either is missing, edit your shell config file (~/.zshrc for Zsh, ~/.bash_profile for Bash) and add these lines:

  export ANDROID_HOME=~/Library/Android/sdk
  export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools
  

  Save the file, run source ~/.zshrc (or your respective config file) to apply changes, then restart Katalon.

• Confirm Device Connection & Authorization

  • For iOS devices: Open Xcode, go to Window > Devices and Simulators to ensure your device is recognized, trusted by your Mac, and has valid developer certificates/provisioning profiles installed.
  • For Android devices: Enable USB debugging on your device, then run adb devices in Terminal. If your device shows up here, the connection is good; if not, try a different USB cable or re-approve the Mac’s authorization prompt on your device.

• Validate Katalon's Internal Settings
  Open Katalon, go to Preferences > Mobile and double-check that the Android SDK path and Xcode path match your actual installation directories. If everything looks correct, try clicking the "Reset Android SDK" button, then restart Katalon.

• Clear Caches & Restart
  Sometimes stale cache causes unexpected issues:

  • Close Katalon completely, then delete the cache files in ~/.katalon
  • Restart your Mac, then launch Katalon again and test your automation flow.

内容的提问来源于stack exchange，提问作者Fandratt Muda