@@ -1,34 +1,45 @@
11Building Unity 8
22================
33
4+Only Ubuntu 13.10 (saucy) is supported as a developement environment.
5+
46download source
57---------------
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)
10+
811 $ mkdir ~/unity
912
1013- fetch Unity 8 source
1114 $ sudo apt-get install bzr
12− $ bzr branch lp:unity/8.0 ~/unity/unity8
15+ $ bzr branch lp:unity8 ~/unity/unity8
1316 $ cd ~/unity/unity8
1417
15−build dependencies
16−------------------
17−If its your first time, download & build deps
18−$ ./build -s
18+install dependencies
19+--------------------
20+If its your first time, install build dependencies
21+
22+$ cd ~/unity/unity8
23+$ ./build --setup
24+
1925 this will:
20− - add the following ppa's
26+ - add the following PPA's
2127 - ppa:phablet-team/desktop-deps
2228 - ppa:canonical-qt5-edgers/qt5-proper
2329 - ppa:ubuntu-sdk-team
2430 - 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
2533
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
2735any failures associated with it, the build script will bail out of the setup
2836and fail to install all the required dependencies.
2937
38+
3039build Unity 8
3140-------------
41+
42+$ cd ~/unity/unity8
3243$ ./build
3344
3445You may also rebuild with the -c for clean, which just deletes the build
@@ -55,6 +66,12 @@ Notes
5566 put the *.mo files into correct structure. We'll look for a better solution
5667 later.
5768 $ 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
72+ this will:
73+ - Create an EDS address book
74+ - Populate the address book with sample data
5875
5976Running Unity 8 on devices
6077==========================
@@ -71,7 +88,7 @@ the device
7188on the device yourself)
7289
7390$ cd ~/unity/unity8
74−$ ./run_on_device -s
91+$ ./run_on_device --setup
7592 this will:
7693 - install your public SSH key on the device
7794 - add ppa:canonical-qt5-edgers/qt5-proper and ppa:phablet-team
@@ -118,3 +135,6 @@ Development Environment
118135QtCreator (available via the Software Center) is the best IDE to hack on
119136Unity 8.
120137
138+If using VIM, make sure you install some syntax highlighting for QML, like
139+https://github.com/peterhoeg/vim-qml
140+