User:Brooke Vibber/iOS build notes

Building for iOS

Requirements

• Computer running Mac OS X 10.7
• Xcode tools 4.2 (w/ iOS 5.0 SDK)
• PhoneGap 1.1.0
  • install the iOS package which provides necessary headers, libraries, and templates to build the project in Xcode

Checking out the code

 git clone https://github.com/nitobi/Wikipedia.git

Double-click Wikipedia-iOS.xcodeproj in finder to open the project in XCode.

Directory structure

Wikipedia
 \
  +- assets/www/ - the HTML+JS app's code and resources
  +- Wikipedia-iOS/ - iOS support and build files
  +- Wikipedia-iOS.xcodeproj - Xcode project
  +- (anything else) Android stuff you can ignore

The actual HTML/JS runtime files live in assets/www and are where you'll likely spend most of your time. There should be more general pages explaining what goes on in there...

This should appear in the Xcode project as just "www". There may be an autogenerated extra "www" directory outside of assets -- you may safely ignore it!

Note that the actual PhoneGap frameworks live outside the project -- you need to install the PhoneGap frameworks first where Xcode can find them!

Building for simulator

Select 'iPad Simulator' or 'iPhone Simulator' in preferred version and hit the big "Run" button. It should work!

Building for device

Code signing and whatnot is beyond the scope of this document for now.

Building for deployment

Code signing and whatnot is beyond the scope of this document for now.

Known bugs

Major current issues:

• articles load in Safari instead of in the iframe
• no menu