Mobile/PhoneGap/iOS build instructions

From MediaWiki.org
Jump to navigation Jump to search

Wikipedia's new official mobile application is designed to run cross-platform using the PhoneGap framework. Initial steps to make it work on iOS (iPhone, iPad, iPod Touch) are underway.

Mobile app running in iOS simulator.png Mobile app in iPad simulator.png


Requirements[edit]

  • Mac OS X 10.7 Lion
  • XCode 4.3
  • PhoneGap 1.4.1 for iPhone (We are incompatible with v1.5 for now)
    • after installing XCode, install the PhoneGap iPhone frameworks

Get source[edit]

$ git clone git://github.com/wikimedia/WikipediaMobile.git

You'll need to pull some submodules also:

$ git submodule init
$ git submodule update

Running[edit]

Mobile app project loaded in XCode.png

  1. Open 'Wikipedia-iOS.xcodeproj' in XCode
  2. Select an appropriate simulator
    • or ... a real device. Getting that set up is an exercise for the reader.
  3. Hit 'Run'

Distributing[edit]

See Wikimedia_Apps/Pre_launch_checklist

Notes[edit]

You can't distribute applications you've compiled yourself very easily due to Apple's distribution system, which is designed to give Apple a stranglehold (and slice of gross sales) for all software on the iOS platform.

Unsupported features at this time:

  • "Share page"

The iOS version currently uses a toolbar similar to the web app version; this is different from Android where there's a popup menu for the special Android menu key.