Xcodebuild is a command line tool provided by Apple for macOS that allows developers to build various types of applications specified within an Xcode project. When building a static library with Bitcode enabled, one must pay attention to several configuration settings. Bitcode is an intermediate representation of a compiled application that can be optimized by Apple’s App Store to produce more efficient machine code. This article walks you through the steps and explains the technical requirements step-by-step to create such a library.

Prerequisites

Before you begin, ensure you have the following:

• MacOS Machine: You need a Mac running macOS since Xcode is only available for macOS.
• Xcode Installed: Ensure you have Xcode installed, and it’s updated to a recent version that supports Bitcode.
• Command Line Tools: If not already installed, install Xcode command-line tools to use xcodebuild .

Configuration of The Xcode Project

To build a static library with Bitcode enabled, you need to configure your Xcode project correctly. Here are the key project settings required:

1. Enable Bitcode: Ensure Bitcode is enabled for your build target:
   • Go to your project's Build Settings.
   • Set ENABLE_BITCODE to YES .
2. Set the Build Configuration: Decide on the specific build configuration you want to target (e.g., Debug , Release ). In general practice, Bitcode is often used for Release builds.
3. Architectures: Specify the architectures for which you are building. For a universal library:
   • Set ARCHS to arm64 armv7 x86_64 (depending on the desired target devices).

Building with xcodebuild

Once your project is properly configured, you can then use xcodebuild to initiate the build process.

Command Structure

The xcodebuild command allows you to build your static library. Here's a typical command you might use:

• -project: Specifies the .xcodeproj file.
• -scheme: Specifies the scheme to build. This should match one of your project's defined schemes.
• -configuration: Specifies the build configuration (e.g., Release ).
• -sdk: Specifies the SDK, such as iphoneos or iphonesimulator .
• -arch: Specifies architecture (e.g., arm64 , x86_64 ).