Qampanion Logo
Qampanion

Setup

Install dependencies, create devices, and import your app before you run tests.

Dependencies

The application requires third-party dependencies to work correctly.

Install in the app

Dependency installation is available directly in the application:

Settings → Dependencies

All dependencies (except Xcode) are installed automatically inside the application.

⚠️ Wait until the installation process is fully completed before proceeding.

Install with the CLI

Dependencies can also be installed from the terminal. Use the CLI:

Dependency list

iOS platform

  • Xcode. As part of the Apple infrastructure, must be installed manually.
  • Axe

Android platform

  • Java 21+
  • Android SDK Command-line Tools, including:
    • sdkmanager
    • emulator
    • platform-tools
    • cmdline-tools
    • build-tools

Devices

Qampanion supports any emulators and simulators created with:

  • Xcode (iOS)
  • Android Studio (Android)

For convenience, device management and device creation are also available directly in Qampanion.

Go to: Settings → Devices

Then select:

  • platform (iOS / Android)
  • runtime/image (for example, iOS 18.2, Android 34)
  • device type / visual profile

⚠️ If the required runtime/image is not installed, Qampanion will prompt you to download it. Follow the instructions in the application.

Physical devices

Qampanion works with physical devices. It supports iOS and Android devices.

iOS

  1. Connect the device to your Mac with a USB cable. USB is recommended. Wi-Fi was unreliable in our tests. Tap Trust on the device.
  2. On the device, go to Settings → Privacy & Security → Developer Mode and turn it on. Restart the device and confirm.
  3. In Xcode, open Window → Devices and Simulators and select the device once. Wait until Xcode finishes preparing it.
  4. Keep the device unlocked while you run tests. Set Settings → Display & Brightness → Auto-Lock to Never.

The device appears in the Physical Devices section of the project status, next to your other devices.

Before a run, Qampanion checks the device. If the device is not ready, for example when it is locked, Qampanion writes the reason to the Console.

⚠️ Qampanion does not sign apps. Use an app build that is built for a device and signed for this device. The development profile must include the device UDID. A simulator build does not install on a device. Import the .app. Qampanion does not support .ipa files.

Tests use screen coordinates and snapshots, like on simulators.

Android

  1. On the device, go to Settings → About phone and tap Build number 7 times. This turns on Developer options.
  2. Go to Settings → System → Developer options and turn on USB debugging.
  3. Connect the device to your Mac with a USB cable. On the device, tap Allow in the Allow USB debugging? dialog. Select Always allow from this computer.
  4. In Developer options, turn on Stay awake. Remove the screen lock, or set it to None.

On some devices you must turn on more options. On Xiaomi devices, turn on Install via USB and USB debugging (Security settings).

The device appears in the Physical Devices section of the project status, next to your other devices.

Before a run, Qampanion checks the device. If the device is not ready, for example when it is locked or USB debugging is not allowed, Qampanion writes the reason to the Console.

⚠️ Use a USB cable. Wi-Fi debugging is not supported.

You can run any .apk that has a launcher activity. Import the .apk. Qampanion installs it on the device.

The status bar shows the clock and the battery level. They change all the time. Add excluded zones for them, so snapshots match.

Tests use screen coordinates and snapshots, like on emulators.

Applications

Go to: Settings → Applications

Qampanion supports importing applications:

  • from a local environment
  • from network sources

Supported formats:

  • .apk
  • .app
  • .zip (if it contains an .apk or .app file inside)

⚠️ Make sure the network resource is accessible before starting the import.