Setup

The MobileBoost SDK for XCUI integrates directly with XCUIApplication, adding self-healing and AI commands to your native iOS tests.

Installation

Add the gptd_swift package to your Xcode project’s UI testing target via Swift Package Manager:

In Xcode, go to your project settings
Select your UI test target
Click Add Dependencies
Enter the package URL: https://github.com/MobileBoostHQ/gptd-swift

Configuration

Native XCUITest

Import the package and initialize GptDriver in your test’s setUp method:

import XCTest
import gptd_swift

@MainActor
final class DemoUITests: XCTestCase {

    var app: XCUIApplication!
    var gptDriver: GptDriver!

    override func setUpWithError() throws {
        continueAfterFailure = false

        app = XCUIApplication()
        app.launch()

        gptDriver = GptDriver(
            apiKey: "<YOUR_API_KEY>",
            nativeApp: app
        )
    }

    override func tearDownWithError() throws {
        app = nil
    }
}

Caching

To optimize execution time, enable caching so AI is only used when the test definition or app changes.

Mode	Description
`NONE`	No caching
`FULL_SCREEN`	Cache hit only if the full screen matches a previous successful execution
`INTERACTION_REGION`	Cache hit if the interaction region matches (recommended)

Set caching in the constructor:

gptDriver = GptDriver(
    apiKey: "<YOUR_API_KEY>",
    nativeApp: app,
    cachingMode: CachingMode.interactionRegion,
    testId: self.name
)

You can also override the caching mode per step for fine-grained control.

Local tooling

Agent skill

MCP

SDK

Installation

Configuration

Native XCUITest

Caching

​Installation

​Configuration

​Native XCUITest

​Caching

Installation

Configuration

Native XCUITest

Caching