Xcode Project and File templates
Project and file templates I use for my daily work. Described in my blog at
Hope you'll find the templates useful. You are free to use/modify the templates for your own needs!
Installation and Usage
To install, copy Application folder to ~/Library/Application Support/Developer/Shared/Xcode.
Note that this will overwrite your existing
File Templates and
folders; if you use other templates in there, copy each folder contents individually!
After copying, the templates are ready to use (no Xcode restart is required!).
Usage of Project Templates
To use project templates, start a new project, then in Xcode New Project window, select Application option in the User Templates section on the left side of the window. This will present you with a Cocoa Application option on the right. At the bottom part of the window you can choose which template to use - just tick appropriate options and you're ready to go.
Both Core Data projects include Sparkle framework, however you do need to enter few details manually to make it usable:
First you need to supply the URL of your appcast file. Open your project's info.plist file in Xcode and enter the URL as the value of SUFeedURL key. You can find the file in Other Sources group.
Copy the contents of your public key file (it's called
dsa_pub.pemby default) into the
dsa_pub.pemfile inside Resources group (delete existing contents!).
Sparkle auto-update check is set to daily by default. If you'd like to use other default
update timing, change the value of the
SUScheduledCheckInterval key as well. Note that
both templates include the main menu item for manually checking for updates, but anything
more is up to you (options on preferences window for example) - consult Sparkle documentation
on github wiki pages for details on how to do that.
This should be basically everything you need to get a working skeleton.
Usage of File Templates
To use file templates, create a new file, then select Cocoa Class from User Templates section of Xcode New File window. On the right you'll see the option of selecting either Objective-C class or Objective-C test case class. In the bottom part of the window you can then select various options or subclasses to use. Note that most are suited for use with above custom project templates, but you may find them useful othewise too.
If you'll use CocoaLumberjack logging framework, you might experience problems with your
custom classes logging levels not being detected by DDLog class (especially if using
DDLog(GBLogExtensions) category. The problem is due to custom subclasses
are not detected as being registered by
The reason is in testing for conformance to
NSObject protocol which rejects most
classes, even though they are derived from
NSObject class... I admit, I didn't go
into details about this, so I've adopted a quick (and dirty) solution at the moment -
for each of my classes, I make them conform to an empty
and this solves the problem. Note that this MUST be done for each subclass as well!
Project templates include the following open-source software from fellow Mac developers, either full or partial (in no particular order):
- CocoaLumberjack logging framework by Robbie Hanson link.
- DDFoundation by Dave Dribin link
- XSViewController by Jonathan Dann and Cathy Shive link
- SynthesizeSingleton by Matt Gallagher link
For unit testing I use the following (in addition to above mentioned):
- GHUnit unit testing framework by Gabriel Handford link
- OCMock mock objects by 'Mulle Kibernetik' link
- OCHamcrest framework link
A big thanks for all contributors!
Copyright (c) 2009 Tomaz Kragelj
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Tomaz Kragelj email@example.com