Building waze for iPhone - Revision history

Larrygilbert: /* Optional items */

2010-09-06T19:14:25Z

‎Optional items

Larrygilbert: /* Optional items */ reword item about Apple iOS Developer program and indicate the subscription fee

2010-09-06T19:11:57Z

‎Optional items: reword item about Apple iOS Developer program and indicate the subscription fee

Larrygilbert: /* Required items */ link to the Liberation font home page

2010-09-06T19:07:39Z

‎Required items: link to the Liberation font home page

Larrygilbert: /* Required items */ Some hints of things I've been using to try to build

2010-09-06T19:06:12Z

‎Required items: Some hints of things I've been using to try to build

Larrygilbert: Expand on the caution to developers

2010-09-06T19:04:02Z

Expand on the caution to developers

Larrygilbert: Note re. data missing from source code

2010-09-06T03:08:22Z

Note re. data missing from source code

Larrygilbert: /* First build */ Note re. necessary but missing media files

2010-09-05T20:38:34Z

‎First build: Note re. necessary but missing media files

Larrygilbert: /* First build */ a little fancy formatting

2010-09-04T20:05:58Z

‎First build: a little fancy formatting

Larrygilbert: First run at some build instructions

2010-09-04T19:58:08Z

First run at some build instructions

Larrygilbert at 06:25, 3 September 2010

2010-09-03T06:25:43Z

@@ Line 12: / Line 12: @@
 ==Optional items==
-* Paid membership in the Apple iOS Developer Program (necessary to build for an actual iOS device instead of just the simulator; currently US$99/year)
+* Paid membership in the Apple iOS Developer Program (necessary to build for an actual iOS device instead of just the simulator; currently US$99/year and up)
 ==First build==

@@ Line 12: / Line 12: @@
 ==Optional items==
-* Apple iOS Developer Program (paid membership; necessary to build for an actual iOS device instead of just the simulator)
+* Paid membership in the Apple iOS Developer Program (necessary to build for an actual iOS device instead of just the simulator; currently US$99/year)
 ==First build==

@@ Line 7: / Line 7: @@
 * [http://developer.apple.com/iphone/ Apple iOS SDK] (no charge to register and download)
 * [[Source code|waze source code]] (naturally!)—be sure to get a copy of version 1.9.0 as it includes some images not in the 2.0 sources
-* A couple of TrueType fonts (maybe Liberation Sans and Sans Bold from the Fedora Project?)
+* A couple of TrueType fonts (maybe [https://fedorahosted.org/liberation-fonts/ Liberation] Sans and Sans Bold from the Fedora Project?)
 * (other data not in the waze source code zip file; see important note above)

@@ Line 6: / Line 6: @@
 * [http://developer.apple.com/iphone/ Apple iOS SDK] (no charge to register and download)
-* [[Source code|waze source code]] (naturally!)
+* [[Source code|waze source code]] (naturally!)—be sure to get a copy of version 1.9.0 as it includes some images not in the 2.0 sources
 * (other data not in the waze source code zip file; see important note above)

← Older revision		Revision as of 19:04, 6 September 2010
Line 1:		Line 1:
−	'''IMPORTANT NOTE for community developers: There is required data missing from waze's source code release, including but not limited to images, sounds, and web service URLs. It's unclear whether this conforms or does not conform to the GNU GPL under which waze is published, but it does make it impossible to build a working app from the published source code. As data becomes available to make a working build from the source code, it will be noted here.'''	+	'''IMPORTANT NOTE for community developers: There is required data missing from waze's source code release, including but not limited to images, sounds, and web service URLs. It's unclear whether this conforms or does not conform to the GNU GPL under which waze is published, but it does make it impossible to build a working app from the published source code.'''
		+
		+	'''As data becomes available to make a working build from the source code, it will be noted here. In the meantime, more experimentation is needed. The instructions given here are not enough to build a working app.'''

	==Required items==		==Required items==

@@ Line 1: / Line 1: @@
-'''INCOMPLETE'''
+'''IMPORTANT NOTE for community developers: There is required data missing from waze's source code release, including but not limited to images, sounds, and web service URLs. It's unclear whether this conforms or does not conform to the GNU GPL under which waze is published, but it does make it impossible to build a working app from the published source code. As data becomes available to make a working build from the source code, it will be noted here.'''
 ==Required items==
@@ Line 5: / Line 5: @@
 * [http://developer.apple.com/iphone/ Apple iOS SDK] (no charge to register and download)
 * [[Source code|waze source code]] (naturally!)
-* (any other data not in the waze source code zip file?)
+* (other data not in the waze source code zip file; see important note above)
 ==Optional items==
@@ Line 12: / Line 12: @@
 ==First build==
 # 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.

@@ Line 13: / Line 13: @@
 ==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.

@@ Line 15: / Line 15: @@
 '''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.'''
-# 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.
+# 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.
-# 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.
+# Unzip the source code into <tt>/Users/Me/iOS/waze</tt>. You'll end up with the source code under something like <tt>/Users/Me/iOS/waze/waze_src_2.0</tt>. Just rename it so it becomes <tt>/Users/Me/iOS/waze/src</tt>.
-# Change to the parent directory (/Users/Me/iOS) and make a symlink: ln -s waze/src/iphone
+# Change to the parent directory (/Users/Me/iOS) and make a symlink: <tt>ln -s waze/src/iphone</tt>
-# Change to the waze/src/iphone directory and make another symlink: ln -s .. src
+# Change to the waze/src/iphone directory and make another symlink: <tt>ln -s .. src</tt>
 # Fire up Xcode.
-# Within Xcode, open: waze/src/iPhone/Xcode/waze.xcodeproj
+# Within Xcode, open: <tt>waze/src/iPhone/Xcode/waze.xcodeproj</tt>
 # 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.

← Older revision		Revision as of 19:58, 4 September 2010
Line 10:		Line 10:

	* Apple iOS Developer Program (paid membership; necessary to build for an actual iOS device instead of just the simulator)		* 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.'''
		+
		+	# 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.
		+	# 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.
		+	# Change to the parent directory (/Users/Me/iOS) and make a symlink: ln -s waze/src/iphone
		+	# Change to the waze/src/iphone directory and make another symlink: ln -s .. src
		+	# Fire up Xcode.
		+	# Within Xcode, open: waze/src/iPhone/Xcode/waze.xcodeproj
		+	# 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.

← Older revision		Revision as of 06:25, 3 September 2010
Line 9:		Line 9:
	==Optional items==		==Optional items==

−	* Apple iOS Developer Program (paid membership, necessary to ~~install a~~ build on an actual iOS device)	+	* Apple iOS Developer Program (paid membership; necessary to build for an actual iOS device instead of just the simulator)