@@ -3,7 +3,8 @@ Building Unity 8
33
44download source
55---------------
6−- the build requires some additional dependencies, so create the parent folder to not pollute your setup
6+- the build requires some additional dependencies, so create the parent
7+folder to not pollute your setup
78 $ mkdir ~/unity
89
910- fetch Unity 8 source
@@ -16,19 +17,22 @@ build dependencies
1617If its your first time, download & build deps
1718$ ./build -s
1819 this will:
19− - add ppa:phablet-team/desktop-deps, ppa:canonical-qt5-edgers/qt5-proper, ppa:ubuntu-sdk-team
20− - build and install lp:libunity/phablet, lp:unity/phablet-mods, lp:hud/phablet locally
21− - install build dependencies
20+ - add the following ppa's
21+ - ppa:phablet-team/desktop-deps
22+ - ppa:canonical-qt5-edgers/qt5-proper
23+ - ppa:ubuntu-sdk-team
24+ - install the required dependencies to build, as well as run on the desktop
25+
26+Note, once the ppa's are added a apt-get update will be run, if you have
27+any failures associated with it, the build script will bail out of the setup
28+and fail to install all the required dependencies.
2229
2330build Unity 8
2431-------------
2532$ ./build
2633
27−subsequent updates of the dependencies
28−--------------------------------------
29−$ ./build_unity -u
30−$ ./build_unity
31−
34+You may also rebuild with the -c for clean, which just deletes the build
35+directory.
3236
3337Running Unity 8 on your desktop
3438===============================
@@ -38,6 +42,12 @@ run the Unity 8 shell
3842$ cd ~/unity/unity8
3943$ ./run
4044
45+Options can be passed to test the lock screen
46+$ ./run -p OR -k
47+
48+-p is for pin lock, for which the default prompt answer is "1234"
49+-k is for keylock passphrase, for which the default prompt answer is "password"
50+
4151Notes
4252-----
4353- to navigate, utilize the mouse left button as you would your finger
@@ -49,10 +59,16 @@ Notes
4959Running Unity 8 on devices
5060==========================
5161- Ubuntu Touch builds are currently only available in 13.10 flavour
52−- supported hardware should match one those listed here https://wiki.ubuntu.com/Touch/Devices#Running_fine
53−- follow the Ubuntu Touch install instructions for your chosen device https://wiki.ubuntu.com/Touch/Install
62+- supported hardware should match one those listed here
63+https://wiki.ubuntu.com/Touch/Devices#Running_fine
64+- follow the Ubuntu Touch install instructions for your chosen device
65+https://wiki.ubuntu.com/Touch/Install
5466- make sure your device is connected to a WiFi network
55−- also make sure you have your SSH key in ~/.ssh/id_rsa.pub (or install one on the device yourself)
67+- If you haven’t already or if you’ve just freshly flashed your device
68+make sure you run phablet-network-setup which will allow package updates to
69+the device
70+- also make sure you have your SSH key in ~/.ssh/id_rsa.pub (or install one
71+on the device yourself)
5672
5773$ cd ~/unity/unity8
5874$ ./run_on_device -s
@@ -67,18 +83,27 @@ $ ./run_on_device
6783 - build on the device
6884 - replace the running shell
6985
86+Options can be passed to test the lock screen
87+$ ./run_on_device -p OR -k
88+
89+-p is for pin lock, for which the default prompt answer is "1234"
90+-k is for keylock passphrase, for which the default prompt answer is "password"
91+
7092Notes
7193-----
7294- using adb over TCP has some advantages, Google will be of help here
7395 - TL;DR: `adb tcpip 5555; adb connect $your_device_ip`
7496 - you can persist the above via `adb shell setprop persist.adb.tcp.port 5555`
7597 - it's unsafe - anyone can connect to your device
76− - with TCP the Nexus 10 doesn't drop the adb connection when locking the screen
77−- exporting ANDROID_SERIAL=$your_device_serial or ANDROID_SERIAL=$your_device_ip:5555
78− will make adb not complain about multiple devices
98+ - with TCP the Nexus 10 doesn't drop the adb connection when locking
99+ the screen
100+- exporting ANDROID_SERIAL=$your_device_serial or
101+ANDROID_SERIAL=$your_device_ip:5555
102+ will make adb not complain about multiple devices
79103- you can export TARGET_IP=$your_device_ip TARGET_SSH_PORT=22 for run_on_device
80104 to not use adb forwarding - useful if you use multiple devices
81−- using Ninja (package ninja-build - run_on_device -s installs this now) will improve
105+- using Ninja (package ninja-build - run_on_device -s installs this now)
106+will improve
82107 build times (especially in the nothing-to-build case)
83108
84109
@@ -90,4 +115,6 @@ https://launchpad.net/canonical-client-development-guidelines
90115
91116Development Environment
92117=======================
93−QtCreator (available via the Software Center) is the best IDE to hack on Unity 8.
118+QtCreator (available via the Software Center) is the best IDE to hack on
119+Unity 8.
120+