cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From brianler...@apache.org
Subject svn commit: r1505787 - /cordova/site/www/_posts/2013-07-19-cordova-3.md
Date Mon, 22 Jul 2013 20:08:45 GMT
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
 



Mime
View raw message