Mir
|
The best place to ask questions and discuss about the Mir project is the #ubuntu-mir IRC channel on freenode.
The Mir project is hosted on Launchpad: https://launchpad.net/mir
These instructions assume that you’re using Ubuntu 16.04LTS or later, I’ve not earlier Ubuntu versions or other distributions.
You’ll need a few development and utility packages installed, along with the Mir graphics drivers:
$ sudo apt install devscripts equivs bzr $ sudo apt install mir-graphics-drivers-desktop
If you’re working on a phone or tablet use mir-graphics-drivers-android in place of mir-graphics-drivers-desktop. (See Building the Mir source for ARM for more on this.)
With these installed you can checkout and build Mir:
$ bzr branch lp:mir $ sudo mk-build-deps -i $ mkdir mir/build $ cd mir/build $ cmake .. $ make
This creates an example shell (miral-shell) in the bin directory. This can be run directly:
$ bin/miral-shell
With the default options this runs in a window on X (which is convenient for development).
The miral-shell example is simple, don’t expect to see a sophisticated launcher by default. You can start mir apps from the command-line. For example:
$ bin/miral-run gnome-terminal
That’s right, a lot of standard GTK+ applications will “just work” (the GDK toolkit has a Mir backend). Any that assume the existence of an X11 and bypass the toolkit my making X11 protocol calls will have problems though.
To exit from miral-shell press Ctrl-Alt-BkSp.
You can install the Mir examples, headers and libraries you've built with:
$ sudo make install
Especially if you want to debug the shell without locking your system this might be a helpful setup:
Currently, the Mir code activity is performed on a development branch: lp:~mir-team/mir/development-branch
This development branch is promoted to the branch used for the ubuntu archive and touch images. Please submit any merge proposals against the development branch.
Please file bug reports at: https://bugs.launchpad.net/mir
The Mir development mailing list can be found at: https://lists.ubuntu.com/mailman/listinfo/Mir-devel
The Mir coding guidelines are here.
The Mesa packages shipped with Ubuntu are already built with the relevant Mir patches and should work out of the box with Mir.
For GL accelerated clients to use Mir they need to use a patched version of Mesa that supports Mir.
The patch is hosted on GitHub:
$ git clone https://github.com/RAOF/mesa.git
Compile as per normal instructions and pass –with-egl-platforms="mir,drm" to the configure options. You will need libmirclient installed as shown above.
Copyright © 2012-2017
Canonical Ltd.
Generated on Wed Oct 11 15:14:10 UTC 2017