feature: providing a minimal launcher written in flutter for ubuntu frame

mattkae commented 3 months ago

What's new?

Frame can now optionally support the launcher, which is a minimal dock allowing the user to switch between fullscreen application

Documentation

Ubuntu Frame's launcher daemon provides users with a way to navigate between multiple applications running on a single frame instance.

Enablement

To enable the launcher, run:

snap set ubuntu-frame launcher=true

Behavior

The following specifies the behavior that you can of the launcher daemon:

When frame starts, the launcher will appear in the left-hand side of the screen with a black background
As window are opened, the launcher will display an icon that corresponds with the application for that window
- Icons will ONLY be displayed for applications that are packaged as snaps. The desktop files for these applications are found in the /var/lib/snapd/desktop directory.
When an icon is clicked, the corresponding window will be brought into focus
If a window is closed, then the icon will be removed from the launcher
If we cannot resolve an icon for a window, then the launcher will attempt to use the application-x-executable icon. If that fails, then the icon will be missing entirely.

Saviq commented 3 months ago

@mattkae can you please draft a documentation page for this? Particularly on what are the requirements for an icon to show up.

Just pop it in here and we'll copy to Discourse Docs when ready (or just publish on DD already with a "Work in progress" note).

mattkae commented 3 months ago

Oh and you'll need this to please the review tools:

https://github.com/canonical/ubuntu-frame/actions/runs/9646782833/job/26604055393?pr=191 I am still seeing an error. Did I do it right? Just populated snap/local/plugs.json with:

{
  "desktop-launch": {
    "allow-installation": "true"
  }
}

Saviq commented 3 months ago

Please add copyright headers to the new files, too

mattkae commented 3 months ago

@Saviq: I just have the remaining question here about CI being broken. Documentation is in the description.

Saviq commented 3 months ago

Hmm Send button failed. We need the store ACK for this to pass now.

Saviq commented 3 months ago

@mattkae we'll need to disable this for armhf, since Flutter doesn't support it.

See https://github.com/canonical/mir-test-tools/blob/7e593d47308ed20608d634b8b2525bb1df12bc2a/snap/snapcraft.yaml#L211-L229 for reference

mattkae commented 3 months ago

@Saviq Do you know what CI is angry about?

remote: Create a merge proposal for 'main' on Launchpad by visiting:
remote:       https://code.launchpad.net/~mir-ci-bot/mir-ci-bot-craft-remote-build/+git/snapcraft-ubuntu-frame-92e4eac9d32b978bbdb01c7959f0fcb9/+ref/main/+register-merge

Saviq commented 3 months ago

@Saviq Do you know what CI is angry about?

It just timed out, looks like LP went on hiatus.

The "merge proposal" message is always there, just INFO when pushing to Launchpad git.

Saviq commented 2 months ago

@AlanGriffiths since I was all over this, would you please have a look here, disregarding the launcher/ folder - just the snap stuff?

canonical / ubuntu-frame