Merge lp:~saviq/unity/phablet.add-coding-import-path into lp:unity/phablet

[Michał Sawicz]

add CODING guide and importPath to the qmlproject file

[kevin gunn (kgunn72)]

looks good

review: Approve

[PS Jenkins bot (ps-jenkins)]

FAILED: Continuous integration, rev:509
http://jenkins.qa.ubuntu.com/job/unity-phablet-ci/135/
Executed test runs:
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-phablet-quantal-armhf-ci/136/console
    SUCCESS: http://jenkins.qa.ubuntu.com/job/unity-phablet-quantal-i386-ci/135
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-phablet-raring-armhf-ci/11/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-phablet-raring-i386-ci/11/console
    SUCCESS: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-runner/313

Click here to trigger a rebuild:
http://s-jenkins:8080/job/unity-phablet-ci/135/rebuild

review: Needs Fixing (continuous-integration)

[PS Jenkins bot (ps-jenkins)]

FAILED: Continuous integration, rev:510
http://jenkins.qa.ubuntu.com/job/unity-phablet-ci/138/
Executed test runs:
    SUCCESS: http://jenkins.qa.ubuntu.com/job/unity-phablet-quantal-armhf-ci/139
        deb: http://jenkins.qa.ubuntu.com/job/unity-phablet-quantal-armhf-ci/139/artifact/work/output/*zip*/output.zip
    SUCCESS: http://jenkins.qa.ubuntu.com/job/unity-phablet-quantal-i386-ci/138
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-phablet-raring-armhf-ci/14/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/unity-phablet-raring-i386-ci/14/console

Click here to trigger a rebuild:
http://s-jenkins:8080/job/unity-phablet-ci/138/rebuild

review: Needs Fixing (continuous-integration)

[PS Jenkins bot (ps-jenkins)]

PASSED: Continuous integration, rev:510
http://jenkins.qa.ubuntu.com/job/unity-phablet-ci/171/
Executed test runs:
    SUCCESS: http://jenkins.qa.ubuntu.com/job/unity-phablet-quantal-armhf-ci/172
        deb: http://jenkins.qa.ubuntu.com/job/unity-phablet-quantal-armhf-ci/172/artifact/work/output/*zip*/output.zip
    SUCCESS: http://jenkins.qa.ubuntu.com/job/unity-phablet-quantal-i386-ci/171
    SUCCESS: http://jenkins.qa.ubuntu.com/job/unity-phablet-raring-armhf-ci/47
        deb: http://jenkins.qa.ubuntu.com/job/unity-phablet-raring-armhf-ci/47/artifact/work/output/*zip*/output.zip
    SUCCESS: http://jenkins.qa.ubuntu.com/job/unity-phablet-raring-i386-ci/47
    SUCCESS: http://jenkins.qa.ubuntu.com/job/generic-mediumtests-runner/423

Click here to trigger a rebuild:
http://s-jenkins:8080/job/unity-phablet-ci/171/rebuild

review: Approve (continuous-integration)

=== added file 'CODING'
--- CODING	1970-01-01 00:00:00 +0000
+++ CODING	2013-03-25 17:01:21 +0000
@@ -0,0 +1,89 @@
+Building UnityNext
+==================
+
+download source
+---------------
+- the build requires some additional dependencies, so create the parent folder to not pollute your setup
+  $ mkdir ~/unity
+
+- fetch Unity Next source
+  $ sudo apt-get install bzr
+  $ bzr branch lp:unity/phablet ~/unity/unity-next
+  $ cd ~/unity/unity-next
+
+build dependencies
+------------------
+If its your first time, download & build deps
+$ ./build -s
+  this will:
+  - add ppa:phablet-team/desktop-deps
+  - for 12.10, add ppa:canonical-qt5-edgers/qt5-proper and ppa:ubuntu-sdk-team/ppa
+  - build and install lp:libunity/phablet, lp:unity/phablet-mods, lp:hud/phablet and lp:unity-lens-people locally
+  - for 12.10, build and install lp:nux/phablet locally
+  - install build dependencies
+
+build UnityNext
+---------------
+$ ./build
+
+subsequent updates of the dependencies
+--------------------------------------
+$ ./build_unity -u
+$ ./build_unity
+
+
+Running UnityNext on your desktop
+=================================
+
+run the People lens daemon
+--------------------------
+$ ~/unity/unity_build/libexec/unity-people-daemon
+
+run the UnityNext shell
+-----------------------
+$ cd ~/unity/unity-next
+$ ./run
+
+
+Notes
+=====
+- to navigate, utilize the mouse left button as you would your finger
+- if your contacts are empty
+  $ sudo apt-get install gir1.2-ebook-1.2
+  $ manage-address-book.py create
+    this will:
+    - create an EDS address book
+    - populate the address book with sample data
+
+
+Running UnityNext on devices
+============================
+- Ubuntu Touch builds are currently only available in 12.10 flavour
+- supported hardware should match one those listed here https://wiki.ubuntu.com/Touch/Devices#Running_fine
+- follow the Ubuntu Touch install instructions for your chosen device https://wiki.ubuntu.com/Touch/Install
+- make sure your device is connected to a WiFi network
+- also make sure you have your SSH key in ~/.ssh/id_rsa.pub (or install one on the device yourself)
+
+$ cd ~/unity/unity-next
+$ ./run_on_device -s
+  this will:
+  - install your public SSH key on the device
+  - add ppa:canonical-qt5-edgers/qt5-proper and ppa:phablet-team
+  - install the needed dependencies
+
+$ ./run_on_device
+  this will:
+  - rsync the code to the device
+  - build on the device
+  - replace the running shell
+
+
+Coding guidelines
+=================
+The work-in-progress coding guidelines are available under:
+https://launchpad.net/canonical-client-development-guidelines
+
+
+Development Environment
+=======================
+QtCreator (available via the Software Center) is the best IDE to hack on UnityNext.

=== modified file 'unity.qmlproject'
--- unity.qmlproject	2013-02-18 18:42:10 +0000
+++ unity.qmlproject	2013-03-25 17:01:21 +0000
@@ -16,5 +16,5 @@
         directory: "."
     }
     /* List of plugin directories passed to QML runtime */
-    // importPaths: [ "../exampleplugin" ]
+    importPaths: [ "plugins" ]
 }