XCTools

XCTools is a command-line utility designed to streamline common Xcode-related tasks for iOS developers. It provides easy-to-use commands for managing derived data, refreshing dependencies, and running test plans.

Features

• Remove Derived Data: Quickly clean up Xcode's derived data folder.
• Fresh Installation: Easily reinstall pods and reset package cache.
• Launch Test Plans: Interactively select and run specific test plans.

Installation

Requirements

• macOS 10.15 (Catalina) or later
• Xcode 13.0 or later
• Swift 5.10 or later

Using Homebrew

You can easily install XCTools using Homebrew:

brew tap thepearl/xctools
brew install xctools

From Source

If you prefer to install from source:

1. Clone the repository:

   git clone https://github.com/thepearl/XCTools.git

2. Navigate to the project directory:

   cd XCTools

3. Build the project:

   swift build -c release

4. Install the binary:

   cp -f .build/release/XCTools /usr/local/bin/xctools

Usage

After installation, you can run XCTools using the xctools command.

General Help

To see all available commands:

xctools --help

Remove Derived Data

To remove Xcode's derived data:

xctools remove-dd

Options:

• --path <path>: Specify a custom path for derived data.
• --clean: Clean the project after removing derived data.

Example with options:

xctools remove-dd --path ~/CustomDerivedData --clean

Fresh Installation

To reinstall pods and reset package cache:

xctools fresh

Options:

• --spm: Also freshen Swift Package Manager dependencies.

Example with SPM option:

xctools fresh --spm

Launch Test Plans

To interactively launch a test plan:

xctools test

This command will guide you through selecting:

1. The target
2. The test plan
3. The iOS version

Follow the prompts to select your desired options.

Contributing

We welcome contributions to XCTools! If you have a feature request, bug report, or want to contribute code, please open an issue or pull request on our GitHub repository.

License

XCTools is released under the GNU General Public License v3.0 (GPL-3.0). See the LICENSE file for details.

Support

If you encounter any issues or have questions, please file an issue on the GitHub issue tracker.

Thank you for using XCTools!