@@ -1,34 +1,45 @@
1Building Unity 8
1Building Unity 8
2================
2================
4+Only Ubuntu 13.10 (saucy) is supported as a developement environment.
4download source
6download source
5---------------
7---------------
6−- the build requires some additional dependencies, so create the parent
7−folder to not pollute your setup
8+- create a parent folder to not pollute your setup. so that you can have different unity
9+ branches there (trunk, WIP etc)
8 $ mkdir ~/unity
11 $ mkdir ~/unity
10- fetch Unity 8 source
13- fetch Unity 8 source
11 $ sudo apt-get install bzr
14 $ sudo apt-get install bzr
12− $ bzr branch lp:unity/8.0 ~/unity/unity8
15+ $ bzr branch lp:unity8 ~/unity/unity8
13 $ cd ~/unity/unity8
16 $ cd ~/unity/unity8
15−build dependencies
18+install dependencies
16−------------------
19+--------------------
17−If its your first time, download & build deps
20+If its your first time, install build dependencies
18−$ ./build -s
23+$ ./build --setup
19 this will:
25 this will:
20− - add the following ppa's
26+ - add the following PPA's
21 - ppa:phablet-team/desktop-deps
27 - ppa:phablet-team/desktop-deps
22 - ppa:canonical-qt5-edgers/qt5-proper
28 - ppa:canonical-qt5-edgers/qt5-proper
23 - ppa:ubuntu-sdk-team
29 - ppa:ubuntu-sdk-team
24 - install the required dependencies to build, as well as run on the desktop
30 - install the required dependencies to build, as well as run on the desktop
31+ - it should also install unity-scope-home and unity-lens-application which
32+ are technically "recommends", not strict dependencies
26−Note, once the ppa's are added a apt-get update will be run, if you have
34+Note, once the PPA's are added, the script runs apt-get update, if you have
27any failures associated with it, the build script will bail out of the setup
35any failures associated with it, the build script will bail out of the setup
28and fail to install all the required dependencies.
36and fail to install all the required dependencies.
30build Unity 8
39build Unity 8
31-------------
40-------------
34You may also rebuild with the -c for clean, which just deletes the build
45You may also rebuild with the -c for clean, which just deletes the build
@@ -55,6 +66,12 @@ Notes
55 put the *.mo files into correct structure. We'll look for a better solution
66 put the *.mo files into correct structure. We'll look for a better solution
57 $ cd builddir; make install
68 $ cd builddir; make install
69+- if you wish to populate contacts
70+ $ sudo apt-get install gir1.2-ebook-1.2
71+ $ manage-address-book.py create
73+ - Create an EDS address book
74+ - Populate the address book with sample data
59Running Unity 8 on devices
76Running Unity 8 on devices
60==========================
77==========================
@@ -71,7 +88,7 @@ the device
71on the device yourself)
88on the device yourself)
73$ cd ~/unity/unity8
90$ cd ~/unity/unity8
74−$ ./run_on_device -s
91+$ ./run_on_device --setup
75 this will:
92 this will:
76 - install your public SSH key on the device
93 - install your public SSH key on the device
77 - add ppa:canonical-qt5-edgers/qt5-proper and ppa:phablet-team
94 - add ppa:canonical-qt5-edgers/qt5-proper and ppa:phablet-team
@@ -118,3 +135,6 @@ Development Environment
118QtCreator (available via the Software Center) is the best IDE to hack on
135QtCreator (available via the Software Center) is the best IDE to hack on
138+If using VIM, make sure you install some syntax highlighting for QML, like
139+https://github.com/peterhoeg/vim-qml