~alan-griffiths/mir/fix-1654023

« back to all changes in this revision

Viewing changes to doc/using_mir_on_android.md

  • Committer: Daniel van Vugt
  • Date: 2015-04-28 07:54:10 UTC
  • mfrom: (2517 development-branch)
  • mto: This revision was merged to the branch mainline in revision 2673.
  • Revision ID: daniel.van.vugt@canonical.com-20150428075410-rwskshfuar7voesp
Merge latest trunk and fix conflicts.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
Using Mir on an Android device {#using_mir_on_android}
2
2
==============================
3
3
 
4
 
After installing mir on your device (see \ref installing_prebuilt_on_android)
5
 
switch off SurfaceFlinger (see: https://wiki.ubuntu.com/Touch/Testing/Mir#Switch_from_SurfaceFlinger_to_Mir).
6
 
(Alternatively, you can install a mir based image as described here: https://wiki.ubuntu.com/Touch/Testing/Mir#Easiest_way)
7
 
 
8
 
Open a shell on the device:
9
 
 
10
 
    $ adb shell
11
 
 
12
 
Now, start Mir and a client application:
13
 
 
14
 
    # mir_demo_server &
15
 
    # mir_demo_client_something   # take your pick of something
16
 
 
17
 
Getting some example client applications
18
 
----------------------------------------
19
 
 
20
 
You can get some example programs by installing the `mir-demos` package
21
 
inside the Ubuntu touch chroot shell (see above):
22
 
 
23
 
    # apt-get install mir-demos
 
4
Mir is the default on Ubuntu Touch images, so if you're using Ubuntu Touch,
 
5
you're already using mir.
 
6
 
 
7
If you would like to run a pre-release version of mir on your device, you'll
 
8
need to recompile our downstream dependencies (unity-system-compositor and 
 
9
qtmir) to ensure ABI compatibility with the pre-release version of mir.
 
10
 
 
11
Using some demo applications
 
12
----------------------------
 
13
 
 
14
Simpler demos are available in the `mir-demos` package.
 
15
 
 
16
First install the demos:
 
17
 
 
18
    $ apt-get install mir-demos
 
19
 
 
20
Next unsure that the Unity8 session is ended:
 
21
 
 
22
    $ service lightdm stop
 
23
 
 
24
Finally, start mir and a client application:
 
25
 
 
26
    $ mir_demo_server --test-client mir_demo_client_egltriangle
 
27
 
 
28
and you should see a triangle on screen.