Skip to main content

​
iOS Real Devices

Tests can be run on physical iOS devices connected via USB.
  • iOS device with iOS 15 or later
  • USB cable (preferably original or certified)
  • Mac with Xcode and Xcode Command Line Tools
  • Apple Developer account (for provisioning and signing)
  • Device must be trusted and visible in Finder

​
Troubleshooting

If you encounter issues connecting or running tests on your device, try the following solutions:

​
Change port

Sometimes switching device to a different port can resolve connection issues.

​
Reboot Device and Mac

Restart both your iOS device and your Mac to clear any temporary connection or driver issues.

​
Manually Sign WebDriverAgent

If you see signing errors with WebDriverAgent, you may need to open and sign the project manually: Run this command in Terminal: 
open "$HOME/Library/Application Support/com.codeandbicycles.noqa/.appium/node_modules/appium-xcuitest-driver/node_modules/appium-webdriveragent/WebDriverAgent.xcodeproj"
In Xcode, go to the Targets list and select both IntegrationApp and WebDriverAgentRunner. For each target, open the Signing & Capabilities tab, set your Team, and ensure the provisioning profile is valid. Build the project once, then retry your test run.

​
iOS Simulators

You can also run tests on iOS Simulators available in Xcode:
  • Create and manage simulators using Xcode’s Device Manager
  • Start the desired simulator before running tests
  • The noqa app will automatically detect running simulatorr

​
Android Real Devices

Tests can be run on physical Android devices connected via USB with USB debugging enabled. The device must be visible via adb devices command.
  • Android device with Android 6.0 (API level 23) or later
  • USB cable
  • USB debugging enabled on the device
  • Device must be visible via adb devices command

​
Android Emulators

You can also run tests on Android emulators created in Android Studio:
  • Create an emulator using AVD Manager in Android Studio
  • Start the emulator before running tests
  • The noqa app will automatically detect running emulators
  • Emulators must have Google Play Services installed for app installation
For best performance, use an emulator with hardware acceleration (Intel HAXM or Apple Silicon virtualization).