You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by mw...@apache.org on 2013/12/17 20:36:39 UTC
docs commit: [CB-5666] Add Ubuntu platform guide for edge version.
Updated Branches:
refs/heads/master 42d015728 -> 0ba031132
[CB-5666] Add Ubuntu platform guide for edge version.
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/0ba03113
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/0ba03113
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/0ba03113
Branch: refs/heads/master
Commit: 0ba031132a86bfb17c7468fd540b72f7c497353b
Parents: 42d0157
Author: Michael Brooks <mi...@michaelbrooks.ca>
Authored: Tue Dec 17 13:36:27 2013 -0600
Committer: Michael Brooks <mi...@michaelbrooks.ca>
Committed: Tue Dec 17 13:36:27 2013 -0600
----------------------------------------------------------------------
docs/en/3.3.0/guide/platforms/index.md | 1 +
docs/en/edge/guide/platforms/index.md | 4 +
docs/en/edge/guide/platforms/ubuntu/index.md | 97 +++++++++++++++++++++++
docs/en/edge/guide/support/index.md | 20 +++++
4 files changed, 122 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/0ba03113/docs/en/3.3.0/guide/platforms/index.md
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/guide/platforms/index.md b/docs/en/3.3.0/guide/platforms/index.md
index 811721e..7cece3f 100644
--- a/docs/en/3.3.0/guide/platforms/index.md
+++ b/docs/en/3.3.0/guide/platforms/index.md
@@ -71,6 +71,7 @@ a lower-level alternative to the `cordova` command-line utility.
* Upgrading iOS
## Ubuntu
+
* Ubuntu Platform Guide
## Windows Phone
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/0ba03113/docs/en/edge/guide/platforms/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/index.md b/docs/en/edge/guide/platforms/index.md
index f477ff5..ba60628 100644
--- a/docs/en/edge/guide/platforms/index.md
+++ b/docs/en/edge/guide/platforms/index.md
@@ -70,6 +70,10 @@ a lower-level alternative to the `cordova` command-line utility.
* iOS Command-line Tools
* Upgrading iOS
+## Ubuntu
+
+* Ubuntu Platform Guide
+
## Windows Phone
* Windows Phone 8 Platform Guide
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/0ba03113/docs/en/edge/guide/platforms/ubuntu/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ubuntu/index.md b/docs/en/edge/guide/platforms/ubuntu/index.md
new file mode 100644
index 0000000..ed6130a
--- /dev/null
+++ b/docs/en/edge/guide/platforms/ubuntu/index.md
@@ -0,0 +1,97 @@
+---
+license: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+---
+
+# Ubuntu Platform Guide
+
+## Initial Release
+
+Welcome to the initial release of Ubuntu platform support in Cordova. With this
+release, the focus is developing on an Ubuntu system and using the Cordova Web
+Project Dev Workflow. This includes adding the Ubuntu platform to your project,
+adding standard Cordova plugins, and, of course, building and running apps for
+the Ubuntu platform.
+
+### Ubuntu SDK
+
+You may also want to install the Ubuntu QtCreator development environment. See
+[developer.ubuntu.com](http://developer.ubuntu.com) for more info. (The
+QtCreator SDK is not required to add Ubuntu platform support to your Cordova
+app.)
+
+### Ubuntu Runtime Platforms
+
+Ubuntu is well-known for its Desktop environment (for laptops, PCs and such).
+Ubuntu Touch extends the Ubuntu OS onto phones and tablets. Ubuntu runtime
+platforms have varying CPU architectures (x86, armhf, etc.). App and plugin
+code must be compiled appropriately. Support for this broad area is rapidly
+evolving in the Ubuntu.
+
+### Latest Information
+
+For the latest information on Cordova app support for Ubuntu runtime platforms,
+see [wiki.ubuntu.com/Cordova](http://wiki.ubuntu.com/Cordova).
+
+## Development Platform Requirements
+
+For this initial release, the development platform should be an Ubuntu Desktop.
+Ubuntu 13.10 (codename ‘saucy’) or later is required to enjoy the full set of
+supported capabilities.
+
+You can install Cordova on non-Ubuntu systems (using npm), but important
+capabilities are only provided through Ubuntu debian packages at this time.
+
+## Cordova Installation
+
+Add the Ubuntu Cordova
+[Personal Package Archive](https://launchpad.net/~cordova-ubuntu/+archive/ppa)
+to your Ubuntu system:
+
+ $ sudo add-apt-repository ppa:cordova-ubuntu/ppa
+ $ sudo apt-get update
+
+Install packages:
+
+ $ sudo apt-get install cordova-cli nodejs-legacy npm cmake debhelper libx11-dev libicu-dev pkg-config qtbase5-dev qtchooser qtdeclarative5-dev qtfeedback5-dev qtlocation5-dev qtmultimedia5-dev qtpim5-dev qtsensors5-dev qtsystems5-dev
+
+## Project Workflow
+
+### Create a project
+
+ $ cordova create project1 REVERSEDNSNAME.project1 project1
+
+### Move into the Project Directory
+
+ $ cd project1
+
+### Add the Ubuntu Platform
+
+ $ cordova platform add ubuntu
+
+### Build for Ubuntu
+
+ $ cordova build ubuntu
+
+### Run the App
+
+ $ cordova run ubuntu
+
+### Add the Battery Status Plugin
+
+ $ cordova plugin add org.apache.cordova.battery-status
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/0ba03113/docs/en/edge/guide/support/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/support/index.md b/docs/en/edge/guide/support/index.md
index 8a45aa6..5793560 100644
--- a/docs/en/edge/guide/support/index.md
+++ b/docs/en/edge/guide/support/index.md
@@ -35,6 +35,7 @@ CLI's shorthand stubs.)
<th><tt>android</tt></th>
<th><tt>blackberry10</tt></th>
<th><tt>ios</tt></th>
+ <th><tt>Ubuntu</tt></th>
<th><tt>wp7</tt> (Windows<br/>Phone 7)</th>
<th><tt>wp8</tt> (Windows<br/>Phone 8)</th>
<th><tt>win8</tt><br/>(Windows 8)</th>
@@ -51,6 +52,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y">Mac, Windows, Linux</td>
<td data-col="blackberry10" class="y">Mac, Windows</td>
<td data-col="ios" class="y">Mac</td>
+ <td data-col="ubuntu" class="y">Ubuntu</td>
<td data-col="winphone7" class="y">Windows</td>
<td data-col="winphone8" class="y">Windows</td>
<td data-col="win8" class="y"></td>
@@ -64,6 +66,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y"><a href="guide_platforms_android_webview.md.html">(see details)</a></td>
<td data-col="blackberry10" class="n"></td>
<td data-col="ios" class="y"><a href="guide_platforms_ios_webview.md.html">(see details)</a></td>
+ <td data-col="ubuntu" class="y"></td>
<td data-col="winphone7" class="n"></td>
<td data-col="winphone8" class="n"></td>
<td data-col="win8" class="n"></td>
@@ -77,6 +80,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y"><a href="guide_guide_platforms_android_plugin.md.html">(see details)</a></td>
<td data-col="blackberry10" class="y"><a href="guide_guide_platforms_blackberry10_plugin.md.html">(see details)</a></td>
<td data-col="ios" class="y"><a href="guide_guide_platforms_ios_plugin.md.html">(see details)</a></td>
+ <td data-col="ubuntu" class="y"></td>
<td data-col="winphone7" class="y"><a href="guide_guide_platforms_wp8_plugin.md.html">(see details)</a></td>
<td data-col="winphone8" class="y"><a href="guide_guide_platforms_wp8_plugin.md.html">(see details)</a></td>
<td data-col="win8" class="y"></td>
@@ -95,6 +99,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y"></td>
<td data-col="blackberry10" class="y"></td>
<td data-col="ios" class="y"></td>
+ <td data-col="ubuntu" class="y"></td>
<td data-col="winphone7" class="y"></td>
<td data-col="winphone8" class="y"></td>
<td data-col="win8" class="y"></td>
@@ -108,6 +113,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y"></td>
<td data-col="blackberry10" class="y"></td>
<td data-col="ios" class="y"></td>
+ <td data-col="ubuntu" class="y"></td>
<td data-col="winphone7" class="y"></td>
<td data-col="winphone8" class="y"></td>
<td data-col="win8" class="y"></td>
@@ -121,6 +127,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y"></td>
<td data-col="blackberry10" class="y"></td>
<td data-col="ios" class="y"></td>
+ <td data-col="ubuntu" class="y"></td>
<td data-col="winphone7" class="y"></td>
<td data-col="winphone8" class="y"></td>
<td data-col="win8" class="n"></td>
@@ -134,6 +141,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y"></td>
<td data-col="blackberry10" class="y"></td>
<td data-col="ios" class="y">(3GS+)</td>
+ <td data-col="ubuntu" class="y"></td>
<td data-col="winphone7" class="y"></td>
<td data-col="winphone8" class="y"></td>
<td data-col="win8" class="y"></td>
@@ -147,6 +155,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y"></td>
<td data-col="blackberry10" class="y"></td>
<td data-col="ios" class="y"></td>
+ <td data-col="ubuntu" class="y"></td>
<td data-col="winphone7" class="y"></td>
<td data-col="winphone8" class="y"></td>
<td data-col="win8" class="y"></td>
@@ -160,6 +169,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y"></td>
<td data-col="blackberry10" class="y"></td>
<td data-col="ios" class="y"></td>
+ <td data-col="ubuntu" class="y"></td>
<td data-col="winphone7" class="y"></td>
<td data-col="winphone8" class="y"></td>
<td data-col="win8" class="n"></td>
@@ -173,6 +183,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y"></td>
<td data-col="blackberry10" class="y"></td>
<td data-col="ios" class="y"></td>
+ <td data-col="ubuntu" class="y"></td>
<td data-col="winphone7" class="y"></td>
<td data-col="winphone8" class="y"></td>
<td data-col="win8" class="y"></td>
@@ -186,6 +197,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y"></td>
<td data-col="blackberry10" class="y"></td>
<td data-col="ios" class="y"></td>
+ <td data-col="ubuntu" class="y"></td>
<td data-col="winphone7" class="y"></td>
<td data-col="winphone8" class="y"></td>
<td data-col="win8" class="y"></td>
@@ -199,6 +211,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y"></td>
<td data-col="blackberry10" class="y"></td>
<td data-col="ios" class="y"></td>
+ <td data-col="ubuntu" class="y"></td>
<td data-col="winphone7" class="y"></td>
<td data-col="winphone8" class="y"></td>
<td data-col="win8" class="y"></td>
@@ -212,6 +225,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y"></td>
<td data-col="blackberry10" class="y"></td>
<td data-col="ios" class="y"></td>
+ <td data-col="ubuntu" class="y"></td>
<td data-col="winphone7" class="y"></td>
<td data-col="winphone8" class="y"></td>
<td data-col="win8" class="y"></td>
@@ -225,6 +239,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y"></td>
<td data-col="blackberry10" class="n"></td>
<td data-col="ios" class="y"></td>
+ <td data-col="ubuntu" class="y"></td>
<td data-col="winphone7" class="y"></td>
<td data-col="winphone8" class="y"></td>
<td data-col="win8" class="n"></td>
@@ -238,6 +253,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y"></td>
<td data-col="blackberry10" class="y"></td>
<td data-col="ios" class="y"></td>
+ <td data-col="ubuntu" class="y"></td>
<td data-col="winphone7" class="y"></td>
<td data-col="winphone8" class="y"></td>
<td data-col="win8" class="p">uses iframe</td>
@@ -251,6 +267,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y"></td>
<td data-col="blackberry10" class="y"></td>
<td data-col="ios" class="y"></td>
+ <td data-col="ubuntu" class="y"></td>
<td data-col="winphone7" class="y"></td>
<td data-col="winphone8" class="y"></td>
<td data-col="win8" class="y"></td>
@@ -264,6 +281,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y"></td>
<td data-col="blackberry10" class="y"></td>
<td data-col="ios" class="y"></td>
+ <td data-col="ubuntu" class="y"></td>
<td data-col="winphone7" class="y"></td>
<td data-col="winphone8" class="y"></td>
<td data-col="win8" class="y"></td>
@@ -277,6 +295,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y"></td>
<td data-col="blackberry10" class="y"></td>
<td data-col="ios" class="y"></td>
+ <td data-col="ubuntu" class="y"></td>
<td data-col="winphone7" class="y"></td>
<td data-col="winphone8" class="y"></td>
<td data-col="win8" class="y"></td>
@@ -290,6 +309,7 @@ CLI's shorthand stubs.)
<td data-col="android" class="y"></td>
<td data-col="blackberry10" class="y"></td>
<td data-col="ios" class="y"></td>
+ <td data-col="ubuntu" class="y"></td>
<td data-col="winphone7" class="y">localStorage & indexedDB</td>
<td data-col="winphone8" class="y">localStorage & indexedDB</td>
<td data-col="win8" class="y">localStorage & indexedDB</td>