Difference between revisions of "Building waze for iPhone"

From waze
Jump to: navigation, search
(First build: a little fancy formatting)
(First build: Note re. necessary but missing media files)
Line 13: Line 13:
 
==First build==
 
==First build==
  
'''NOTE: This does not yet produce a build that works, at least not in the iPhone Simulator. More input from other developers is needed here.'''
+
'''NOTE: This does not yet produce a build that works, at least not in the iPhone Simulator. More input from other developers is needed here. In particular, there are some media files necessary to link with the app that are not provided with the source code, as there is confusion over whether they're covered by the same GNU GPL v2 license.'''
  
 
# Make a working directory for the waze source code. It will need to be somewhere where you can add a symlink to its parent directory. For these examples, we'll say the directory is <tt>/Users/Me/iOS/waze</tt>, but it could be under any path you like.
 
# Make a working directory for the waze source code. It will need to be somewhere where you can add a symlink to its parent directory. For these examples, we'll say the directory is <tt>/Users/Me/iOS/waze</tt>, but it could be under any path you like.

Revision as of 20:38, 5 September 2010

INCOMPLETE

Required items

Optional items

  • Apple iOS Developer Program (paid membership; necessary to build for an actual iOS device instead of just the simulator)

First build

NOTE: This does not yet produce a build that works, at least not in the iPhone Simulator. More input from other developers is needed here. In particular, there are some media files necessary to link with the app that are not provided with the source code, as there is confusion over whether they're covered by the same GNU GPL v2 license.

  1. Make a working directory for the waze source code. It will need to be somewhere where you can add a symlink to its parent directory. For these examples, we'll say the directory is /Users/Me/iOS/waze, but it could be under any path you like.
  2. Unzip the source code into /Users/Me/iOS/waze. You'll end up with the source code under something like /Users/Me/iOS/waze/waze_src_2.0. Just rename it so it becomes /Users/Me/iOS/waze/src.
  3. Change to the parent directory (/Users/Me/iOS) and make a symlink: ln -s waze/src/iphone
  4. Change to the waze/src/iphone directory and make another symlink: ln -s .. src
  5. Fire up Xcode.
  6. Within Xcode, open: waze/src/iPhone/Xcode/waze.xcodeproj
  7. Now you can try your first build. If you go to the Build menu and choose one of the "Build and Debug" or "Build and Run" options, Xcode will automatically install the built app into the iPhone Simulator and run it there.