xctool

Created April 23, 2013Updated November 4730 Forks6525 Stars1186 Commits9 Open IssuesMobile · Infra · iOS · Compilation · Testing

xctool is a replacement for Apple's xcodebuild that makes it easier to build and test iOS and Mac products. It's especially helpful for continuous integration.

xctool is drop-in replacement for xcodebuild that adds a few extra features. Firstly, it runs the same tests as Xcode.app. Surprisingly, Apple's command-line xcodebuild tool does not run your product's tests the same way as Xcode.app. xcodebuild doesn't understand which targets in your scheme are test targets, which test suites or cases you might have disabled in your scheme, or how to run simulator-based, application tests.

xctool provides structured output of build and test results. It captures all build events and test results as structured JSON objects. If you're building a continous integration system, this means you don't have to regex parse xcodebuild output anymore.

xcodebuild provides human-friendly, ANSI-colored output, and can be incredibly verbose, printing the full compile command and output for every source file. By default, xctool is only verbose if something goes wrong, making it much easier to identify where the problems are.

xctool is fast, and can optionally run all of your test bundles in parallel, speeding up your test runs significantly. At Facebook, we've seen 2x and 3x speed ups by parallelizing our runs.

Created April 23, 2013Updated November 4730 Forks6525 Stars1186 Commits9 Open IssuesMobile · Infra · iOS · Compilation · Testing

Keep Updated

Stay up-to-date via RSS with the latest open source project releases from Facebook, news from our Engineering teams, and upcoming events.

Subscribe
Facebook © 2017