implement status icon blinking (#714)

Add blinking behavior to the status icon when in blinking mode and unread messages are present, and stop blinking when the window becomes active.

New Features:
- Introduce a blinking status icon mode that alternates between normal and reverse icons for unread messages on macOS and Linux.
- Automatically stop the blinking status icon when the application window becomes active.

Enhancements:
- Ensure timers and icon resources for status indicators are properly cleaned up when indicators are destroyed or modes change.

Author: lidaobing

share/icons/hicolor/16x16/apps/iptux-icon-reverse.png

@@ -11,6 +11,7 @@
 #define __LOCALE_PATH "@SHARE_DIR@/locale"
 #define __SOUND_PATH "@SHARE_IPTUX_DIR@/sound"
 #define __UI_PATH "@SHARE_IPTUX_DIR@/ui"
+#define __ICON_PATH "@SHARE_DIR@/icons/hicolor"
 
 #define IPTUX_PATH "/iptux"
 #define LOG_PATH "/iptux/log"

share/icons/hicolor/22x22/apps/iptux-icon-reverse.png

@@ -4,12 +4,17 @@
 #include <glib/gi18n.h>
 #include <libayatana-appindicator/app-indicator.h>
 
+#include "iptux-utils/output.h"
+
 namespace iptux {
 
 class IptuxAppIndicatorPrivate {
  public:
   IptuxAppIndicatorPrivate(IptuxAppIndicator* owner) : owner(owner) {}
   ~IptuxAppIndicatorPrivate() {
+    if (blinkTimerId) {
+      g_source_remove(blinkTimerId);
+    }
     if (indicator) {
       g_object_unref(indicator);
     }
@@ -22,12 +27,49 @@ class IptuxAppIndicatorPrivate {
   GtkBuilder* menuBuilder;
   StatusIconMode mode = STATUS_ICON_MODE_NORMAL;
   int unreadCount = 0;
+  guint blinkTimerId = 0;
+  bool blinkState = false;
 
   static void onScrollEvent(IptuxAppIndicatorPrivate* self) {
     self->owner->sigActivateMainWindow.emit();
   }
 };
 
+static gboolean blinkTimerCallback(gpointer data) {
+  auto priv = static_cast<IptuxAppIndicatorPrivate*>(data);
+  priv->blinkState = !priv->blinkState;
+  if (priv->blinkState) {
+    LOG_DEBUG("blinkTimerCallback: switching to reverse icon");
+    app_indicator_set_icon_full(priv->indicator, "iptux-icon-reverse",
+                                "iptux-icon-reverse");
+  } else {
+    LOG_DEBUG("blinkTimerCallback: switching to normal icon");
+    app_indicator_set_icon_full(priv->indicator, "iptux-icon", "iptux-icon");
+  }
+  return G_SOURCE_CONTINUE;
+}
+
+static void startBlinkTimer(IptuxAppIndicatorPrivate* priv) {
+  if (priv->blinkTimerId) {
+    LOG_DEBUG("startBlinkTimer: timer already running (id=%u)", priv->blinkTimerId);
+    return;
+  }
+  priv->blinkState = false;
+  priv->blinkTimerId = g_timeout_add(500, blinkTimerCallback, priv);
+  LOG_DEBUG("startBlinkTimer: blinking started (timerId=%u)", priv->blinkTimerId);
+}
+
+static void stopBlinkTimer(IptuxAppIndicatorPrivate* priv) {
+  if (priv->blinkTimerId) {
+    LOG_DEBUG("stopBlinkTimer: blinking stopped (timerId=%u)", priv->blinkTimerId);
+    g_source_remove(priv->blinkTimerId);
+    priv->blinkTimerId = 0;
+  } else {
+    LOG_DEBUG("stopBlinkTimer: no timer was running");
+  }
+  priv->blinkState = false;
+}
+
 IptuxAppIndicator::IptuxAppIndicator(GActionGroup* action_group) {
   this->priv = std::make_shared<IptuxAppIndicatorPrivate>(this);
 
@@ -42,7 +84,7 @@ IptuxAppIndicator::IptuxAppIndicator(GActionGroup* action_group) {
   app_indicator_set_status(priv->indicator, APP_INDICATOR_STATUS_ACTIVE);
   app_indicator_set_attention_icon_full(priv->indicator, "iptux-attention",
                                         "iptux-attention");
-
+  app_indicator_set_icon_theme_path(priv->indicator, __ICON_PATH);
   app_indicator_set_title(priv->indicator, _("Iptux"));
 
   priv->menuBuilder =
@@ -59,8 +101,24 @@ IptuxAppIndicator::IptuxAppIndicator(GActionGroup* action_group) {
 }
 
 void IptuxAppIndicator::SetUnreadCount(int i) {
+  LOG_DEBUG("SetUnreadCount: count=%d, mode=%d", i, priv->mode);
   priv->unreadCount = i;
-  if (priv->mode == STATUS_ICON_MODE_NONE) return;
+  if (priv->mode == STATUS_ICON_MODE_NONE) {
+    LOG_DEBUG("SetUnreadCount: early return (mode=NONE)");
+    return;
+  }
+
+  if (priv->mode == STATUS_ICON_MODE_BLINKING) {
+    if (i > 0) {
+      startBlinkTimer(priv.get());
+    } else {
+      stopBlinkTimer(priv.get());
+      app_indicator_set_icon_full(priv->indicator, "iptux-icon", "iptux-icon");
+      app_indicator_set_status(priv->indicator, APP_INDICATOR_STATUS_ACTIVE);
+    }
+    return;
+  }
+
   if (i > 0) {
     app_indicator_set_status(priv->indicator, APP_INDICATOR_STATUS_ATTENTION);
   } else {
@@ -69,12 +127,28 @@ void IptuxAppIndicator::SetUnreadCount(int i) {
 }
 
 void IptuxAppIndicator::SetMode(StatusIconMode mode) {
+  LOG_DEBUG("SetMode: mode=%d (old=%d)", mode, priv->mode);
+  StatusIconMode oldMode = priv->mode;
   priv->mode = mode;
+
+  if (oldMode == STATUS_ICON_MODE_BLINKING) {
+    stopBlinkTimer(priv.get());
+    app_indicator_set_icon_full(priv->indicator, "iptux-icon", "iptux-icon");
+  }
+
   if (mode == STATUS_ICON_MODE_NONE) {
     app_indicator_set_status(priv->indicator, APP_INDICATOR_STATUS_PASSIVE);
   } else {
     SetUnreadCount(priv->unreadCount);
   }
 }
 
+void IptuxAppIndicator::StopBlinking() {
+  LOG_DEBUG("StopBlinking called");
+  stopBlinkTimer(priv.get());
+  app_indicator_set_icon_full(priv->indicator, "iptux-icon", "iptux-icon");
+  if (priv->mode == STATUS_ICON_MODE_NONE) return;
+  app_indicator_set_status(priv->indicator, APP_INDICATOR_STATUS_ACTIVE);
+}
+
 }  // namespace iptux

share/icons/hicolor/24x24/apps/iptux-icon-reverse.png

@@ -14,10 +14,15 @@ class IptuxAppIndicator {
   IptuxAppIndicator(GActionGroup* action_group);
   void SetUnreadCount(int count);
   void SetMode(StatusIconMode mode);
+  void StopBlinking();
 
   sigc::signal<void> sigActivateMainWindow;
 
  private:
   std::shared_ptr<IptuxAppIndicatorPrivate> priv;
 };
+#ifdef __APPLE__
+void ActivateApplication();
+#endif
+
 }  // namespace iptux