Improve documentation for initial setup, maybe a setup script, and probably xcodegen tweaks

[aaronbrethorst]

Key takeaways:

• Try running through the setup process without ever opening Xcode on the system and seeing what breaks (probably easiest with a VM)
• Update documentation accordingly
• Consider writing a small setup script that will check for dependencies and offer a clearer list of what's needed to the user
• Improve documentation about development teams and bundle identifiers
• Look into creating some sort of 'local settings' file that can be used to customize the bundle identifiers for development without being part of the OBA org. The settings file should be .gitignored.

---

I received a report about the documentation for initial setup needing some clarification. Here are the notes:

xcodebuild missing

I ran into my first issue. I got xcrun: error: unable to find utility "xcodebuild", not a developer tool or in PATH when I tried to run
scripts/carthage_build

I think it was because I didn't open Xcode yet on my system. I opened it and it now says "Installing components" which sounds good.

I was able to fix it by running sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

running on device

Hm, I can't get it to deploy to my device
Failed to register bundle identifier: The app identifier "org.onebusaway.iphone.TodayView" cannot be registered to your development team because it is not available. Change your bundle identifier to a unique string to try again.
I set all the projects to my personal team, following Apple's instructions.

Alan replied:

after setting projects to your personal team, change the app identifiers to something different than the default. you can add your name or something unique, “uniquename.onebusaway.iphone” and “uniquename.onebusaway.iphone.TodayView” for example.

The user replied:

Got it, and I also had to update the references to that in the plist files
Well, one plist, on the NSUserActivityTypes iirc

Alan said:

it may be helpful to keep a Git Patch handy to automatically update these values because everytime you generate_project, it will overwrite what you just did with the default

And finally I said:

I think we could set something up with xcodegen and a local settings file to make this easier too.