What is xcb and how does this skill help?

xcb is a CLI wrapper for Apple's xcodebuild. This skill helps you correctly configure the xcb.json file to map your project schemes to the right workspaces and build settings.

Does this skill help with opening projects?

Yes, it configures 'open shortcuts' and aliases, allowing you to use simple commands like 'xcb open demo' to launch specific Xcode containers instantly.

Can I use this for Swift Packages?

Yes, the skill allows you to configure 'packageDir' entries in xcb.json, which is ideal for building libraries that require specific iOS SDKs or simulators.

How do I define a specific iOS Simulator for builds?

You can use the 'destination' field in your build entry to specify strings like 'platform=iOS Simulator,name=iPhone 15' to ensure consistent testing environments.

What is the benefit over using raw xcodebuild commands?

It replaces long, error-prone shell commands with short, readable aliases and a central configuration file that can be version-controlled with your project.

Xcode Build Configuration (xcb)

Name: Xcode Build Configuration (xcb)
Author: jcfontecha

byjcfontecha

•

Mobile Development

Configures the xcb.json file to streamline iOS and macOS build workflows by mapping Xcode schemes to projects, workspaces, and Swift packages.

About

The xcb-config skill simplifies the management of Apple development workflows by automating the setup of xcb.json, the configuration file for the xcb CLI wrapper. This skill enables developers to map complex Xcode schemes to their respective containers, define target destinations like specific iOS Simulators, and set build configurations once to avoid repetitive xcodebuild parameters. It is particularly valuable for projects involving multiple workspaces, Swift packages requiring UIKit environments, and teams looking to standardize their command-line build processes through custom aliases and shortcuts.

Key Features

Automated mapping of Xcode schemes to workspaces, projects, or Swift packages
Configuration of persistent build destinations and SDK settings for consistency
Creation of custom CLI aliases to quickly open specific project targets
Support for Swift Packages requiring iOS Simulator environments for UIKit
Standardization of build environments across multi-container repositories
2 GitHub stars

Use Cases

Defining standardized build environments for teams to ensure consistent CI/CD and local results
Managing complex monorepos containing multiple app schemes, test suites, and demo projects
Building Swift packages that depend on iOS-specific frameworks which standard 'swift build' cannot handle

About

Key Features

Automated mapping of Xcode schemes to workspaces, projects, or Swift packages
Configuration of persistent build destinations and SDK settings for consistency
Creation of custom CLI aliases to quickly open specific project targets
Support for Swift Packages requiring iOS Simulator environments for UIKit
Standardization of build environments across multi-container repositories
2 GitHub stars

Use Cases

Defining standardized build environments for teams to ensure consistent CI/CD and local results
Managing complex monorepos containing multiple app schemes, test suites, and demo projects
Building Swift packages that depend on iOS-specific frameworks which standard 'swift build' cannot handle