tuist/XcodeProj

This is stars and forks stats for /tuist/XcodeProj repository. As of 25 Apr, 2024 this repository has 1868 stars and 283 forks.

XcodeProj XcodeProj is a library written in Swift for parsing and working with Xcode projects. It's heavily inspired by CocoaPods XcodeProj and xcode. XcodeProj Projects Using XcodeProj Installation Swift Package Manager Scripting Documentation 📝 References 📚 Contributing License Contributors ✨ 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.12.0")), ], targets: [ .target( name: "myproject", dependencies: ["XcodeProj"]), ] ) 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): 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💻 Teameh💻 Johannes Ebeling💻 baegteun📖 Alex Kovács📖 Christoffer Winterkvist💻 Timothy Costa💻 Mary 💻 Md. Ibrahim Hassan💻 tatagrigory💻 This project follows the all-contributors specification. Contributions of any kind welcome!