@@ -3,7 +3,8 @@ Building Unity 8
4download source
4download source
5---------------
5---------------
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
7 $ mkdir ~/unity
8 $ mkdir ~/unity
9- fetch Unity 8 source
10- fetch Unity 8 source
@@ -16,19 +17,22 @@ build dependencies
16If its your first time, download & build deps
17If its your first time, download & build deps
17$ ./build -s
18$ ./build -s
18 this will:
19 this will:
20+ - add the following ppa's
21+ - ppa:phablet-team/desktop-deps
19− - add ppa:phablet-team/desktop-deps, ppa:canonical-qt5-edgers/qt5-proper, ppa:ubuntu-sdk-team
22+ - ppa:canonical-qt5-edgers/qt5-proper
20− - build and install lp:libunity/phablet, lp:unity/phablet-mods, lp:hud/phablet locally
23+ - ppa:ubuntu-sdk-team
21− - install build dependencies
24+ - install the required dependencies to build, as well as run on the desktop
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.
23build Unity 8
30build Unity 8
24-------------
31-------------
27−subsequent updates of the dependencies
34+You may also rebuild with the -c for clean, which just deletes the build
28−--------------------------------------
35+directory.
33Running Unity 8 on your desktop
37Running Unity 8 on your desktop
34===============================
38===============================
@@ -38,6 +42,12 @@ run the Unity 8 shell
38$ cd ~/unity/unity8
42$ cd ~/unity/unity8
45+Options can be passed to test the lock screen
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"
43- to navigate, utilize the mouse left button as you would your finger
53- to navigate, utilize the mouse left button as you would your finger
@@ -49,10 +59,16 @@ Notes
49Running Unity 8 on devices
59Running Unity 8 on devices
50==========================
60==========================
51- Ubuntu Touch builds are currently only available in 13.10 flavour
61- 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
62+- supported hardware should match one those listed here
63+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
64+- follow the Ubuntu Touch install instructions for your chosen device
65+https://wiki.ubuntu.com/Touch/Install
54- make sure your device is connected to a WiFi network
66- make sure your device is connected to a WiFi network
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
55−- also make sure you have your SSH key in ~/.ssh/id_rsa.pub (or install one on the device yourself)
70+- also make sure you have your SSH key in ~/.ssh/id_rsa.pub (or install one
71+on the device yourself)
57$ cd ~/unity/unity8
73$ cd ~/unity/unity8
58$ ./run_on_device -s
74$ ./run_on_device -s
@@ -67,18 +83,27 @@ $ ./run_on_device
67 - build on the device
83 - build on the device
68 - replace the running shell
84 - replace the running shell
86+Options can be passed to test the lock screen
87+$ ./run_on_device -p OR -k
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"
72- using adb over TCP has some advantages, Google will be of help here
94- using adb over TCP has some advantages, Google will be of help here
73 - TL;DR: `adb tcpip 5555; adb connect $your_device_ip`
95 - TL;DR: `adb tcpip 5555; adb connect $your_device_ip`
74 - you can persist the above via `adb shell setprop persist.adb.tcp.port 5555`
96 - you can persist the above via `adb shell setprop persist.adb.tcp.port 5555`
75 - it's unsafe - anyone can connect to your device
97 - 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
98+ - with TCP the Nexus 10 doesn't drop the adb connection when locking
77−- exporting ANDROID_SERIAL=$your_device_serial or ANDROID_SERIAL=$your_device_ip:5555
100+- exporting ANDROID_SERIAL=$your_device_serial or
101+ANDROID_SERIAL=$your_device_ip:5555
78− will make adb not complain about multiple devices
102+ will make adb not complain about multiple devices
79- you can export TARGET_IP=$your_device_ip TARGET_SSH_PORT=22 for run_on_device
103- you can export TARGET_IP=$your_device_ip TARGET_SSH_PORT=22 for run_on_device
80 to not use adb forwarding - useful if you use multiple devices
104 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)
82 build times (especially in the nothing-to-build case)
107 build times (especially in the nothing-to-build case)
@@ -90,4 +115,6 @@ https://launchpad.net/canonical-client-development-guidelines
91Development Environment
116Development Environment
92=======================
117=======================
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