Fastmonkey iOS Monkey Testing Tool: Setup, Configuration, and Usage Guide

Fastmonkey is an open‑source iOS Monkey testing tool built on XCTestWD and swiftMonkey, offering a lightweight and efficient way to perform random UI actions on iOS applications.

Advantages: 1) No instrumentation required; 2) High efficiency with 4‑5 actions per second; 3) Minimal configuration and quick start.

Runtime environment setup: 1. Install Carthage: brew install carthage . 2. Install usbmuxd (for iproxy): brew install usbmuxd . 3. Clone the Fastmonkey repository from https://github.com/zhangzhao4444/Fastmonkey . 4. Navigate to the XCTestWD‑master directory and run carthage update --no-use-binaries to fetch dependencies. 5. Configure certificates and bundle identifier in the Fastmonkey project.

Project configuration: - Modify the bundle ID in server/XCTestWDMonkey.swift to match the target app. - Set the desired test duration (seconds) by editing elapsedTime in server/Controller/Monkey.swift . - Optional checks: enable or comment out addXCTestCheckCurrentApp (background/app exit detection) and addXCTestTapAlertAction (alert handling). - Choose which actions to include via addDefaultXCTestPrivateActions (e.g., element taps, random taps, long‑press, pinch, swipe, etc.).

Custom actions: To exclude a specific button (e.g., “Force Crash”), add a conditional check in addXCTestElementTapAction . Random tap points can be generated with randomPoint() , randomPointAvoidingPanelAreas() , or randomPoint(inRect: CGRect) , and tap areas can be limited by modifying the code in addXCTestTapAction .

Executing Fastmonkey: Install the target app on a physical iPhone, connect the device via USB, use iproxy for port mapping, select the XCTestWDUITests scheme, then run Product → Test . Test logs appear continuously in the Xcode log window.

Viewing logs: After the test finishes or is stopped, the log file path is displayed in the Xcode console; the logs can be opened with Visual Studio Code for analysis.

References: CSDN article , TesterHome discussion .