/cordova-osx

Mirror of Apache Cordova mac

Primary LanguageObjective-CApache License 2.0Apache-2.0

Cordova OSX

CordovaFramework is a framework that enables users to include Cordova in their OS X application projects easily, and also create new Cordova based OS X application projects.

Pre-requisites

Make sure you have installed the latest released OS X SDK which comes with Xcode 4. Download it at http://developer.apple.com/downloads or the Mac App Store.

Install CordovaFramework

  1. Download the source
  2. Extract to their final location
  3. There is no step 3

Create a Cordova project

  1. Launch Terminal.app
  2. Go to the location where you installed Cordova, in the bin sub-folder
  3. Follow the instructions in the Command-Line Usage section of http://docs.cordova.io

The docs should also have been included in the distribution.

To use a shared CordovaFramework, add as the first parameter "--shared" to the bin/create command.


Updating a CordovaFramework subproject reference in your project

When you update to a new Cordova version, you may need to update the CordovaFramework reference in an existing project. Cordova comes with a script that will help you to do this.

  1. Launch Terminal.app
  2. Go to the location where you installed Cordova, in the bin sub-folder
  3. Run "update_cordova_subproject [path/to/your/project/xcodeproj]" where the first parameter is the path to your project's .xcodeproj file

Unit Tests

  1. Create a new Cordova-based Application project
  2. Download the code from the mobile-spec and put all of it in the root of your www folder
  3. Modify cordova.js to point to your correct cordova-X.X.X.js version
  4. Run the project

FAQ

None yet.

BUGS?

File them at the Cordova Issue Tracker

MORE INFO