12/16/2013

Home About Projects Get Involved Design Blog

Developing Unity 8
Contact Us
Unity

Developing Unity 8

Developing Unity 7

Common Components

Common Libraries

Type to search

Building Unity 8
Get started working on Unity 8 by getting the source code and setting up your build environment. Building and running Unity 8 requires that you be running Ubuntu 14.04 (trusty). Click here to get started.

Running Unity 8
Unity 8 can be run from your build environment without being installed system-wide. This is the recommended way of testing your changes. Click here to started.

Running on Devices
Unity 8 can also be run on supported devices, to fully utilize the multi-touch and mobile sensor functionality. Click here to started.

Developing Unity 8
Learn about the tools, libraries and guidelines for making your own contributions to the Unity interface. Click here to learn more.

Building Unity 8
Only Ubuntu 14.04 (trusty) is supported as a development environment.

Download source
create a parent folder to not pollute your setup. so that you can have different unity branches there (trunk, WIP etc) $ mkdir ~/unity8 fetch Unity 8 source $ sudo apt-get install bzr $ bzr branch lp:unity8 ~/unity8/trunk $ cd ~/unity8/trunk

Install dependencies
If its your first time, download & build deps $. / b u i l ds If its your first time, install build dependencies $ cd ~/unity8/trunk $ ./build setup this will: - install the required dependencies to build, as well as run on the desktop - it should also install unity-scope-home and unity-lens-application which are technically recommends, not strict dependencies

Build Unity 8
$ cd ~/unity8/trunk $ ./build You may also rebuild with the -c for clean, which just deletes the build directory.

Running Unity 8 on your desktop

Run the Unity 8 shell
$c d~ / u n i t y 8 / t r u n k $. / r u n Options can be passed to test the lock screen $ ./run -p OR -k -p is for pin lock, for which the default prompt answer is 1234 -k is for keylock passphrase, for which the default prompt answer is password

https://unity.ubuntu.com/getinvolved/development/unity8/

1/3

12/16/2013

Developing Unity 8

Notes
to navigate, utilize the mouse left button as you would your finger to get the translations work, currently you have to do make install to put the *.mo files into correct structure. Well look for a better solution later. $ cd builddir; make install if you wish to populate contacts $ 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 Unity 8 on devices

Ubuntu Touch builds are currently only available in 14.04 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 If you havent already or if youve just freshly flashed your device make sure you run phablet-network-setup which will allow package updates to the device Also make sure you have your SSH key in ~/.ssh/id_rsa.pub (or install one on the device yourself)
$c d~ / u n i t y 8 / t r u n k $. / r u n _ o n _ d e v i c es

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
$. / r u n _ o n _ d e v i c e

this will: rsync the code to the device Build on the device Replace the running shell Options can be passed to test the lock screen
$. / r u n _ o n _ d e v i c epO Rk

-p is for pin lock, for which the default prompt answer is 1234 -k is for keylock passphrase, for which the default prompt answer is password

Notes
using adb over TCP has some advantages, Google will be of help here NOTE: this is not yet available for flipped images TL;DR: `adb tcpip 5555; adb connect $your_device_ip` you can persist the above via `adb shell setprop persist.adb.tcp.port 5555` its unsafe anyone can connect to your device with TCP the Nexus 10 doesnt drop the adb connection when locking the screen exporting ANDROID_SERIAL=$your_device_serial or ANDROID_SERIAL=$your_device_ip:5555 will make adb not complain about multiple devices you can export TARGET_IP=$your_device_ip TARGET_SSH_PORT=22 for run_on_device to not use adb forwarding useful if you use multiple devices using Ninja (package ninja-build run_on_device -s installs this now) will improve build times (especially in the nothing-to-build case)

https://unity.ubuntu.com/getinvolved/development/unity8/

2/3

12/16/2013

Developing Unity 8

Developing Unity 8
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 Unity 8. If using VIM, make sure you install some syntax highlighting for QML, like https://github.com/peterhoeg/vim-qml

This site is about the Unity the desk top shell and is not related to Unity Linux or the Unity Game Dev elopment Env ironment. Find us on Google+ Powered by WordPress. Built on the Thematic Theme Framework .

https://unity.ubuntu.com/getinvolved/development/unity8/

3/3