feat(app): add system tray functionality

- Update pubspec.yaml with tray_manager dependency. - Initialize system tray in app.dart and handle menu item clicks.
ubuntu-flutter-community · Aug 21, 2024 · 1c84971 · 1c84971
1 parent 3a4730c
commit 1c84971
Show file tree

Hide file tree

Showing 24 changed files with 503 additions and 35 deletions.
diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml
@@ -49,6 +49,6 @@ jobs:
           channel: 'stable'
           flutter-version: ${{env.FLUTTER_VERSION}}
       - run: sudo apt update
-      - run: sudo apt install -y clang cmake curl libgtk-3-dev ninja-build pkg-config unzip libunwind-dev libmpv-dev
+      - run: sudo apt install -y clang cmake curl libgtk-3-dev ninja-build pkg-config unzip libunwind-dev libmpv-dev libappindicator3-1 libappindicator3-dev
       - run: flutter pub get
       - run: flutter build linux -v
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -96,7 +96,7 @@ jobs:
   #         channel: 'stable'
   #         flutter-version: ${{env.FLUTTER_VERSION}}
   #     - run: sudo apt update
-  #     - run: sudo apt install -y clang cmake curl libgtk-3-dev ninja-build pkg-config unzip libunwind-dev libmpv-dev
+  #     - run: sudo apt install -y clang cmake curl libgtk-3-dev ninja-build pkg-config unzip libunwind-dev libmpv-dev libappindicator3-1 libappindicator3-dev
   #     - run: flutter pub get
 
   #     - uses: snapcore/action-build@v1

diff --git a/assets/images/tray_icon.ico b/assets/images/tray_icon.ico
diff --git a/assets/images/tray_icon.png b/assets/images/tray_icon.png
diff --git a/lib/app/view/app.dart b/lib/app/view/app.dart
@@ -4,6 +4,7 @@ import 'package:flutter/material.dart';
 import 'package:phoenix_theme/phoenix_theme.dart' hide ColorX, isMobile;
 import 'package:system_theme/system_theme.dart';
 import 'package:watch_it/watch_it.dart';
+import 'package:window_manager/window_manager.dart';
 import 'package:yaru/yaru.dart';
 
 import '../../common/view/icons.dart';
@@ -14,6 +15,7 @@ import '../../library/library_model.dart';
 import '../../settings/settings_model.dart';
 import 'scaffold.dart';
 import 'splash_screen.dart';
+import 'system_tray.dart';
 
 class YaruMusicPodApp extends StatelessWidget {
   const YaruMusicPodApp({
@@ -105,7 +107,7 @@ class _MusicPodApp extends StatefulWidget with WatchItStatefulWidgetMixin {
   State<_MusicPodApp> createState() => _MusicPodAppState();
 }
 
-class _MusicPodAppState extends State<_MusicPodApp> {
+class _MusicPodAppState extends State<_MusicPodApp> with WindowListener {
   late Future<bool> _initFuture;
 
   @override
@@ -118,9 +120,25 @@ class _MusicPodAppState extends State<_MusicPodApp> {
     await di<LibraryModel>().init();
     if (!mounted) return false;
     di<ExternalPathService>().init();
+    di<SystemTray>().updateTrayMenuItems(context);
+    windowManager.addListener(this);
     return true;
   }
 
+  @override
+  void dispose() {
+    windowManager.removeListener(this);
+    super.dispose();
+  }
+
+  @override
+  void onWindowEvent(String eventName) {
+    if ('show' == eventName || 'hide' == eventName) {
+      di<SystemTray>().updateTrayMenuItems(context);
+    }
+    super.onWindowEvent(eventName);
+  }
+
   @override
   Widget build(BuildContext context) {
     final themeIndex = watchPropertyValue((SettingsModel m) => m.themeIndex);

diff --git a/lib/app/view/system_tray.dart b/lib/app/view/system_tray.dart
@@ -0,0 +1,62 @@
+import 'dart:io';
+
+import 'package:flutter/material.dart';
+import 'package:tray_manager/tray_manager.dart';
+import 'package:window_manager/window_manager.dart';
+
+String trayIcon() {
+  if (Platform.isWindows) {
+    return 'assets/images/tray_icon.ico';
+  } else {
+    return 'assets/images/tray_icon.png';
+  }
+}
+
+class SystemTray with TrayListener {
+  late List<MenuItem> trayMenuItems;
+
+  Future<void> init() async {
+    trayManager.addListener(this);
+    await trayManager.setIcon(trayIcon());
+  }
+
+  Future<void> dispose() async {
+    trayManager.removeListener(this);
+  }
+
+  Future<void> updateTrayMenuItems(
+    BuildContext context,
+  ) async {
+    bool isVisible = await windowManager.isVisible();
+
+    trayMenuItems = [
+      MenuItem(
+        key: 'show_hide_window',
+        label: isVisible ? 'Hide Window' : 'Show Window',
+      ),
+      MenuItem.separator(),
+      MenuItem(
+        key: 'close_application',
+        label: 'Close Application',
+      ),
+    ];
+
+    await trayManager.setContextMenu(Menu(items: trayMenuItems));
+  }
+
+  @override
+  void onTrayMenuItemClick(MenuItem menuItem) {
+    switch (menuItem.key) {
+      case 'show_hide_window':
+        windowManager.isVisible().then((value) {
+          if (value) {
+            windowManager.hide();
+          } else {
+            windowManager.show();
+          }
+        });
+      case 'close_application':
+        windowManager.close();
+    }
+  }
+}
diff --git a/lib/common/data/close_btn_action.dart b/lib/common/data/close_btn_action.dart
@@ -0,0 +1,16 @@
+import '../../l10n/l10n.dart';
+
+enum CloseBtnAction {
+  alwaysAsk,
+  hideToTray,
+  close;
+
+  @override
+  String toString() => name;
+
+  String localize(AppLocalizations l10n) => switch (this) {
+        alwaysAsk => l10n.alwaysAsk,
+        hideToTray => l10n.hideToTray,
+        close => l10n.closeApp,
+      };
+}
diff --git a/lib/common/view/header_bar.dart b/lib/common/view/header_bar.dart
@@ -2,7 +2,10 @@ import 'dart:io';
 
 import '../../app/app_model.dart';
 import '../../extensions/build_context_x.dart';
+import '../../l10n/l10n.dart';
 import '../../library/library_model.dart';
+import '../../settings/settings_model.dart';
+import '../data/close_btn_action.dart';
 import 'global_keys.dart';
 import 'icons.dart';
 import 'nav_back_button.dart';
@@ -11,6 +14,8 @@ import 'package:phoenix_theme/phoenix_theme.dart' hide isMobile;
 import 'package:watch_it/watch_it.dart';
 import 'package:yaru/yaru.dart';
 
+import 'theme.dart';
+
 class HeaderBar extends StatelessWidget
     with WatchItMixin
     implements PreferredSizeWidget {
@@ -40,6 +45,8 @@ class HeaderBar extends StatelessWidget
   @override
   Widget build(BuildContext context) {
     final canPop = watchPropertyValue((LibraryModel m) => m.canPop);
+    final closeBtnAction =
+        watchPropertyValue((SettingsModel m) => m.closeBtnActionIndex);
 
     Widget? leading;
 
@@ -89,6 +96,21 @@ class HeaderBar extends StatelessWidget
       backgroundColor: backgroundColor ?? context.theme.scaffoldBackgroundColor,
       style: theStyle,
       foregroundColor: foregroundColor,
+      onClose: (context) {
+        switch (closeBtnAction) {
+          case CloseBtnAction.alwaysAsk:
+            showDialog(
+              context: context,
+              builder: (context) {
+                return const CloseWindowActionConfirmDialog();
+              },
+            );
+          case CloseBtnAction.hideToTray:
+            YaruWindow.hide(context);
+          case CloseBtnAction.close:
+            YaruWindow.close(context);
+        }
+      },
     );
   }
 
@@ -101,6 +123,77 @@ class HeaderBar extends StatelessWidget
       );
 }
 
+class CloseWindowActionConfirmDialog extends StatefulWidget {
+  const CloseWindowActionConfirmDialog({super.key});
+
+  @override
+  State<CloseWindowActionConfirmDialog> createState() =>
+      _CloseWindowActionConfirmDialogState();
+}
+
+class _CloseWindowActionConfirmDialogState
+    extends State<CloseWindowActionConfirmDialog> {
+  bool rememberChoice = false;
+  @override
+  Widget build(BuildContext context) {
+    final model = di<SettingsModel>();
+    return AlertDialog(
+      title: yaruStyled
+          ? YaruDialogTitleBar(
+              backgroundColor: Colors.transparent,
+              title: Text(context.l10n.closeMusicPod),
+            )
+          : null,
+      titlePadding: yaruStyled ? EdgeInsets.zero : null,
+      content: Column(
+        mainAxisSize: MainAxisSize.min,
+        children: [
+          const Icon(
+            Icons.error,
+            color: Colors.red,
+            size: 50,
+          ),
+          const SizedBox(height: 12),
+          Text(
+            context.l10n.confirmCloseOrHideTip,
+          ),
+          CheckboxListTile(
+            title: Text(context.l10n.doNotAskAgain),
+            value: rememberChoice,
+            onChanged: (value) {
+              setState(() {
+                rememberChoice = value!;
+              });
+            },
+          ),
+        ],
+      ),
+      actions: [
+        TextButton(
+          onPressed: () {
+            if (rememberChoice) {
+              model.setCloseBtnActionIndex(CloseBtnAction.hideToTray);
+            }
+            Navigator.of(context).pop();
+            YaruWindow.hide(context);
+          },
+          child: Text(context.l10n.hideToTray),
+        ),
+        TextButton(
+          onPressed: () {
+            if (rememberChoice) {
+              model.setCloseBtnActionIndex(CloseBtnAction.close);
+            }
+            Navigator.of(context).pop();
+            YaruWindow.close(context);
+          },
+          child: Text(context.l10n.closeApp),
+        ),
+      ],
+    );
+  }
+}
+
 class SidebarButton extends StatelessWidget {
   const SidebarButton({super.key});
 

diff --git a/lib/constants.dart b/lib/constants.dart
@@ -161,6 +161,7 @@ const kFavCountryCodes = 'favCountryCodes';
 const kFavLanguageCodes = 'favLanguageCodes';
 const kAscendingFeeds = 'ascendingfeed:::';
 const kPatchNotesDisposed = 'kPatchNotesDisposed';
+const kCloseBtnAction = 'closeBtnAction';
 
 const shops = <String, String>{
   'https://us.7digital.com/': '7digital',

diff --git a/lib/l10n/app_en.arb b/lib/l10n/app_en.arb
@@ -331,5 +331,13 @@
     "replayAllEpisodes": "Replay all episodes",
     "checkForUpdates": "Check for updates",
     "playbackWillStopIn": "Playback will stop in: {duration} ({timeOfDay})",
-    "schedulePlaybackStopTimer": "Schedule a time to stop playback"
+    "schedulePlaybackStopTimer": "Schedule a time to stop playback",
+    "alwaysAsk": "Always ask",
+    "hideToTray": "Hide to tray",
+    "closeBtnAction": "Close Button Action",
+    "whenCloseBtnClicked": "When close button is clicked",
+    "closeApp": "Close Application",
+    "closeMusicPod": "Close MusicPod?",
+    "confirmCloseOrHideTip": "Please confirm if you need to close the application or hide it?",
+    "doNotAskAgain": "Do not ask again"
 }
diff --git a/lib/l10n/app_zh.arb b/lib/l10n/app_zh.arb
@@ -91,7 +91,7 @@
     "cryptocurrencyXXXPodcastIndexOnly": "加密货币",
     "cultureXXXPodcastIndexOnly": "文化",
     "dailyXXXPodcastIndexOnly": "每日",
-    "dark": "暗色",
+    "dark": "浅色",
     "decreaseSearchLimit": "请减少搜索限制",
     "deletePlaylist": "删除播放列表",
     "dependencies": "依赖",
@@ -330,5 +330,14 @@
     "writeMetadata": "写入元数据",
     "year": "年份",
     "years": "年份",
-    "playbackWillStopIn": "播放将在 {duration} （{timeOfDay}）后停止。"
+    "playbackWillStopIn": "播放将在 {duration} （{timeOfDay}）后停止。",
+    "schedulePlaybackStopTimer": "计划停止播放的时间",
+    "alwaysAsk": "总是询问",
+    "hideToTray": "隐藏到托盘",
+    "closeBtnAction": "关闭按钮的行为",
+    "whenCloseBtnClicked": "当点击关闭按钮时",
+    "closeApp": "关闭应用",
+    "closeMusicPod": "关闭 MusicPod？",
+    "confirmCloseOrHideTip": "请确定您想要退出应用还是隐藏到托盘？",
+    "doNotAskAgain": "不再询问"
 }
diff --git a/lib/l10n/app_zh_CN.arb b/lib/l10n/app_zh_CN.arb
@@ -91,7 +91,7 @@
     "cryptocurrencyXXXPodcastIndexOnly": "加密货币",
     "cultureXXXPodcastIndexOnly": "文化",
     "dailyXXXPodcastIndexOnly": "每日",
-    "dark": "暗色",
+    "dark": "浅色",
     "decreaseSearchLimit": "请减少搜索限制",
     "deletePlaylist": "删除播放列表",
     "dependencies": "依赖",
@@ -330,5 +330,14 @@
     "writeMetadata": "写入元数据",
     "year": "年份",
     "years": "年份",
-    "playbackWillStopIn": "播放将在 {duration} （{timeOfDay}）后停止。"
+    "playbackWillStopIn": "播放将在 {duration} （{timeOfDay}）后停止。",
+    "schedulePlaybackStopTimer": "计划停止播放的时间",
+    "alwaysAsk": "总是询问",
+    "hideToTray": "隐藏到托盘",
+    "closeBtnAction": "关闭按钮的行为",
+    "whenCloseBtnClicked": "当点击关闭按钮时",
+    "closeApp": "关闭应用",
+    "closeMusicPod": "关闭 MusicPod？",
+    "confirmCloseOrHideTip": "请确定您想要退出应用还是隐藏到托盘？",
+    "doNotAskAgain": "不再询问"
 }
diff --git a/lib/main.dart b/lib/main.dart
@@ -18,6 +18,7 @@ import '../../library/library_model.dart';
 import 'app/app_model.dart';
 import 'app/connectivity_model.dart';
 import 'app/view/app.dart';
+import 'app/view/system_tray.dart';
 import 'library/library_service.dart';
 import 'local_audio/local_audio_model.dart';
 import 'local_audio/local_audio_service.dart';
@@ -133,6 +134,15 @@ Future<void> main(List<String> args) async {
   final gitHub = GitHub();
   di.registerSingleton<GitHub>(gitHub);
 
+  if (!isMobile) {
+    final systemTray = SystemTray();
+    await systemTray.init();
+    di.registerSingleton<SystemTray>(
+      systemTray,
+      dispose: (s) async => s.dispose(),
+    );
+  }
+
   // Register ViewModels
   di.registerLazySingleton<SettingsModel>(
     () => SettingsModel(