XcodeProj is a library written in Swift for parsing and working with Xcode projects. It's heavily inspired by CocoaPods XcodeProj and xcode.
| 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.
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.9.0")),
],
targets: [
.target(
name: "myproject",
dependencies: ["XcodeProj"]),
]
)Only macOS
# Cartfile
github "tuist/xcodeproj" ~> 8.8.0pod 'xcodeproj', '~> 8.8.0Using 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 SwiftXcodeProj // @stackotter ~> 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.3Future adaption could easily include determining the version and bumping it
automatically. If so, we recommend using a library that provides a Version
object.
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.
- 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
- Git clone the repository
git@github.com:tuist/xcodeproj.git. - Open
Package.swiftwith Xcode.
XcodeProj is released under the MIT license. See LICENSE for details.
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!