You are here: Sparrow Wiki » The Sparrow Manual » Setting up Xcode

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
manual:setting_up_xcode [2013/12/23 19:17] – danielmanual:setting_up_xcode [2014/01/24 11:42] (current) – [Integrate the API Documentation] daniel
Line 1: Line 1:
 +===== Setting up Xcode =====
 +
 +Before creating a project of your own, you have to make some preparations in Xcode.
 +
 +<note info>
 +You need at least Xcode 4.0 to work with Sparrow 2.0.
 +</note>
 +
 +==== Create a Source Tree variable ====
 +
 +Sparrow is linked to your application via Xcode project references. This has the advantage that it’s easy to update Sparrow (just download a new release and overwrite the old one in the same directory) and that you can easily step into Sparrow source code, in case you want to do so.
 +
 +Add a "Source Tree" variable that Xcode can use to dynamically find Sparrow. This has to be done only once.
 +
 +  * In Xcode Preferences > "Locations" button > "Source Trees" tab > create a new Source Tree variable.
 +  * Use ''SPARROW_SRC'' as "Setting"- and "Display Name" and let it point to ''/path_to_sparrow/sparrow/src/''
 +  * Be careful: Xcode does not allow the path to contain any spaces!
 +
 +==== Integrate the API Documentation ====
 +
 +Xcode allows to integrate third party API reference documentation. That way, you will get information about Sparrow's classes, methods and properties directly while you write your code.
 +
 +<note info>
 +You can get information about Sparrow classes and methods with the //Alt single-click on symbol// shortcut.
 +</note>
 +
 +The steps required to get access to the docset depend on your Xcode version. The Sparrow docset can be found here:
 +
 +  http://doc.sparrow-framework.org/core/feed/docset.atom
 +
 +To install this docset,
 +
 +  * **Xcode 4:** open up the Xcode preferences and enter the Documentation tab. Add the link provided above as a "publisher".
 +  * **Xcode 5:** use the free [[http://documancer.com/xcode/|Docs for Xcode]] application to manage your docsets. When installed, add the link from above as a feed.
 +
 +-----
 +
 +Next section: [[Project Setup]]
  
  manual/setting_up_xcode.txt · Last modified: 2014/01/24 11:42 by daniel
 
Powered by DokuWiki