#ember-cordova (beta)
ember-cordova simplifies building Cordova applications with Ember.js.
It includes a CLI for builds, hooks, device event bindings, and handles splash screens, icons and a growing number of supported Ember/Cordova plugin bindings.
- Platforms & Requirements
- Getting Started
- Features and Documentation;
- Upcoming Extensions;
- Contributing;
- Credits
It is a beta fork of ember-cli-cordova, but should have similar stability. It includes new features discussed below.
##Platforms & Requirements
We require Ember 2.3 or greater. Supported Cordova platforms are iOS and Android.
For support with older Ember versions, look at ember-cli-cordova
##Getting Started
If you are migrating from ember-cli-cordova, as a pre step move your /cordova directory to /ember-cordova/cordova.
ember install ember-cordova
You can optionally pass name & cordovaId params, which will set the id & display name of your Cordova application. If none exist, your Ember Apps name will be used.
If you already have a Cordova project here it will not be overwritten.
Make sure your config.locationType is set to 'hash'.
As a final step, add your desired platforms, e.g.:
ember cdv platform add ios
ember cdv platform add android
Cordova working relies on the cordova.js script being injected. By default, this happens using ember cdv commands. Your vanilla ember build && ember s commands will not inject cordova.js by design.
##Features and Documentation
##Upcoming Extensions
We are working on four major items right now:
- Improving test coverage;
- Livereload improvements;
- Bindings to Cordova Plugins see plugins; and
- Either having ember install ember-cordova-plugin-foo install both the ember addon & cordova plugin, or achieving the same through ember cdv:install foo.
##Contributing
PRs are very welcome. You can read our style guides here.
If you are unsure about your contribution idea, please feel free to open an Issue for feedback.
##Credits
ember-cordova is maintained by Isle of Code, and started as a fork of ember-cli-cordova.