Skip to content

Initial cordova-docs Ubuntu platform support added #165

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
knitzsche wants to merge 5 commits into from
Closed

Initial cordova-docs Ubuntu platform support added #165

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
de6abcd
test commit process
Dec 13, 2013
050e76a
revert test commit
Dec 13, 2013
4247808
add ubuntu to platform support table
Dec 13, 2013
16fe20a
Add Ubuntu section to Platform Guides
Dec 13, 2013
1cf2f68
add ubuntu platform guide
Dec 13, 2013
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions docs/en/3.3.0/guide/platforms/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,9 @@ 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
Expand Down
105 changes: 105 additions & 0 deletions docs/en/3.3.0/guide/platforms/ubuntu/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,105 @@
---
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









20 changes: 20 additions & 0 deletions docs/en/3.3.0/guide/support/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand All @@ -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>
Expand All @@ -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>
Expand All @@ -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>
Expand All @@ -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>
Expand All @@ -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>
Expand All @@ -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>
Expand All @@ -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>
Expand All @@ -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>
Expand All @@ -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>
Expand All @@ -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>
Expand All @@ -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>
Expand All @@ -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>
Expand All @@ -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>
Expand All @@ -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>
Expand All @@ -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>
Expand All @@ -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>
Expand All @@ -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>
Expand All @@ -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>
Expand All @@ -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 &amp; indexedDB</td>
<td data-col="winphone8" class="y">localStorage &amp; indexedDB</td>
<td data-col="win8" class="y">localStorage &amp; indexedDB</td>
Expand Down