ios-device-automation

Automate iOS device build, install, launch, test, and diagnostic workflows using devicectl and xcodebuild.

8|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/ChoshimWy/iOSAgentSkills --skill ios-device-automation-choshimwy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-device-automation
Source: https://github.com/ChoshimWy/iOSAgentSkills/tree/main/skills/ios-device-automation
Command: npx skills add https://github.com/ChoshimWy/iOSAgentSkills --skill ios-device-automation-choshimwy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires xcrun, devicectl, xcodebuild, and includes scripts (resource) and references (resource) components.

What problem does it solve?

将真机自动化流程整合为一个可重复执行的 Skill,帮助开发者在连接中的 iPhone/iPad 上完成目标设备识别、构建、安装、启动、测试与诊断,避免手动重复操作。

Core Features & Use Cases

  • 自动选择已连接/已配对设备,执行构建、安装、启动和测试等流程
  • 获取设备信息、查看正在运行的进程、收集诊断信息
  • 若任务涉及 Simulator、签名或构建策略变更时,提供明确的切换与回退到 verify-ios-build 的约束

Quick Start

Run the device_build_and_test.sh script from the repository root with appropriate arguments to start on-device automation.

Frequently Asked Questions about ios-device-automation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate building and installing an iOS app on a connected device?

To automate on-device iOS build and install, you can run the device_build_and_test.sh script which uses devicectl and xcodebuild destinations to automatically select paired devices, execute builds, install apps, and launch tests without manual intervention.

What is devicectl used for in iOS on-device automation?

devicectl is the official command-line tool used in iOS on-device automation to interact with connected devices, enabling automated device selection, retrieving device information, viewing running processes, and collecting diagnostic data during testing workflows.

Do I need Xcode tools to run on-device iOS testing from the command line?

Yes, on-device iOS testing requires Xcode command-line tools including xcrun, devicectl, and xcodebuild to identify connected devices, execute build destinations, install applications, and run diagnostic workflows on real iPhones or iPads.

When should I use simulator testing instead of on-device iOS automation?

You should switch to a simulator or verify-ios-build when your tasks involve simulator-specific testing, signing changes, or build strategy modifications, as the automation provides explicit fallback constraints for these scenarios.

How do I collect diagnostics and running processes from a connected iPhone?

You can collect diagnostics and view running processes from a connected iPhone by executing the automation scripts that leverage devicectl to retrieve device information and gather diagnostic data during your build and test cycles.