Agent Skills › Prisma-Labs-Dev/apple-skills › xcuitest

xcuitest

GitHub

提供XCUITest UI测试的Swift 6参考文档，涵盖元素查询、交互、等待模式、并发处理、断言及截图等核心API与最佳实践。

skills/xcuitest/SKILL.md Prisma-Labs-Dev/apple-skills

Trigger Scenarios

编写iOS UI自动化测试代码查询XCUITest API用法解决UI测试中的元素查找或同步问题配置Swift 6并发测试环境

Install

npx skills add Prisma-Labs-Dev/apple-skills --skill xcuitest -g -y

More Options

Use without installing

npx skills use Prisma-Labs-Dev/apple-skills@xcuitest

指定 Agent (Claude Code)

npx skills add Prisma-Labs-Dev/apple-skills --skill xcuitest -a claude-code -g -y

安装 repo 全部 skill

npx skills add Prisma-Labs-Dev/apple-skills --all -g -y

预览 repo 内 skill

npx skills add Prisma-Labs-Dev/apple-skills --list

SKILL.md

Frontmatter

{
    "name": "xcuitest",
    "agent": "Explore",
    "context": "fork",
    "description": "API reference: XCUITest. Query for element queries, waiting patterns, Swift 6 @MainActor, assertions, screenshots, launch arguments.",
    "user-invocable": true
}

XCUITest Reference

Comprehensive reference for writing reliable XCUITest UI tests in Swift 6.

Quick Reference

// Basic test structure
@MainActor
final class MyUITests: XCTestCase {
    var app: XCUIApplication!

    override func setUp() {
        super.setUp()
        continueAfterFailure = false
        app = XCUIApplication()
        app.launch()
    }

    func testExample() {
        let button = app.buttons["Submit"]
        XCTAssertTrue(button.waitForExistence(timeout: 5))
        button.tap()
    }
}

Topic Guides

Curated guidance with code examples (grep-friendly):

File	Content
element-queries.md	Core API classes: XCUIApplication, XCUIElement, XCUIElementQuery, XCUICoordinate
interactions.md	Taps, presses, text input, swipes, coordinate-based and other gestures
waiting.md	waitForExistence, XCTWaiter, non-existence, property waits, Xcode 26 KeyPath waits
swift6-concurrency.md	Swift 6 strict concurrency: @MainActor test classes, async setUp/tearDown, nonisolated
assertions.md	XCTAssert patterns, custom messages, existence checks
screenshots.md	Screenshots, XCTAttachment, screenshot-on-failure, extracting from .xcresult
launch-arguments.md	Launch arguments/environment, UserDefaults override, localization and accessibility testing
permissions.md	resetAuthorizationStatus, XCUIProtectedResource, interruption monitors, springboard/system alerts
test-helpers.md	Page Object Model, reusable helpers, timeout constants
troubleshooting.md	Common failures (element not found, flaky tests) and what's new in Xcode 26 / iOS 26
patterns.md	Advanced patterns: base test class, system dialogs, scroll/wait, debugging, test organization

Downloaded Reference Files

Apple documentation pages available locally:

File	Content
xctest-index.md	Full XCTest framework index
xcuiautomation-index.md	Full XCUIAutomation framework index
xcuiapplication.md	XCUIApplication class
xcuielement.md	XCUIElement class
xcuielementquery.md	XCUIElementQuery class
xcuicoordinate.md	XCUICoordinate class
xcuiprotectedresource.md	XCUIProtectedResource enum
xcuiscreenshot.md	XCUIScreenshot class

Sources

Apple Documentation

WWDC Sessions

Community Resources

Fetching More Apple Docs

Search this skill's local .md files first.
If the topic is not here, check the other installed Apple skills you have available by their names, descriptions, or SKILL.md frontmatter, then grep their local files. This is faster and uses less context than fetching new docs from the internet.
If no installed skill has the page, use the relevant documentation path from the local XCTest or XCUIAutomation indexes with the sosumi.ai Markdown mirror. For example, /documentation/xcuiautomation/xcuielement maps to https://sosumi.ai/documentation/xcuiautomation/xcuielement.