debug-run-ios

Build and install Compose Multiplatform iOS apps on simulators with xcodebuild.

Updated Oct 6, 2024
One-click install
npx skills add https://github.com/s-iwasaki-b/Compose-Multiplatform-Starter-Template --skill debug-run-ios
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-run-ios
Source: https://github.com/s-iwasaki-b/Compose-Multiplatform-Starter-Template/tree/main/.claude/skills/debug-run-ios
Command: npx skills add https://github.com/s-iwasaki-b/Compose-Multiplatform-Starter-Template --skill debug-run-ios

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual effort of building, installing, and launching a Compose Multiplatform iOS app on a simulator while surfacing build and runtime issues clearly.

Core Features & Use Cases

  • Simulator-aware execution: Detects booted iPhone or iPad simulators and falls back to available devices when needed.
  • End-to-end iOS validation: Builds the app with xcodebuild, installs the generated app bundle, launches it, and checks for runtime errors.
  • Useful for debugging: Helps verify that a current branch compiles and runs on iOS before handing off a fix or release candidate.

Quick Start

Ask the skill to build, install, and launch the iOS app on the currently running simulator and report any build or runtime errors.

Frequently Asked Questions about debug-run-ios

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

FAQPage Schema
How do I build and install a Compose Multiplatform iOS app on a simulator?

Building and installing a Compose Multiplatform iOS app requires using xcodebuild to compile the active Xcode iOS scheme, installing the generated app bundle on a booted simulator, and launching it to check for runtime errors.

How can I check iOS simulator runtime logs for crashes in a Compose Multiplatform app?

Checking iOS simulator runtime logs involves inspecting runtime log data after launching the app to surface compile, signing, crash, and exception issues during the debug verification workflow.

What is needed to automate iOS simulator app deployment for debugging?

Automating iOS simulator app deployment requires xcodebuild for compilation, simctl for device management, DerivedData app discovery for locating the bundle, and runtime log inspection to surface failures.

Does this debugging workflow support booted iPhone and iPad simulators?

Yes, the debugging workflow supports booted iPhone or iPad simulators by detecting active devices and falling back to available devices when needed to execute the build, install, and launch validation process.