How to manage shared resources in iOS team development?

Question

I'm starting a new small study project and I will work together with a friend. We will work on the same project, but on different parts. Sometimes we will need to modify files that are common.

My question is: how do you guys manage this kind of project? My biggest concern is about storyboard file and some other shared resources.

Any advice would be great!

score 2 · Accepted Answer · answered Apr 09 '14 at 03:23

There are a bunch of things you can do here and not all of them are absolute, so here are a few of my opinions.

Use Git. Most simply would be to use a service like github or bitbucket.
Each person should create new branches for grouping all the commits for a particular change/feature and then merge the feature branches into your release branch.
Have a good gitignore, here is github's objective-c gitignore as an example.
If your team will be growing or there is a good chance you will be working on the same pieces at the same time, don't use storyboards or xibs in general. These are a really bummer when you have merge conflicts and generally don't behave well with multiple people working on them. I recommend laying out all of your UIs in code either with autolayout or without. This in my experience also makes UIs way easier to debug, refactor, and update.

Storyboards are after all XML files. Unless you are working on the same View controller chances of it getting conflicted are less. — GoodSp33d, Apr 09 '14 at 07:18
Which is what I said in my comment. They also don't behave like normal XML files. Often times, moving a single thing will make 5-10 different versioning and autolayout changes in a bunch of different places, making it really hard to see what has actually changed. — Dima, Apr 09 '14 at 16:58

score 1 · Answer 2 · edited May 23 '17 at 12:11

@Dima mentioned that NIB files are hard to merge, this also applies to project files. Some ways to deal with this:

Lay out the whole file and class structure ahead of time
Have a single member of the team who is responsible for maintaining project structure, and if anyone wants to add/move/rename a file they get the "project master" to do it
Divide the app up into a series of different static library projects, and assign one person to each

Using static libraries is one of those things that is much much harder than it should be, but once you figure out the right combination of obscure changes to XCode's build settings everything works well.

In a nutshell, you need to

In the static library set "skip install" to YES, and make all header files public
In any projects using the library link it in in "build phases" and add a header search path so it knows where to look for the header files.

See the following links for the step by step:

The best HOWTO for iOS static libraries: http://www.blog.montgomerie.net/easy-xcode-static-library-subprojects-and-submodules
Then, the first error you'll encounter is probably "header files not found". Solution here.
If you have a project that needs to use resources like images or NIB files you need to add a .bundle target. Instructions here.

You could also use a dependency management system like CocoaPods to automate some of this static library configuration and build. See here.

Finally, this answer also has an interesting approach to avoiding xcproject conflicts: instruct git to "always union" the merge. Haven't tried this myself.

How to manage shared resources in iOS team development?

2 Answers2