Reference

GptDriver

Constructor

GptDriver(
    apiKey: String,
    nativeApp: XCUIApplication,
    cachingMode: CachingMode = .none,
    testId: String = "",
    additionalUserContext: String = "",
    enableSelfHealing: Bool = true
)

Parameter	Type	Description
`apiKey`	`String`	Your MobileBoost API key
`nativeApp`	`XCUIApplication`	The app instance to test
`cachingMode`	`CachingMode`	Caching strategy (`.none`, `.fullScreen`, `.interactionRegion`)
`testId`	`String`	Identifier for the test (used for caching and logging)
`additionalUserContext`	`String`	Context to guide AI behavior across all steps
`enableSelfHealing`	`Bool`	Enable/disable self healing globally

AI commands

execute

Execute a natural language instruction on the current screen.

try gptDriver.execute("Tap on the Go to Second Screen button")

assert

Verify a condition without taking action. Throws on failure.

try gptDriver.assert("The home screen is displayed")

extract

Extract information from the current screen.

let data = try gptDriver.extract("username", "account balance")

Session URL

The SDK creates a session URL for each test run, accessible via:

gptDriver.sessionURL: public property
onSessionCreated callback: for real-time access
XCTest Attachments: saved as a .webloc file in test results
OS Logs: logged at .notice level

Retrieving in CI

The session URL is saved as an XCTest attachment named GPTDriver Session URL Link with lifetime .keepAlways. Extract it from the .xcresult bundle in your CI pipeline.

Local tooling

Agent skill

MCP

SDK

GptDriver

Constructor

AI commands

execute

assert

extract

Session URL

Retrieving in CI

​GptDriver

​Constructor

​AI commands

​execute

​assert

​extract

​Session URL

​Retrieving in CI

GptDriver

Constructor

AI commands

execute

assert

extract

Session URL

Retrieving in CI