xcproj alternatives and similar libraries
Based on the "Project setup" category.
Alternatively, view xcproj alternatives based on common mentions on social networks and blogs.
CodeRabbit: AI Code Reviews for Developers

* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of xcproj or a related project?
Popular Comparisons
README
XcodeProj
<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
<!-- ALL-CONTRIBUTORS-BADGE:END -->
XcodeProj is a library written in Swift for parsing and working with Xcode projects. It's heavily inspired by CocoaPods XcodeProj and xcode.
Projects Using XcodeProj
Project | Repository |
---|---|
ProjLint | github.com/JamitLabs/ProjLint |
rules_xcodeproj | github.com/buildbuddy-io/rules_xcodeproj |
Rugby | github.com/swiftyfinch/Rugby |
Sourcery | github.com/krzysztofzablocki/Sourcery |
Tuist | github.com/tuist/tuist |
XcodeGen | github.com/yonaskolb/XcodeGen |
xspm | gitlab.com/Pyroh/xspm |
If you are also leveraging XcodeProj in your project, feel free to open a PR to include it in the list above.
Installation
Swift Package Manager
Add the dependency in your Package.swift
file:
let package = Package(
name: "myproject",
dependencies: [
.package(url: "https://github.com/tuist/XcodeProj.git", .upToNextMajor(from: "8.8.0")),
],
targets: [
.target(
name: "myproject",
dependencies: ["XcodeProj"]),
]
)
Carthage
Only macOS
# Cartfile
github "tuist/xcodeproj" ~> 8.8.0
CocoaPods
pod 'xcodeproj', '~> 8.8.0
Scripting
Using swift-sh
you can automate project-tasks using scripts, for example we
can make a script that keeps a project’s version key in sync with the current
git tag that represents the project’s version:
#!/usr/bin/swift sh
import Foundation
import XcodeProj // @tuist ~> 8.8.0
import PathKit
guard CommandLine.arguments.count == 3 else {
let arg0 = Path(CommandLine.arguments[0]).lastComponent
fputs("usage: \(arg0) <project> <new-version>\n", stderr)
exit(1)
}
let projectPath = Path(CommandLine.arguments[1])
let newVersion = CommandLine.arguments[2]
let xcodeproj = try XcodeProj(path: projectPath)
let key = "CURRENT_PROJECT_VERSION"
for conf in xcodeproj.pbxproj.buildConfigurations where conf.buildSettings[key] != nil {
conf.buildSettings[key] = newVersion
}
try xcodeproj.write(path: projectPath)
You could then store this in your repository, for example at
scripts/set-project-version
and then run it:
$ scripts/set-project-version ./App.xcodeproj 1.2.3
$ git add App.xcodeproj
$ git commit -m "Bump version"
$ git tag 1.2.3
Future adaption could easily include determining the version and bumping it
automatically. If so, we recommend using a library that provides a Version
object.
Documentation 📝
Want to start using XcodeProj? Start by digging into our documentation which will help you get familiar with the API and get to know more about the Xcode projects structure.
References 📚
- Xcode Project File Format
- A brief look at the Xcode project format
- pbexplorer
- pbxproj identifiers
- mob-pbxproj
- Xcodeproj
- Nanaimo
- Facebook Buck
- Swift Package Manager - Xcodeproj
Contributing
- Git clone the repository
[email protected]:tuist/xcodeproj.git
. - Open
Package.swift
with Xcode.
License
XcodeProj is released under the MIT license. See LICENSE for details.
Contributors ✨
Thanks goes to these wonderful people (emoji key):
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> Joseph Colicchio🤔 deatondg🤔 Dan Fleming💻 Sascha Schwabbauer🤔 Marcin Iwanicki🚧 Adam Khazi🚧 Elliott Williams💻 Muukii🖋 Yuya Oka💻 Keith Smiley🖋 Ian Leitch💻 Daniil Subbotin💻 Florentin Bekier💻 Vadim Smal🐛 freddi(Yuki Aki)💻 Kristopher Jackson💻 Jake Prickett💻 Jake Adams💻 matsuji💻 Bogdan Belogurov💻 Chuck Grindel💻 Michael McGuire💻 C-凡💻 Maxwell Elliott💻 Brentley Jones💻
<!-- markdownlint-restore --> <!-- prettier-ignore-end -->
<!-- ALL-CONTRIBUTORS-LIST:END -->
This project follows the all-contributors specification. Contributions of any kind welcome!
*Note that all licence references and agreements mentioned in the xcproj README section above
are relevant to that project's source code only.