Agent RulesAgent Rules
CL

clang-format

clang-format for consistent Objective-C code formatting

Objective-C
Linter / Formatter
Default
Use in BuilderAll Objective-C Options

Details

Language / Topic
objective-cObjective-C
Category
Linter / Formatter

Rules

balanced
- Use `clang-format` with a `.clang-format` file at the project root — set `Language: ObjC` and `BasedOnStyle: Google` or `Mozilla` as the baseline.
- Run `clang-format -i **/*.m **/*.h` as a pre-commit hook or Xcode build phase to enforce consistent formatting automatically.
- Use `clang-tidy` with Objective-C checks to catch deprecated API usage, retain cycle patterns, and missing nullability annotations.
- Configure `.clang-format` with `ObjCBlockIndentWidth: 4` and `IndentWidth: 4` to match Apple's standard Xcode formatting.
- Use `ColumnLimit: 120` in `.clang-format` — Objective-C method signatures are inherently verbose and benefit from a wider line limit than C/C++.
- Integrate `clang-format` into Xcode via a Build Phase script: `find ${SRCROOT} -name '*.m' -o -name '*.h' | xargs clang-format -i`.
- Run `clang-format --dry-run --Werror` in CI to fail builds on unformatted code without modifying files.