cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ste...@apache.org
Subject [4/4] docs commit: add details on debugging and publishing an app for Ubuntu
Date Tue, 14 Jun 2016 18:46:18 GMT
add details on debugging and publishing an app for Ubuntu

 This closes #610


Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/26ed85db
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/26ed85db
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/26ed85db

Branch: refs/heads/master
Commit: 26ed85dbcf2a28f1fe2e6519e7bb8f863ffd59fa
Parents: fb7158d
Author: David Barth <david.barth@canonical.com>
Authored: Thu Jun 2 11:30:47 2016 +0200
Committer: Steve Gill <stevengill97@gmail.com>
Committed: Tue Jun 14 11:46:18 2016 -0700

----------------------------------------------------------------------
 www/docs/en/dev/guide/platforms/ubuntu/index.md | 80 ++++++++++++++++----
 1 file changed, 66 insertions(+), 14 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/26ed85db/www/docs/en/dev/guide/platforms/ubuntu/index.md
----------------------------------------------------------------------
diff --git a/www/docs/en/dev/guide/platforms/ubuntu/index.md b/www/docs/en/dev/guide/platforms/ubuntu/index.md
index ae10a4b..9fbe1ff 100644
--- a/www/docs/en/dev/guide/platforms/ubuntu/index.md
+++ b/www/docs/en/dev/guide/platforms/ubuntu/index.md
@@ -41,14 +41,12 @@ The target environment is an Ubuntu phone, supporting at least the ubuntu-sdk-ap
 
 The cordova-ubuntu platform support code requires at least cordova-cli 4.3.1. This is the
minimum and recommended version at the time of this writing. cordova-ubuntu 4.3.x releases
are all compatible with that tool release.
 
-### Latest Information
-
 For the latest information on Cordova app support for Ubuntu runtime platforms,
 see [wiki.ubuntu.com/Cordova](http://wiki.ubuntu.com/Cordova).
 
 ## Installing the Development Environment
 
-### Installing Ubuntu
+### Install Ubuntu
 
 Installation images of Ubuntu 16.04 LTS are available at http://www.ubuntu.com/download
 
@@ -98,7 +96,7 @@ $ sudo apt-get update
 $ sudo apt-get install cordova-cli
 ```
 
-### Adding an Ubuntu "click chroot"
+### Add an Ubuntu "click chroot"
 
 The build environment needs to be separated from the developer's environment, to prevent
unwanted side effects and provide a clean, repeatable process.
 
@@ -147,34 +145,88 @@ Creates an app in a `hello` directory whose display name is
 
 ```bash
 $ cordova create helloworld helloworld.ubuntudeveloper HelloWorld
+$ cd hello
+$ cordova platform add ubuntu
 ```
 
-### Move into the Project Directory
+Note that Ubuntu applications use a pair <appname>.<username> as a naming convention.
+
+### Add a Plugin
 
 ```bash
-$ cd hello
+$ cordova plugin add cordova-plugin-camera
 ```
 
-### Add the Ubuntu Platform
+### Build for Ubuntu devices
 
 ```bash
-$ cordova platform add ubuntu
+$ cordova build --device
 ```
 
-### Add a Plugin
+You can see detailed build logs with the following options:
+```bash
+$ cordova -d build --device -- --verbose
+```
 
+You can build your app for a different target framework by specifying the option below:
 ```bash
-$ cordova plugin add cordova-plugin-camera
+$ cordova -d build --device -- --framework=ubuntu-sdk-16.04
 ```
 
-### Build for Ubuntu devices
+Note that for the latter to work, you will need to have a corresponding click chroot installed
on your build system.
+
+### Run the App on an Ubuntu device
 
 ```bash
-$ cordova build ubuntu --device
+$ cordova run --device
 ```
 
-### Run the App on an Ubuntu device
+This will:
+1. build the app for the device target
+1. package it using the click packaging system
+1. transfer the app on the device
+1. stop the app if it was already running
+1. install the app
+1. start the app
+
+
+## Debugging
+
+You can enable chrome devtools support to debug your app, by adding the --debug flag:
 
 ```bash
-$ cordova run ubuntu --device
+$ cordova run --device --debug
 ```
+
+Then simply connect to the URL mentioned in the logs.
+
+## Publishing your app
+
+Once you have finished developing and testing your app, you can publish it on the Ubuntu
App Store.
+
+### Generate and verify the package
+
+Your app is already packaged in a format compatible with the app store. Just find the .click
package generate by the cordova-ubuntu build system:
+
+```bash
+$ cordova build --device
+$ find -name "*.click"
+```
+
+You can manually verify that the package passes all verification steps enforced by the Ubuntu
App Store system, by using the click-reviewer-tools:
+
+```bash
+$ click review -v <click file>
+```
+
+Note: this step is done automatically by the build system as well.
+
+### Sign up and upload to the app store
+
+You need to first create a free developer account on the Ubuntu App Store.
+
+Then you will be able to upload your package to the store and make it available to all users
of Ubuntu devices.
+
+The full process is documented online at https://developer.ubuntu.com/en/publish/
+
+


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


Mime
View raw message