build-ios-project

Build iOS Project Skill

This skill builds the AIQ iOS project using xcodebuild to verify that the project compiles successfully.

Usage

When this skill is invoked, build the iOS project to verify compilation.

Build the Project

Run the following command to build the project:

cd /Users/mattgioe/aiq/ios && xcodebuild build -project AIQ.xcodeproj -scheme AIQ -destination 'platform=iOS Simulator,name=iPhone 16,OS=18.3.1' 2>&1

Build for Release (Optional)

If specifically requested, build in Release configuration:

cd /Users/mattgioe/aiq/ios && xcodebuild build -project AIQ.xcodeproj -scheme AIQ -destination 'platform=iOS Simulator,name=iPhone 16,OS=18.3.1' -configuration Release 2>&1

Clean Build (Optional)

If a clean build is requested or there are stale build artifacts:

cd /Users/mattgioe/aiq/ios && xcodebuild clean build -project AIQ.xcodeproj -scheme AIQ -destination 'platform=iOS Simulator,name=iPhone 16,OS=18.3.1' 2>&1

Arguments

When invoked with arguments, parse them to determine the build type:

• No arguments: Standard debug build
• clean: Clean and rebuild
• release: Build in Release configuration
• clean release: Clean and rebuild in Release configuration

Interpreting Results

• Build Succeeded: The project compiles without errors
• Build Failed: Check the output for:
  • Compilation errors (syntax errors, type mismatches)
  • Linker errors (missing symbols, duplicate symbols)
  • Missing dependencies or frameworks

Common Build Errors

Troubleshooting

Simulator Not Found

If the destination simulator isn't available, list available simulators:

xcrun simctl list devices available

Then adjust the -destination parameter accordingly.

Derived Data Issues

If builds fail with strange caching issues, clean derived data:

rm -rf ~/Library/Developer/Xcode/DerivedData/AIQ-*

Missing Files in Target

If files compile locally but fail in build, verify they're added to the Xcode project using the /xcode-file-manager skill.

When to Use This Skill

Use this skill:

• After writing or modifying Swift code to verify it compiles
• Before running tests to catch compilation errors early
• Before committing changes to ensure the project builds
• When debugging build failures reported by CI

Related Skills

• /run-ios-test: Run the test suite after confirming the build succeeds
• /xcode-file-manager: Add new Swift files to the Xcode project