Sparrow Wiki

Before creating a project of your own, you should make some preparations in Xcode.

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.

This has to be done only once:

• Add a “Source Tree” variable that Xcode can use to dynamically find Sparrow.
  • In Xcode preferences > “Locations” button > “Source Trees” tab > create a new Source Tree variable.
  • For Sparrow, create SPARROW_SRC and let it point to /path_to_sparrow/sparrow/src/
  • Be careful: Xcode does not allow the path to contain any spaces!

1. Set up a shared build output directory that will be shared by all Xcode projects.
   • In the Xcode preferences, tab: “Building”, set “Place Build Products in” to “Customized location” and specify a common build directory (anywhere you want).
   • Set “Place Intermediate Build Files in” to “With build products”.
2. Add a “Source Tree” variable that Xcode can use to dynamically find Sparrow.
   • In the Xcode preferences, tab: “Source Trees”, create a new Source Tree variable.
   • For Sparrow, create SPARROW_SRC and let it point to /path_to_sparrow/sparrow/src/
   • Be careful: Xcode does not allow the path to contain any spaces!

Next section: Project Setup