CODEWITHSUNDEEP
iosxcodemacosgit
qichunren
qichunren

Reputation: 4475

Should I git ignore xcodeproject/project.pbxproj file?

in a XCode project, I offen got xcodeproject/project.pbxproj file changed, but useless info for me, it for compile.

Should I git ignore this file and xcodeproject/projectxworkspace/username.xcuserdata/UserInterfaceState.xcuserstate file?

Upvotes: 130

Views: 57336

Answers (7)

Diya Li
Diya Li

Reputation: 1088

project.pbxproj is an important file in the Xcode configuration bundle. It is responsible for maintaining references to all of the linked files and their groupings, linked frameworks, and most importantly, the project’s build settings. Because of this, we cannot exclude project.pbxproj from version control.

Here is my general .gitignore for my Xcode Project.

# OS X Finder
.DS_Store

# Xcode per-user config
*.mode1
*.mode1v3
*.mode2v3
*.perspective
*.perspectivev3
*.pbxuser
*.xcworkspace
xcuserdata

# Build products
build/
*.o
*.LinkFileList
*.hmap

# Automatic backup files
*~.nib/
*.swp
*~
*.dat
*.dep

Upvotes: 8

Cyril Cermak
Cyril Cermak

Reputation: 329

You can use Xcodegen to generate a pbxproj out of a YAML project specification file then you can ignore pbxproj in git and generate them every time you need.

I have already used Xcodegen on a second project which has a modular architecture (many pbxprojs) and more then 8 developers is working on it.

https://github.com/yonaskolb/XcodeGen

Hope it helps.

Upvotes: 2

Eimantas
Eimantas

Reputation: 49354

Update in the light of Swift Package Manager: If you're building a project as a Swift package - you should definitely ignore this file as it can be generated using file system as source of truth. You can do that by using the following command:

$ cd ~/Projects/MyProjectFolder/
$ swift package generate-xcodeproj

For non-SwiftPM answer - see below.

This file holds the list of all the files in the project, settings of targets and which files belong to which targets. It's probably the meatiest file in project bundle. You should not ignore this file. There are few points for this:

  1. You may not want to work on this project alone or;
  2. You're planning on working on project from different machines;
  3. You'll want to share your code base with others;

Upvotes: 149

Joseph Bolade Caxton-Idowu
Joseph Bolade Caxton-Idowu

Reputation: 228

If you exclude project.pbxproj Jenkins builds will fail. So this is important if you use Jenkins.

Upvotes: 5

Julius Smith
Julius Smith

Reputation: 51

Unfortunately, if your Build Settings includes code signing, you have to re-enter your code-signing entity after every "git pull" if another team member has changed it. It seems to me this info should be in the user settings, not the global pbxproj file.

Upvotes: 5

Paul Cezanne
Paul Cezanne

Reputation: 8741

I found that I also need to preserve the xcworkspace file(s). If didn't, project with a sub-project broke.

Upvotes: 0

Grady Player
Grady Player

Reputation: 14549

That is the only file that you want in your repos from the xcodeproj bundle. That file holds all of the info for targets files and build settings.

Upvotes: 8

Related Questions