diff --git a/docs/en/3.3.0/guide/platforms/index.md b/docs/en/3.3.0/guide/platforms/index.md index f477ff551e..7b28c2650b 100644 --- a/docs/en/3.3.0/guide/platforms/index.md +++ b/docs/en/3.3.0/guide/platforms/index.md @@ -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 diff --git a/docs/en/3.3.0/guide/platforms/ubuntu/index.md b/docs/en/3.3.0/guide/platforms/ubuntu/index.md new file mode 100644 index 0000000000..2c290063fc --- /dev/null +++ b/docs/en/3.3.0/guide/platforms/ubuntu/index.md @@ -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 + + + + + + + + + diff --git a/docs/en/3.3.0/guide/support/index.md b/docs/en/3.3.0/guide/support/index.md index 8a45aa64ca..579356009d 100644 --- a/docs/en/3.3.0/guide/support/index.md +++ b/docs/en/3.3.0/guide/support/index.md @@ -35,6 +35,7 @@ CLI's shorthand stubs.) android blackberry10 ios + Ubuntu wp7 (Windows
Phone 7) wp8 (Windows
Phone 8) win8
(Windows 8) @@ -51,6 +52,7 @@ CLI's shorthand stubs.) Mac, Windows, Linux Mac, Windows Mac + Ubuntu Windows Windows @@ -64,6 +66,7 @@ CLI's shorthand stubs.) (see details) (see details) + @@ -77,6 +80,7 @@ CLI's shorthand stubs.) (see details) (see details) (see details) + (see details) (see details) @@ -95,6 +99,7 @@ CLI's shorthand stubs.) + @@ -108,6 +113,7 @@ CLI's shorthand stubs.) + @@ -121,6 +127,7 @@ CLI's shorthand stubs.) + @@ -134,6 +141,7 @@ CLI's shorthand stubs.) (3GS+) + @@ -147,6 +155,7 @@ CLI's shorthand stubs.) + @@ -160,6 +169,7 @@ CLI's shorthand stubs.) + @@ -173,6 +183,7 @@ CLI's shorthand stubs.) + @@ -186,6 +197,7 @@ CLI's shorthand stubs.) + @@ -199,6 +211,7 @@ CLI's shorthand stubs.) + @@ -212,6 +225,7 @@ CLI's shorthand stubs.) + @@ -225,6 +239,7 @@ CLI's shorthand stubs.) + @@ -238,6 +253,7 @@ CLI's shorthand stubs.) + uses iframe @@ -251,6 +267,7 @@ CLI's shorthand stubs.) + @@ -264,6 +281,7 @@ CLI's shorthand stubs.) + @@ -277,6 +295,7 @@ CLI's shorthand stubs.) + @@ -290,6 +309,7 @@ CLI's shorthand stubs.) + localStorage & indexedDB localStorage & indexedDB localStorage & indexedDB