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:project_setup [2013/05/27 09:12] – [The Scaffold Project] danielmanual:project_setup [2014/07/03 10:36] (current) – [Creating your own Project] daniel
Line 1: Line 1:
 +===== Project Setup =====
  
 +To make it easy to create your own Xcode projects with Sparrow, the download package contains two projects that can serve as the starting point for your own games:
 +
 +==== The Barebone Project ====
 +
 +The Barebone project is the most lightweight way to set up Sparrow. It does only what is absolutely necessary: create an ''SPViewController'' with Sparrow content. The rest is up to you.
 +
 +//Use this project for your first tests with the Sparrow Framework. It's super lightweight and does not contain any content that might confuse beginners.//
 +
 +
 +==== The Scaffold Project ====
 +
 +The Scaffold project contains some more code that will help you get started, e.g. a Media class for easy access to your assets, method stubs for auto-rotation, etc. We will look at the project in more detail in a [[The Scaffold Project|separate chapter]]. 
 +
 +//Use that project as the basis for your actual game, as it saves you a lot of effort!//
 +
 +==== Creating your own Project ====
 +
 +Whenever you start a new Sparrow project, choose an appropriate project from those two and follow these steps to use it as a basis for your game:
 +
 +  - Copy the complete folder to the place where you want to have your game project.
 +  - Open the Xcode project.
 +  - Build and run --- just to see if everything works fine. 
 +    * If it does not work, check if you have created the ''SPARROW_SRC'' variable in Xcode, if it points to the right place and has no spaces in its path.
 +  - Rename the project:
 +    * Click directly on the project name in the Project Navigator to make it editable. Change the name and accept the requests of the popups that follow.
 +    * Click on "Product - Manage Schemes" and then on the Scheme name ("Scaffold" or "Barebone") to rename that, too.
 +  - Select the target hardware: iPhone / iPod Touch / iPad
 +    * Enter the project settings, tab: "Build"
 +    * Select the target of your choice for the setting "Targeted Device Family"
 +
 +That's it!
 +
 +<note>
 +All the sample code in this manual uses "ARC" by default (Automatic Reference Counting). In older Objective-C versions, you had to do a lot of manual memory management; with ARC, this is no longer necessary. 
 +
 +If you want to use Sparrow without ARC, you can do that, too. Just disable "Automatic Reference Counting" in the build settings of your project.
 +</note>
 +
 +-----
 +
 +//Next Section: [[The Barebone Project]]//
 
 
Powered by DokuWiki