kuguobing / cordova-ios

Mirror of Apache Cordova iOS

Cordova iOS

Cordova iOS is an iOS application library that allows for Cordova-based projects to be built for the iOS Platform. Cordova based applications are, at the core, applications written with web technology: HTML, CSS and JavaScript.

Apache Cordova is a project of The Apache Software Foundation (ASF).

Requires:

• Xcode 5.x or greater. Download it at http://developer.apple.com/downloads or the Mac App Store.

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

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

Updating a CordovaLib subproject reference in your project

When you update to a new Cordova version, you may need to update the CordovaLib 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

By default when you create a new project, the CordovaLib sub-project is copied into your project folder, it is not shared.

Unit Tests

1. Create a new Cordova project
2. Download the code from the mobile-spec and put all of it in the root of your www folder
3. Install all the core plugins
4. Run the project

Futher reading

• http://cordova.apache.org/
• http://wiki.apache.org/cordova/