Ubuntu Wiki

Below are the test cases that should be run when gnome-remote-desktop is updated to new major releases in the development version of Ubuntu. These should also be run for any gnome-remote-desktop Stable Release Update.

If the fdk-aac MIR is approved, the new Audio Forwarding test case should be run for any new major releases of fdk-aac or Stable Release Update of fdk-aac.

Basic RDP Test Case

1. Install all updates. Log out and log back in.
2. Open the Settings app to the Sharing page. Turn on Sharing and turn on Remote Desktop Sharing.
3. From a second computer, open Remmina.

The Remote Desktop page on the first computer provides the username and password to use. It also shows the computer name. If you want to use your IP address instead, you can find it in the Settings app > Wifi > gear button. If you are connected via Ethernet, use the Network page instead of the Wifi page.

4. Change the protocol to RDP in the address bar. Fill in the first computer's name or IP address and press Enter.
5. On the next screen, fill in your username and password. On the first computer you can click the Show Text button to see the password. (A password is automatically assigned but it can be changed.)
6. Ensure that the connection works.

Basic VNC Test Case

1. Do the Basic RDP Test Case but this time also enable the Legacy VNC option on the Remote Desktop Sharing page.
2. In Remmina, change the protocol to VNC, fill in the first computer's name or IP address and press Enter.
3. Ensure that the connection works.

Note: The VNC feature will likely be removed from Ubuntu 22.10 so this test case is only for Ubuntu 22.04 LTS

New Audio Forwarding Feature

A new audio forwarding feature was added to gnome-remote-desktop 43. This feature has not been enabled in Ubuntu yet so this test case is not required yet. The Main Inclusion bug is https://launchpad.net/bugs/1977614

Prerequisites

1. From the gnome-remote-desktop 43 packaging, remove -Dfdk_aac=false from debian/rules
2. In debian/control and debian/control.in, uncomment libfdk-aac-dev from the list of Build-Depends
3. Build the package. Note that fdk-aac is currently in multiverse so you might need to manually enable that in your build environment.
4. Install your updated gnome-remote-desktop package

Audio Forwarding Test Case

1. Install all updates. Log out and log back in.
2. Open the Settings app to the Sharing page. Turn on Sharing and turn on Remote Desktop Sharing.
3. From a second computer running Windows 10 or Windows 11, open the Remote Desktop Connection app.
4. Enter your first computer's name or IP Address in the Computer field and click Connect
5. It may take several moments for the next screen to load.
6. On the "Enter your credentials screen", click "More Choices". Then click "Use a different account"
7. Enter the username and password
8. You may be prompted to accept the security certificate with a warning that the identify of the remote computer cannot be verified. Click Yes to proceed.
9. You should be able to view the remote desktop now.
10. Open an audio file. Play the file. You should hear the audio on both computers.
11. The volume controls are linked between the 2 computers. If you mute the first computer, the remote audio on the second computer will also be muted. If you lower the volume on the first computer, the remote audio on the second computer will also be lowered.
12. Currently, this feature isn't supported in Remmina. More investigation is needed. One suggestion was that it might require freerdp to be built against ffmpeg. But ffmpeg is in universe. Alternatively, it may be possible to get this feature working with the Remmina snap. Meanwhile, this test case uses Windows as the client connection.

What Could Go Wrong

RDP Sharing is a new feature for Ubuntu 22.04 LTS as part of GNOME 42. (Previously only VNC Sharing was offered.)

RDP Sharing can be used for providing remote support so it's important that this feature works well because it may be difficult for the remote admin to fix issues in person.

gnome-remote-desktop is part of GNOME Core and falls under the GNOME Stable Release Update microrelease exception.