Mobile testing · v1.0.0

iOS Simulator App Tester

Operate one explicit iOS Simulator to build, install, exercise, diagnose, and visually verify an app with traceable evidence.

Verified release candidate
The candidate passed the bounded runtime evidence shown below. Download remains disabled until license approval and the final release manifest.

The outcome

Turn ordinary requests to run or test an iPhone/iPad app on a Mac into a safe, reproducible Simulator workflow while preserving project toolchain identity, device state, artifact identity, test oracles, and real-device limitations.

Use it when

  • Invoke automatically when the user asks to start, install, run, operate, test, screenshot, record, or diagnose an app in iOS Simulator on macOS.
  • Use for bounded outcomes such as verifying one journey, reproducing a crash, checking permission denial, capturing dark-mode screens, or preparing an isolated Simulator; do not use it as physical-device or App Store certification.

It does not do

  • Does not replace the user’s final authorization for project scope, account access, external changes, or business consequences.
  • Does not represent repository static checks as runtime certification across every platform, provider account, or production environment.

Inputs

  • Requested outcome and stop state, target project or Simulator `.app`, expected behavior, authorized state changes, desired device/runtime matrix, test data references, and evidence location.
  • Project-bound toolchain information, bundle/version/build identity, backend environment, required scenarios and oracles, cleanup policy, and any capability that needs real-device follow-up.

Outputs

  • The requested setup, installed build, verified scenario set, reproduced defect, visual capture, or cleanup state with exact Simulator, toolchain, artifact, and revision identity.
  • Inspected screenshots or recordings, scoped diagnostics, failure attribution, cleanup result, explicit limitations, real-device follow-up, and a validated secret-safe run manifest for nontrivial work.

Natural-language triggers

Run this Flutter app in an appropriate iPhone Simulator and verify the complete onboarding flow.
Reproduce the login crash on iOS Simulator, collect scoped evidence, and stop without changing the code.
Capture inspected light and dark mode screenshots at normal and accessibility text sizes.
Use $ios-simulator-app-tester explicitly only when automatic routing needs disambiguation.

Permission map

FilesWrite

May read project files and write bounded test artifacts and reports.

CommandsExecute

Runs local build, simulator, diagnostic, and test commands.

NetworkRead

Uses network access only when the target build or test requires it.

AccountsNone

Does not require an external account unless the target app itself requires one.

BrowserNone

No browser automation is required for the core workflow.

External changesChanges state

Changes only the explicitly selected simulator and local build state.

Environment & requirements

Agents

  • Codex
  • Claude Code

Platforms

  • macOS

Required tools

  • Xcode
  • iOS Simulator
  • target app toolchain

Data handling

May read local projects, simulator logs, and test screenshots; evidence must be sanitized and must not contain real user data or credentials.

Credential handling

Uses only existing secure credential channels authorized by the user; tokens, keys, cookies, private keys, and real user data must not be copied into the Skill, logs, reports, or public artifacts.

Verification evidence

Version 1.0.0 completed a project-bound FVM build, exact-UDID install, installed-identity read-back, launch, human screenshot inspection, scoped diagnostics, and state restoration on a real iOS Simulator without deleting a device, app data, or collecting an app container.

Level
Verified
Checked
2026-10-12
Expires
2027-01-10
Source revision
fac86e9d2646

Environment

  • macOS 26.2
  • Xcode 26.2 Build version 17C52
  • Flutter 3.27.0 via project-bound .fvm/flutter_sdk
  • iOS 26.3 on iPhone 17 Pro (exact UDID used during the private run and omitted from public evidence)

Targets checked

  • Candidate ZIP validator self-test and completed-run manifest validation
  • Project-bound FVM iOS Simulator Debug build
  • Exact-UDID boot, install, installed identity read-back, launch, screenshot, terminate, and shutdown
  • Human visual inspection of the rendered first screen
  • Scoped Runner error and fault diagnostics without app-container capture

Evidence IDs

  • ios-simulator-validator-self-test
  • ios-simulator-fvm-build-install-manifest
  • ios-simulator-capture-manifest
  • ios-simulator-installed-identity
  • ios-simulator-inspected-launch-screenshot
  • ios-simulator-scoped-diagnostics

Limits & support

Known limitations

  • Verification applies only to the exact artifact, source revision, environment, and test scope recorded; it does not certify every provider account, region, or future version.
  • Agents, platforms, and provider interfaces continue to change; each run must inspect current state and respect explicit confirmation gates.
  • Verification used one iPhone 17 Pro Simulator on iOS 26.3 and does not represent every device or OS version.
  • The sample app emitted a RevenueCat default-offering warning in Simulator; this is not a skill execution failure and the app was not labeled fully verified.
  • Real-device performance, production StoreKit transactions, APNs, hardware capabilities, and App Store distribution still require separate verification.

Permission changes

  • No permission change is declared for this release; for a first public release, the permission map on this page is authoritative.

Channel
Submit through support@xiaoyuelabs.com or the on-site inquiry form.

Response target
Receipt is acknowledged within two business days; remediation timing is confirmed after reproduction and scope review.

Scope
Free support covers download integrity, documentation errors, and reproducible Skill defects; project adaptation, managed operation, and ongoing maintenance are separate services.

Release notes

v1.0.0
  • Added a natural-language iOS Simulator workflow covering inventory, build/install, interaction, environment variation, diagnosis, capture, cleanup, and full verification outcomes.
  • Bound Flutter work to the project's FVM toolchain, selected Simulator devices by exact UDID, preserved existing data by default, and separated Simulator evidence from claims requiring real hardware.
  • Added a bilingual, secret-safe test-run manifest and validator that reject global Flutter, broad or unauthorized destructive actions, incomplete evidence gates, and unsupported success claims.

Install & verify

Release access

Runtime verified, release approval pending

v1.0.0

The private candidate passed the bounded runtime checks shown above. Public delivery remains closed until every release gate below is independently complete.

  1. Runtime verificationComplete for this exact candidate and source revision.
  2. Owner-approved licenseXiaoyue Skill License 1.0 was approved on October 13, 2026.
  3. Checksum-bound release manifestCreated separately for each explicitly published release.
  4. Private R2 upload and read-backNot uploaded and not publicly reachable.