Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 2,263 Commits
.github		.github
.mise/tasks		.mise/tasks
Assets		Assets
Documentation		Documentation
Fixtures		Fixtures
Scripts		Scripts
Sources/XcodeProj		Sources/XcodeProj
Templates		Templates
Tests/XcodeProjTests		Tests/XcodeProjTests
.all-contributorsrc		.all-contributorsrc
.editorconfig		.editorconfig
.gitattributes		.gitattributes
.gitignore		.gitignore
.mise.toml		.mise.toml
.spi.yml		.spi.yml
.swift-version		.swift-version
.swiftformat		.swiftformat
.swiftlint.yml		.swiftlint.yml
CHANGELOG.md		CHANGELOG.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
LICENSE.md		LICENSE.md
Package.resolved		Package.resolved
Package.swift		Package.swift
README.md		README.md
Tuist.swift		Tuist.swift
cliff.toml		cliff.toml
renovate.json		renovate.json

Repository files navigation

XcodeProj

XcodeProj is a library written in Swift for parsing and working with Xcode projects. It's heavily inspired byCocoaPods XcodeProj andxcode.

XcodeProj

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
Privacy Manifest	github.com/stelabouras/privacy-manifest

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 yourPackage.swift file:

letpackage=Package(    name:"myproject",    dependencies:[.package(url:"https://github.com/tuist/XcodeProj.git",.upToNextMajor(from:"8.12.0")),],    targets:[.target(            name:"myproject",            dependencies:["XcodeProj"]),])

Scripting

Usingswift-sh you can automate project-tasks using scripts, for example wecan make a script that keeps a project’s version key in sync with the currentgit tag that represents the project’s version:

#!/usr/bin/swift shimport Foundationimport XcodeProj  // @tuist ~> 8.8.0import PathKitguardCommandLine.arguments.count==3else{letarg0=Path(CommandLine.arguments[0]).lastComponentfputs("usage:\(arg0) <project> <new-version>\n", stderr)exit(1)}letprojectPath=Path(CommandLine.arguments[1])letnewVersion=CommandLine.arguments[2]letxcodeproj=tryXcodeProj(path: projectPath)letkey="CURRENT_PROJECT_VERSION"forconfin xcodeproj.pbxproj.buildConfigurationswhere conf.buildSettings[key]!=nil{    conf.buildSettings[key]= newVersion}try xcodeproj.write(path: projectPath)

You could then store this in your repository, for example atscripts/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 itautomatically. If so, we recommend using a library that provides aVersionobject.

References 📚

Contributing

Git clone the repositorygit@github.com:tuist/xcodeproj.git.
OpenPackage.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 💻	_{Ruslan Alikhamov} 💻
_{Ladislas de Toldi} 💻	_{Matt Massicotte} 💻	_{Артем Ворхлик} 💻	_Jaewon-Yun 💻	_{Mike Gerasymenko} 💻	_{Filip Racki} 💻	_{Kelvin Harron} 💻
_{George Navarro} 💻	_Maxim 💻	_{Bryan Summersett} 💻	_Mikhail 💻