Mir
4010
Comment:
|
4484
|
Deletions are marked like this. | Additions are marked like this. |
Line 1: | Line 1: |
## page was copied from Process/Merges/TestPlans/Template ## page was renamed from Process/Merges/TestPlans/Common ## page was renamed from Process/TestPlans/Common |
|
Line 6: | Line 2: |
* '''Component Checklist''': https://wiki.ubuntu.com/Process/Merges/Checklists/Mir * '''Trunk URL''': [[https://launchpad.net/mir/ubuntu|lp:mir/ubuntu]] (note: mir has release branches, for example [[https://launchpad.net/mir/0.26|lp:mir/0.26]]) * '''Ubuntu Package URL (LP)''': http://launchpad.net/ubuntu/+source/mir == Dependents/Clients == Clients of this component * '''MirAL''' https://code.launchpad.net/miral * '''qtubuntu''' https://launchpad.net/qtubuntu * '''Xmir''' https://code.launchpad.net/~xmir-team/xorg-server/+git/xmir * '''SDL''' * '''GTK-3''' |
* '''Trunk URL''': [[https://github.com/MirServer/mir/|github:MirServer/mir]] * '''Ubuntu Package URL (LP)''': http://launchpad.net/ubuntu/+source/mir |
Line 23: | Line 7: |
'''This test plan is not supposed to be complete; use it to guide your manual testing so they don't miss big functional areas that are part in the component; also this should be used as guideline to inspire the exploratory testing which should be adapted smartly based on the real content of a release''' |
|
Line 24: | Line 10: |
* Verify that the mir-tests-tools snap works == Testing mir-test-tools == These tests should work on all supported series of Classic and on Ubuntu Core. First check that the `candidate` channel has been updated with the release candidate: * $ '''snap info mir-test-tools''' This should show something like: * '''beta: 1.2.0-snap45 2019-05-22 (415) 121MB -''' Where the version number matches the release being tested. * $ '''snap install --beta mir-test-tools''' There's a "handy script" to test the snap on the Wiki: * https://github.com/MirServer/mir-test-tools/wiki/Notes Copy this and run it. === Test Plan 20.04LTS or later === ==== Test Matrix ==== ||'''Platform'''||24.04LTS||22.04LTS||24.10|| ||gbm-kms|| || || || ||gbm-x11|| || || || ||gbm-wayland|| || || || ||eglstream-kms|| || || || ||virtual|| || || || ||'''Console'''||24.04LTS||22.04LTS||24.10|| ||minimal|| || || || ||linux-VT|| || || || ||logind|| || || || ||'''WM'''||24.04LTS||22.04LTS||24.10|| ||floating|| || || || ||tiling|| || || || ||kiosk|| || || || |
|
Line 26: | Line 53: |
* Install packages from build silo: * $ sudo apt install mir-demos mir-graphics-drivers-desktop |
* Install packages from the [[https://launchpad.net/~mir-team/+archive/ubuntu/rc|release candidate PPA]]: * $ '''sudo add-apt-repository --update ppa:mir-team/rc''' * $ '''sudo apt install mir-demos mir-platform-graphics-virtual mir-graphics-drivers-desktop mir-test-tools''' * Install applications to test with: * Qt Wayland support, qterminal and kate to test with: * $ '''sudo apt install qtwayland5 kate qterminal''' * Install weston-terminal: * $ '''sudo apt install weston''' * Install glmark2: * $ '''sudo apt install glmark2-wayland''' |
Line 29: | Line 64: |
* Mir-on-X * Use an X11 based desktop (Unity, Gnome, etc.). These tests run for a default 10 seconds, * Start a terminal sessions to launch the tests. * Test that S/W rendering clients run and can be moved(resized) with Alt+Left(Middle)-Button: * $ '''mir_demo_server --test-timeout 10 --test-client mir_demo_client_multiwin''' * Test that EGL rendering clients run and can be moved(resized) with Alt+Left(Middle)-Button: * $ '''mir_demo_server --test-timeout 10 --test-client mir_demo_client_egltriangle''' |
* Commands for testing specific features: * Console provider * `--console-provider=vt --vt=4` * This requires running with root privileges * Need to ensure that `XDG_RUNTIME_DIR` is set in the environment. If using `sudo`, it might strip this out; running something like `sudo env XDG_RUNTIME_DIR=/run/user/1000 miral-shell …` will ensure this is set. * `--console-provider=logind` * Switch to VT4, sign in and `miral-app ...` * `--console-provider=minimal` * Used when all others fail. * Does not provide VT switching capabilities (Ctrl-Alt-F1, etc) * Used for the gbm-x11, gbm-wayland & virtual platforms * Window Manager * `--window-manager=tiling` * `--window-manager=floating` * `-kiosk` * Testing specific platforms * `--platform-display-libs=mir:$NAME --platform-rendering-libs=mir:$NAME` * Platform * X11: Use an X11 supporting desktop * virtual: `--platform-display-lib=mir:virtual --virtual-output=1280x1024` * Also add wayvnc support: `--add-wayland-extension=zwp_virtual_keyboard_manager_v1:zwlr_virtual_pointer_manager_v1:zwlr_screencopy_manager_v1` * In a separate terminal run: `WAYLAND_DISPLAY=wayland-1 ubuntu-frame-vnc` * In a separate terminal run: `gvncviewer localhost` * wayland: `--platform-display-lib=mir:wayland --wayland-host=$WAYLAND_DISPLAY` * Some tests * Run the "smoke tests" to ensure the example clients work * Start a terminal sessions to launch the tests. * $ '''mir-smoke-test-runner''' * Check the result is "I: Smoke testing complete with returncode 0" * try some apps * $ '''miral-app''' * [in the nested session] Try running, resizing, moving and switching between the following: * $ '''kate''' * $ '''gnome-terminal''' * $ '''weston-terminal''' * $ '''glmark2-es2-wayland''' |
Line 37: | Line 101: |
* Mir-on-Mir * Use an X11 based desktop (Unity, Gnome, etc.). These tests run for a default 10 seconds. * Start two terminal sessions, one for a "host" server, one to launch the tests. * Start a "host" server: $ '''mir_demo_server --window-manager system-compositor''' * Test that S/W rendering clients run and can be moved(resized) with Alt+Left(Middle)-Button: * $ '''mir_demo_server --no-file --host $XDG_RUNTIME_DIR/mir_socket --test-timeout 10 --test-client mir_demo_client_multiwin''' * Test that EGL rendering clients run and can be moved(resized) with Alt+Left(Middle)-Button: * $ '''mir_demo_server --no-file --host $XDG_RUNTIME_DIR/mir_socket --test-timeout 10 --test-client mir_demo_client_egltriangle''' * Close the "host" server * Mir-on-KMS * go to a VT. These tests run for a default 10 seconds. * Test that S/W rendering clients run and can be moved(resized) with Alt+Left(Middle)-Button: * $ '''sudo mir_demo_server --no-file --test-timeout 10 --test-client mir_demo_client_multiwin''' * Test that EGL rendering clients run and can be moved(resized) with Alt+Left(Middle)-Button: * $ '''sudo mir_demo_server --no-file --test-timeout 10 --test-client mir_demo_client_egltriangle''' * Basic GDK support * Use an X11 based desktop (Unity, Gnome, etc.). Note that support by the demo server is limited: e.g. menus and popups need not appear in the correct place. * Start two terminal sessions, one for a Mir server, one to launch the tests. * Start a server: $ '''mir_demo_server''' * Test that gnome-terminal runs and can be moved(resized) with Alt+Left(Middle)-Button: * $ '''GDK_BACKEND=mir gnome-terminal --app-id com.canonical.mir.Terminal''' * Test that GDK applications can be run from the terminal: * $ '''gedit''' * Close the server * Install Xmir * go to a VT and launch mir_demo_server as root with the option --arw-file * launch Xmir in another VT using: Xmir -mirSocket /tmp/mir_socket -rootless :2 * in another VT: DISPLAY=:2 gedit * Switch to the mir VT * Interact with gedit, write a text document, save it, load another. * ''On zesty and later'' Install MirAL * Follow [[https://wiki.ubuntu.com/Process/Merges/TestPlans/MirAL|MirAL test plan]]. * ''On zesty only'' Install unity8-desktop-session * login to unity8 desktop and utilize applications such as browser, play with dash * allow screen to blank, wake up |
* Run a test "tiling desktop" session * $ '''miral-app --window-manager tiling''' * Try running, and switching between the following: * $ '''kate''' * $ '''gnome-terminal''' * $ '''weston-terminal''' * $ '''glmark2-es2-wayland''' |
Test plan for component: Mir
Trunk URL: github:MirServer/mir
Ubuntu Package URL (LP): http://launchpad.net/ubuntu/+source/mir
Test Plan
This test plan is not supposed to be complete; use it to guide your manual testing so they don't miss big functional areas that are part in the component; also this should be used as guideline to inspire the exploratory testing which should be adapted smartly based on the real content of a release
- Successful run of automated CI testing
- Verify that the mir-tests-tools snap works
Testing mir-test-tools
These tests should work on all supported series of Classic and on Ubuntu Core. First check that the candidate channel has been updated with the release candidate:
$ snap info mir-test-tools
This should show something like:
beta: 1.2.0-snap45 2019-05-22 (415) 121MB -
Where the version number matches the release being tested.
$ snap install --beta mir-test-tools
There's a "handy script" to test the snap on the Wiki:
Copy this and run it.
Test Plan 20.04LTS or later
Test Matrix
Platform |
24.04LTS |
22.04LTS |
24.10 |
gbm-kms |
|
|
|
gbm-x11 |
|
|
|
gbm-wayland |
|
|
|
eglstream-kms |
|
|
|
virtual |
|
|
|
Console |
24.04LTS |
22.04LTS |
24.10 |
minimal |
|
|
|
linux-VT |
|
|
|
logind |
|
|
|
WM |
24.04LTS |
22.04LTS |
24.10 |
floating |
|
|
|
tiling |
|
|
|
kiosk |
|
|
|
- In addition update desktop from archive
Install packages from the release candidate PPA:
$ sudo add-apt-repository --update ppa:mir-team/rc
$ sudo apt install mir-demos mir-platform-graphics-virtual mir-graphics-drivers-desktop mir-test-tools
- Install applications to test with:
- Qt Wayland support, qterminal and kate to test with:
$ sudo apt install qtwayland5 kate qterminal
- Install weston-terminal:
$ sudo apt install weston
- Install glmark2:
$ sudo apt install glmark2-wayland
- Qt Wayland support, qterminal and kate to test with:
- Commands for testing specific features:
- Console provider
--console-provider=vt --vt=4
- This requires running with root privileges
Need to ensure that XDG_RUNTIME_DIR is set in the environment. If using sudo, it might strip this out; running something like sudo env XDG_RUNTIME_DIR=/run/user/1000 miral-shell … will ensure this is set.
--console-provider=logind
Switch to VT4, sign in and miral-app ...
--console-provider=minimal
- Used when all others fail.
- Does not provide VT switching capabilities (Ctrl-Alt-F1, etc)
Used for the gbm-x11, gbm-wayland & virtual platforms
- Window Manager
--window-manager=tiling
--window-manager=floating
-kiosk
- Testing specific platforms
--platform-display-libs=mir:$NAME --platform-rendering-libs=mir:$NAME
- Platform
- X11: Use an X11 supporting desktop
virtual: --platform-display-lib=mir:virtual --virtual-output=1280x1024
Also add wayvnc support: --add-wayland-extension=zwp_virtual_keyboard_manager_v1:zwlr_virtual_pointer_manager_v1:zwlr_screencopy_manager_v1
In a separate terminal run: WAYLAND_DISPLAY=wayland-1 ubuntu-frame-vnc
In a separate terminal run: gvncviewer localhost
wayland: --platform-display-lib=mir:wayland --wayland-host=$WAYLAND_DISPLAY
- Platform
- Some tests
- Run the "smoke tests" to ensure the example clients work
- Start a terminal sessions to launch the tests.
$ mir-smoke-test-runner
- Check the result is "I: Smoke testing complete with returncode 0"
- try some apps
$ miral-app
- [in the nested session] Try running, resizing, moving and switching between the following:
$ kate
$ gnome-terminal
$ weston-terminal
$ glmark2-es2-wayland
- Run a test "tiling desktop" session
$ miral-app --window-manager tiling
- Try running, and switching between the following:
$ kate
$ gnome-terminal
$ weston-terminal
$ glmark2-es2-wayland
- Run the "smoke tests" to ensure the example clients work
- Console provider
Process/Merges/TestPlans/Mir (last edited 2024-05-09 13:09:10 by alan-griffiths)