Add plugin for system tray icons

[cbenhagen]

This is related to the menu plugin.

Needed not so obvious functionality:

• Position of the icon
• Setting icon as monochromatic template image is needed on macOS so it can support dark mode
• Allow text instead of the icon or in addition to the icon. I don't know if this is possible on Linux or Windows but macOS allows this.

@stuartmorgan should I create this issue in the flutter repo or is this the best place for it?

[stuartmorgan-g]

It's not clear to me how this is related to the menu plugin; the system tray and the application menu (if any) are entirely separate as far as I know. I'm also confused by the reference to macOS as there's no such thing as a system tray. Are you talking about changing the dock icon?

It would be helpful if you could clearly describe the functionality you want to be able to implement on each platform, perhaps with some representative screenshots (e.g., from other apps doing what you would like to do) for each platform.

[cbenhagen]

I guess macOS calls it the status menu. Such a plugin would add the icon. The menu plugin most likely would show the menu when you click the icon as it is the OS which provides the menu (at least on macOS). Here is an example on macOS:

Having the position of the icon would allow for custom menu windows to be displayed like so:

[stuartmorgan-g]

I guess macOS calls it the status menu

Apple fairly strongly discourages the use of the status menu, so I don't think that belongs in the core framework; see this description of the cases where plugins are currently hosted here.

A plugin to add a macOS status menu item seems like a good candidate for a community plugin rather than something temporarily hosted here. Is there a reason you think this needs to be part of the framework?

Having the position of the icon would allow for custom menu windows to be displayed like so:

Showing a custom window containing Flutter content isn't possible until multiple windows are supported (unless the app is only a status menu item, but that would require a very different runner template).

[cbenhagen]

In any desktop framework I have worked with so far this was part of the framework so I hoped to help adding this to my favorite one as well. Can you point me to where Apple discourages the use of the status menu? What about Microsoft and the KDE / GNOME projects?

Most system tray apps I know do only have that menu and maybe a settings window. So having only one window is not that much of a restriction. Being able to open more than one will definitely be appreciated on any Flutter Desktop app though.

[cbenhagen]

All I can find in Apples Human Interface Guidelines is this:
https://developer.apple.com/design/human-interface-guidelines/macos/extensions/menu-bar-extras

Some of Apples own tools like the Time Machine use the icon in the status menu plus a window as their main user interface. Also Apps like Dropbox make heavy use of the status menu.

[cbenhagen]

Also checking https://developer.apple.com/documentation/appkit/nsstatusitem does not look as its use is deprecated or discouraged in any way.

[stuartmorgan-g]

Can you point me to where Apple discourages the use of the status menu?

The Overview section of https://developer.apple.com/documentation/appkit/nsstatusbar, which is the API for it.

What about Microsoft and the KDE / GNOME projects?

I'm not sure; that would need more research. However, my limited experience suggests that most apps don't need to put things in the system tray; pointers to contrary information are welcome.

Some of Apples own tools like the Time Machine use the icon in the status menu plus a window as their main user interface. Also Apps like Dropbox make heavy use of the status menu.

I'm aware that applications that use the status menu exist. My question isn't "why should it be theoretically possible to add a status menu item?" but "why should this be a core part of the framework rather than a plugin?"

[stuartmorgan-g]

Also checking https://developer.apple.com/documentation/appkit/nsstatusitem does not look as its use is deprecated or discouraged in any way.

I don't know how to read:

Use status items sparingly and only if the alternatives (such as a Dock menu, preference pane, or status window) are not suitable.

other than as discouraging their use.

[cbenhagen]

That it should only be used if other options are not suitable implies that there are moments when its use is a perfectly valid option. But as we both agree that it should be possible to use them the only question remaining is if it should be part of the framework or not. I don't know what should be the criteria for that. Out of all the apps I wrote in the past years most use the system tray. But that is hardly an argument. All I can say is that to me it feels like it should be part of the framework and that it is in most of the ones I know. Feel free to close the issue if you think it should under no circumstances be part of the framework.

[ChaseLewis]

A large number of applications now for PC's run just in the background like Dropbox, VPN Clients, Alarm apps, slack, discord, applications that manage USB devices, etc.

Not supporting the system tray is basically discouraging all applications that do these operations and probably many more, as it would not support the basic required functionality for any of them. It is not a major exaggeration to say MOST applications have this requirement. Would seem short sighted to not include this. To be honest when looking at different cross platform solutions this has typically been my #1 requirement and unfortunately why I often have had to choose electron apps or we choose to release on only 1 platform for our projects.

So just seconding support for this feature.

[stuartmorgan-g]

It would be helpful if people requesting support for this could be clear about what platform(s) they are talking about. For instance, I'm running both Slack and Discord on macOS right now and neither of them are NSStatusItems. I currently have only one non-system app running that is a status item, and as someone whose primary background is macOS development I feel confident saying that it is definitely not the case that most macOS applications require status items.

There may well be substantial variation in expectations across platforms here though, and I'm much less familiar with Windows and Linux conventions.

Not supporting the system tray

Not having it bundled as part of the framework is not the same as "not supporting". Consider geolocation on mobile, for instance; I would expect that many mobile developers would claim that most mobile applications need it, but it's a third-party plugin in Flutter. If there were things preventing a plugin from implementing status bar support I would consider that a significant API issue.

[joeblew99]

so sounds like a community plugin is the way to go.

Anyone know if there is an awesome flutter desktop plugins list anywhere ?

[lesnitsky]

check out https://github.com/lesnitsky/flutter_desktop_plugins I have some plans about building tray related plugin, but not sure about timeline (depends on project requirements I'm working on)

…

On Wed, Oct 30, 2019, 1:49 PM jow blew ***@***.***> wrote: so sounds like a community plugin is the way to go. Anyone know if there is an awesome flutter desktop plugins list anywhere ? — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub <#595?email_source=notifications&email_token=ABPYUNRRMUZGPCQDGJFYQKTQRFRBZA5CNFSM4JCLK6W2YY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOECTWPWQ#issuecomment-547842010>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ABPYUNRPOOR6S372V6M7T7TQRFRBZANCNFSM4JCLK6WQ> .

[winwisely99]

wow nice set of plugins @lesnitsky :)

It would be good if a wiki could listen then to show others the way ? @stuartmorgan