Author: brianleroux
Date: Mon Jul 22 20:08:45 2013
New Revision: 1505787
URL: http://svn.apache.org/r1505787
Log:
wtf ruby
Modified:
cordova/site/www/_posts/2013-07-19-cordova-3.md
Modified: cordova/site/www/_posts/2013-07-19-cordova-3.md
URL:
http://svn.apache.org/viewvc/cordova/site/www/_posts/2013-07-19-cordova-3.md?rev=1505787&r1=1505786&r2=1505787&view=diff
==============================================================================
--- cordova/site/www/_posts/2013-07-19-cordova-3.md (original)
+++ cordova/site/www/_posts/2013-07-19-cordova-3.md Mon Jul 22 20:08:45 2013
@@ -7,6 +7,7 @@ title: "Apache Cordova 3.0"
date: 2013-07-19 15:45:04 -5
categories: blog releases
tags: news releases MAJOR
+publish: false
---
# Cordova 3.0 Released
@@ -15,13 +16,14 @@ Snapshot available on our [download page
## Light Weight Core
-Cordova 3 introduces a new unified project structure and ships with a very
limited API surface. Developers can now compose a version of Cordova with only
the APIs they need. In the past, Cordova shipped with the entire kitchen sink
of APIs that most applicaitons only needed a small subset of. This lead to
messy, and often not even neccessary, upgrading for our community. With the
release of Cordova 3 you start with a very light weight core and only add the
API surface your application requires. Obviously, this means a performance
improvement but the real win here is maintainance and upgrading. We'll continue
to maintain "core" APIs which are the same device APIs you've come to know and
love.
+Cordova 3 introduces a new unified project structure and ships with a very
limited API surface. Developers can now compose a version of Cordova with only
the APIs they need. In the past, Cordova shipped with the entire kitchen sink
of APIs that most applications only needed a small subset of. This lead to
messy, and often not even necessary, upgrading for our community. With the
release of Cordova 3 you start with a very light weight core and only add the
API surface your application requires. Obviously, this means a performance
improvement but the real win here is maintenance and upgrading. We'll continue
to maintain "core" APIs which are the same device APIs you've come to know and
love.
## New Command Line Tooling
-We're very excited to share two new command line tools: Cordova and Plugman.
Both are implemented using `NodeJS` and thusly distributed via `npm`. The
`cordova` command line tool has been a long time coming. It unifies all
platforms into a single project structure which enables us to extend with
futher tooling around plugins. This is where `plugman` fits in, allowing for
automated discovery, installation, and removal of core and custom plugins.
+We're very excited to share two new command line tools: Cordova and Plugman.
Both are implemented using `NodeJS` and thusly distributed via `npm`. The
`cordova` command line tool has been a long time coming. It unifies all
platforms into a single project structure, making it easy to maintain a single
codebase for multiple platforms. The `cordova` tool builds off of our other new
tool: `plugman`, which provides automated discovery, installation, and removal
of both core and custom plugins.
-We've been testing for months but keep in mind both tools are new, and bugs
happen, so you if you find one or even just have an idea for a new feature
please visit our [issue tracker](http://issues.cordova.io).
+We've been testing for months but keep in mind both tools are new. Bugs
happen, so you if you find one or even just have an idea for a new feature
please visit our [issue tracker](http://issues.cordova.io
+).
## Installing > Downloading
@@ -34,18 +36,19 @@ $ cordova platform add ios
$ cordova emulate ios
```
-Cordova lazy loads so the first app you create might be a little slow. Same
with platform adds. Just use `-d` flag to see progress. For example, `cordova
-d platform add ios`. Maybe crack a beer and chill while it goes about its
business first run.
+Cordova has to download platform files the first time `create` is run, so the
first app you create might be a little slow. Just use the `-d` flag to see
progress. For example, `cordova -d platform add ios`. Maybe crack a beer and
chill while it goes about its business first run.
-Now lets add Android, `cordova platform add android`. Yes: that easy!
+Now let's add Android, `cordova platform add android`. Yes: that easy!
# Installing Plugins
-If you are working with a `cordova` generated project, then you can install
plugins using the `cordova` tool as well: `plugman` is included with `cordova`,
and is used by `cordova` internally to manage plugins.
+If you are working with a platform project directly (one created through a
Cordova platform's `bin/create` script instead of through the `cordova` tool),
then `plugman` can be used standalone. Again, [ensure you have NodeJS
installed](http://nodejs.org) and then simply run `npm install -g plugman`.
```
$ cd MyFunkyApp
$ cordova plugin add
https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git
```
+
You now have geolocation enabled your project!
If you are working with a native project directly then `plugman` can be used
standalone. Again, [ensure you have NodeJS installed](http://nodejs.org) and
then simply run `npm install -g plugman`.
@@ -64,12 +67,13 @@ We have documented [upgrading guides](ht
# Known Issues
-Remember *core plugins no longer exist by default in new projects* and you
have to manually add them using `plugman`. You know we release regularly so you
can expect updates soon and we're going to leave a nice big window for
deprecations as usual.
+Remember *core plugins no longer exist by default in new projects* and you
have to manually add them using `plugman` or `cordova`. You know we release
regularly so you can expect updates soon and we're going to leave a nice big
window for deprecations as usual. Also remember this is an open source project
so if something isn't to your liking you can always pitch in and fix it
yourself!
-- whitelist format will be unified soon, but isn't yet
-- various native IDE's show generated files
-- no way to upgrade CLI projects from the beta releases of the CLI (<=2.9)
-- a plugin discovery repository is still being baked and will be available
very soon
+- Various native IDE's show generated files when using `cordova`-based
projects. Be careful not to edit them or else you may lose your work when
`cordova` is next run!
+- Whitelist (<access> tags) format is inconsistent across platforms
+- There is no "upgrade" command for `cordova` yet. You will need to remove and
re-add plugins/platforms for now.
+- Not all platforms are supported by `cordova`. *Currently* only iOS, Android,
BB10, and Windows Phone
+- A plugin discovery repository is still being baked and will be available
very soon
# Huge Thanks
