Repository files navigation

This repository contains theApple CC toolchain,Apple relatedplatforms andconstraints definitions, and small helper functionsfor rules authors targeting Apple platforms.

If you want to build iOS, tvOS, visionOS, watchOS, or macOS apps, userules_apple.

If you want to build Swift userules_swift.

Seethe documentation for the helper rules provided by thisrepository.

Copy theMODULE.bazel orWORKSPACE snippets fromthe releasespage into yourproject.

The Apple CC toolchain in this repository provides toolchains forbuilding for Apple platforms besides macOS. Since Bazel 7 this toolchainis required when targeting those platforms.

The toolchain supports using a full Xcode installation or the XcodeCommand Line Tools.

For Bazel 7+ the only setup that is required is to haveapple_supportin yourMODULE.bazel (even if you're not referencing it directly) orWORKSPACE, which you can copy fromthe releasespage into yourproject.

If you also depend onrules_cc,apple_support must comeaboverules_cc in yourMODULE.bazel orWORKSPACE file because Bazelselects toolchains based on which is registered first.

There are many different flags you can flip to configure how thetoolchain works. Here are some of the more commonly useful ones:

• SettingDEVELOPER_DIR in the environment. This is recommended sothat the toolchain can be invalidated when theDEVELOPER_DIRchanges, which ensures that toolchain binaries will be rebuilt withthe new version of Xcode so that caches are correctly shared acrossmachines.
• SettingBAZEL_ALLOW_NON_APPLICATIONS_XCODE=1 in the environment (orusing--repo_env) allows the toolchain to discover Xcode versionsoutside of the/Applications directory to avoid header inclusionerrors from bazel. This is not enabled by default because/Applications is the standard directory, and this improves toolchainsetup performance.