Xcode-compatible build tool.
Go to file
Saleem Abdulrasool 8433d68034 libcar: silence a -Wsign-compare warning
When building libcar for Windows, the array size calculation would be of type
`unsigned long long` (aka `size_t`).  However, `identifier` is of type
`enum car_attribute_identifier` (aka `int`).  This results in a warning due to
the sign mismatch.  Perform an explicit cast to the size type for the
comparision to silence the warning.

Take the opportunity to move the constant expression of the array length into a
variable for ease of readability.
2018-01-22 00:48:08 -08:00
Libraries libcar: silence a -Wsign-compare warning 2018-01-22 00:48:08 -08:00
Specifications Fix issues raised in PR #242 regarding swift compilation changes 2017-04-11 01:14:33 +09:00
ThirdParty Update gtest to a version with Windows support. 2017-06-19 11:52:20 -07:00
.gitattributes Add notes for GitHub's Linguist tool. 2015-11-04 22:19:26 -08:00
.gitignore Add build-* directories to .gitignore 2016-10-03 13:02:50 -07:00
.gitmodules Add basic PlistBuddy (#111) 2016-09-29 09:19:54 +07:00
.travis.yml Add CI for Windows using AppVeyor and Travis. 2017-06-19 11:52:20 -07:00
appveyor.yml Add CI for Windows using AppVeyor and Travis. 2017-06-19 11:52:20 -07:00
CMakeLists.txt Add Windows, MSVC, and MinGW support to build configuration. 2017-06-19 11:52:20 -07:00
CONTRIBUTING.md Update component list in contributing document. 2016-10-01 23:13:45 +07:00
LICENSE Fix minor issues revealed by static analysis. 2016-09-02 22:59:40 -07:00
Makefile Add CI for Windows using AppVeyor and Travis. 2017-06-19 11:52:20 -07:00
PATENTS Add README, LICENSE, and PATENTS. Move third-party licenses. 2015-11-04 22:22:30 -08:00
README.md Fix syntax highlighting in README 2017-06-25 18:23:45 -07:00

xcbuild

xcbuild is an Xcode-compatible build tool with the goal of providing faster builds, better documentation of the build process and running on multiple platforms (macOS, Linux, and Windows)

Why xcbuild?

Features Performance
🚀Blazing fast incremental buildsxcodebuildxcbuild + Ninja
📖Documents the Xcode build process
🔗Builds Xcode projects and workspaces
🐣Supports Swift apps and frameworksClean Build30.103s25.122s
Tools and libraries for Xcode projects
💝Fully compatible with xcpretty
🎩Uses Ninja and llbuildIncremental Build2.190s0.046s
:octocat:Open source under the BSD license
🐧Builds on Linux and Windows

xcbuild and other build tools

xctool Buck xcpretty
xcbuild and xctool are both Xcode-compatible build systems. We plan on slowly deprecating xctool's build support but keep it as a great way to run tests. Facebook's main build system is Buck. Buck has a stronger architecture and advanced features like artifact caching while having a much simpler build format. If you have a new project, it's highly recommended. xcbuild works great with xcpretty. Pipe the output from xcbuild to xcpretty the same way as you would from xcodebuild.

Building

Build Status

  • Xcode 7 or later, on macOS.
  • GCC 4.8 or later, on Linux. libpng16-dev, zlib1g-dev, libxml2-dev, and pkg-config are also required.
  • Visual Studio 2015 or later, on Windows. A zlib DLL is also required.
  • CMake and Ninja (or llbuild).

To build:

  • All platforms:
git clone https://github.com/facebook/xcbuild
cd xcbuild
git submodule update --init
  • Linux and macOS:
make

Build output will be in the build directory. Run xcbuild with ./build/xcbuild.

  • Windows (experimental):
cmake -Bbuild -H. -G "Visual Studio 14 2015" -DZLIB_ROOT=<path>

Open build\xcbuild.sln and build.

Usage

The command line options are compatible with xcodebuild.

xcbuild -workspace Example.xcworkspace -scheme Example

Using Ninja (or llbuild)

To switch to the significantly faster Ninja executor:

xcbuild -executor ninja [-workspace Example.xcworkspace ...]

Besides the -executor ninja parameters, the options are otherwise identical. The Ninja executor is fastest if it can avoid re-generating the Ninja files if the build configuration and input project files do not change.

Contributing

xcbuild actively welcomes contributions from the community. If you're interested in contributing, be sure to check out the contributing guide. It includes some tips for getting started in the codebase, as well as important information about the code of conduct, license, and CLA.

Thanks

xcbuild is built on build system documentation from the community. In particular, thanks to these people for their writing:

Third-party licenses are listed in the LICENSE document.