Warning

Consider this document outdated. For up to date content please refer to http://mozilla-cordova.github.io

API shim development

Running an early dev version

$ git clone https://github.com/mozilla-cordova/cordova-cli.git
$ cd cordova-cli && npm install
$ cd ..
$ git clone https://github.com/apache/cordova-plugman.git
$ cd cordova-plugman && git checkout ffos
$ cd ..
$ cd cordova-cli && npm install ../cordova-plugman
$ cd ..
$ git clone https://github.com/mozilla-cordova/cordova-firefoxos.git

Create a dir (possibly a bug it should be autocreated or used from another dir)

$ mkdir -p ~/.cordova/lib/firefoxos/cordova-firefoxos-dev/

Later on run cordova from cordova-cli/bin/cordova

Running the latest stable cordova

$ npm install cordova -g

Create your app:

$ cordova create fxos-app
$ cd fxos-app

(optional) To use a local copy of cordova-firefoxos platform code, create a file named .cordova/config.json under the root folder of your app with the following content, replacing app id, name and full path to cordova-firefoxos as needed:

{
  "id":"io.cordova.hellocordova",
  "name":"HelloCordova",
  "lib": {
    "firefoxos": {
      "uri": "/full/path/to/cordova-firefoxos",
      "version": "dev",
      "id": "cordova-firefoxos-dev"
    }
  }
}

Add Firefox OS platform

$ cordova platform add firefoxos

Add plugins from github or local disk

$ cordova plugin add https://github.com/mozilla-cordova/cordova-plugin-device.git
$ cordova plugin add ../cordova-plugin-contacts

Prepare as usual

$ cordova prepare

Manifest issues

Manifest is automatically created with every ``cordova prepare``. There should be a mechanism to provide these values in a configuration file.

Privileged issue

Default index.html created after cordova prepare contains inline javascript. The (temporary) solution is to remove inline script and add document.onload = app.initialize(); at the end of the www/js/index.js file.

Comparing Contacts find/search API

Fields in both APIs are different there are differences in the search API as well. There are also differences between versions of FFOS (1.2 and 1.3).

Searching by text fields

Searching by number