wheeler/meteor-cordova-loader

Meteor cordova asset compiler and loader (phonegap). It makes working with cordova easy.

Cordova Asset Compiler & Loader

Introduction

Cordova Loader's goal is to make using Meteor with Cordova as easy as using Meteor itself. The compiler interprets the provided Cordova project directory and compiles the assets into minified, platform-specific JavaScript which is stored in memory. When the client loads, it automatically pulls in the platform-specific cordova code for that device. The Cordova API can be used from Meteor the same as it is from vanilla JS apps. Enjoy!

This package aims to solve the shortcomings of the other meteor + cordova packages.

Note: Currently only tested with iOS. Will test the other platforms asap.

Installation / Setup

Requirements

• Xcode: 5.1.1
• Cordova: 3.5

================

Package Installation

mrt add cordova-loader

Note: I would also suggest adding the appcache-extra package. It will cache the cordova/platform file after it is loaded once and gives you a way to handle appcache reloads with better UX.

================

Meteor settings file (settings.json)

{
  "cordova":{
    "path": "/directory-example/cordova-project",
    "platforms": ["ios"],
    "logging": true
  }
}

Options

• path: Path to your Cordova project directory.
• platforms: Array of platforms you are using.
• logging: This is optional. Just trying to give some transpency into the package.

Note: the compiler will only run once due to live reload loop. If you want to rerun the compiler after adding a plugin just delete any of the public/cordova/ files.

================

Comparison of Meteor + Cordova methods/packages

• Meteor + Cordova Methods - Pros / Cons to the different packages / ways of combining meteor with Cordova.

Cordova Setup Guide

• Cordova Setup Guide - Instructions on how to setup the basic Cordova project needed to get started. (coming soon).

Recommended Cordova Plugins

• Cordova Plugin Guide - Plugins necessary to make the Meteor app feel native. Also, an overview of optional plugins like setting up push notificaitons and geolocation.

Platform Setup Guides

• iOS Setup Guide - Detailed walkthrough of steps to setup the iOS Cordova project.
• Android Setup Guide - Detailed walkthrough of steps to setup Android Cordova project. (coming soon).

Facebook Native SDK

• accounts-facebook-cordova - Works with the cordova plugin to use facebook single sign on when it exists otherwise use standar oauth package.

Famo.us Integration

• celestial - Package to make using Famo.us with Meteor easier.

Example Apps

• Meteor Cordova Todo - Just started working on this. This will eventually be a working app as an example.

Final Notes

Running your app with settings

mrt --settings settings.json

================

If you want more features than this provides, file an issue. Feature requests/contributions are welcome.