Release Notes Window & Add ShowMsgWithButton API Function

Flow.Launcher.Infrastructure/Http/Http.cs

@@ -207,7 +207,7 @@
         }
 
         /// <summary>
         /// Asynchrously send an HTTP request.
         /// </summary>
         public static async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, HttpCompletionOption completionOption = HttpCompletionOption.ResponseContentRead, CancellationToken token = default)
         {
@@ -220,5 +220,18 @@
                 return new HttpResponseMessage(HttpStatusCode.InternalServerError);
             }
         }
+
+        public static async Task<string> GetStringAsync(string url, CancellationToken token = default)
+        {
+            try
+            {
+                Log.Debug(ClassName, $"Url <{url}>");
+                return await client.GetStringAsync(url, token);
+            }
+            catch (System.Exception e)
+            {
+                return string.Empty;
+            }
+        }
     }
 }

Flow.Launcher.Infrastructure/UserSettings/Settings.cs

@@ -25,7 +25,7 @@
 
         public void Initialize()
         {
             _stringMatcher = Ioc.Default.GetRequiredService<StringMatcher>();
         }
 
         public void Save()
@@ -33,7 +33,6 @@
             _storage.Save();
         }
 
-        private string _theme = Constant.DefaultTheme;
         public string Hotkey { get; set; } = $"{KeyConstant.Alt} + {KeyConstant.Space}";
         public string OpenResultModifiers { get; set; } = KeyConstant.Alt;
         public string ColorScheme { get; set; } = "System";
@@ -64,6 +63,7 @@
                 OnPropertyChanged();
             }
         }
+        private string _theme = Constant.DefaultTheme;
         public string Theme
         {
             get => _theme;
@@ -79,6 +79,7 @@
         }
         public bool UseDropShadowEffect { get; set; } = true;
         public BackdropTypes BackdropType{ get; set; } = BackdropTypes.None;
+        public string ReleaseNotesVersion { get; set; } = string.Empty;
 
         /* Appearance Settings. It should be separated from the setting later.*/
         public double WindowHeightSize { get; set; } = 42;

Flow.Launcher.Plugin/Interfaces/IPublicAPI.cs

@@ -84,6 +84,15 @@
         /// <param name="subTitle">Optional message subtitle</param>
         void ShowMsgError(string title, string subTitle = "");
 
+        /// <summary>
+        /// Show the error message using Flow's standard error icon.
+        /// </summary>
+        /// <param name="title">Message title</param>
+        /// <param name="buttonText">Message button content</param>
+        /// <param name="buttonAction">Message button action</param>
+        /// <param name="subTitle">Optional message subtitle</param>
+        void ShowMsgErrorWithButton(string title, string buttonText, Action buttonAction, string subTitle = "");
+
         /// <summary>
         /// Show the MainWindow when hiding
         /// </summary>
@@ -127,6 +136,27 @@
         /// <param name="useMainWindowAsOwner">when true will use main windows as the owner</param>
         void ShowMsg(string title, string subTitle, string iconPath, bool useMainWindowAsOwner = true);
 
+        /// <summary>
+        /// Show message box with button
+        /// </summary>
+        /// <param name="title">Message title</param>
+        /// <param name="buttonText">Message button content</param>
+        /// <param name="buttonAction">Message button action</param>
+        /// <param name="subTitle">Message subtitle</param>
+        /// <param name="iconPath">Message icon path (relative path to your plugin folder)</param>
+        void ShowMsgWithButton(string title, string buttonText, Action buttonAction, string subTitle = "", string iconPath = "");
+
+        /// <summary>
+        /// Show message box with button
+        /// </summary>
+        /// <param name="title">Message title</param>
+        /// <param name="buttonText">Message button content</param>
+        /// <param name="buttonAction">Message button action</param>
+        /// <param name="subTitle">Message subtitle</param>
+        /// <param name="iconPath">Message icon path (relative path to your plugin folder)</param>
+        /// <param name="useMainWindowAsOwner">when true will use main windows as the owner</param>
+        void ShowMsgWithButton(string title, string buttonText, Action buttonAction, string subTitle, string iconPath, bool useMainWindowAsOwner = true);
+
         /// <summary>
         /// Open setting dialog
         /// </summary>
@@ -207,7 +237,7 @@
         Task<string> HttpGetStringAsync(string url, CancellationToken token = default);
 
         /// <summary>
         /// Http download the spefic url and return as stream
         /// </summary>
         /// <param name="url">URL to call Http Get</param>
         /// <param name="token">Cancellation Token</param>
@@ -348,7 +378,7 @@
 
         /// <summary>
         /// Reloads the query.
         /// When current results are from context menu or history, it will go back to query results before requerying.
         /// </summary>
         /// <param name="reselect">Choose the first result after reload if true; keep the last selected result if false. Default is true.</param>
         public void ReQuery(bool reselect = true);

Flow.Launcher/App.xaml.cs

@@ -60,7 +60,7 @@
                 var storage = new FlowLauncherJsonStorage<Settings>();
                 _settings = storage.Load();
                 _settings.SetStorage(storage);
                 _settings.WMPInstalled = WindowsMediaPlayerHelper.IsWindowsMediaPlayerInstalled();
             }
             catch (Exception e)
             {
@@ -103,7 +103,7 @@
                         .AddTransient<SelectBrowserViewModel>()
                         .AddTransient<SelectFileManagerViewModel>()
                     ).Build();
                 Ioc.Default.ConfigureServices(host.Services);
             }
             catch (Exception e)
             {
@@ -114,9 +114,9 @@
             // Initialize the public API and Settings first
             try
             {
                 API = Ioc.Default.GetRequiredService<IPublicAPI>();
                 _settings.Initialize();
                 _mainVM = Ioc.Default.GetRequiredService<MainViewModel>();
             }
             catch (Exception e)
             {
@@ -171,6 +171,8 @@
                 Current.Resources["SettingWindowFont"] = new FontFamily(_settings.SettingWindowFont);
                 Current.Resources["ContentControlThemeFontFamily"] = new FontFamily(_settings.SettingWindowFont);
 
+                Notification.Install();
+
                 Ioc.Default.GetRequiredService<Portable>().PreStartCleanUpAfterPortabilityUpdate();
 
                 API.LogInfo(ClassName, "Begin Flow Launcher startup ----------------------------------------------------");
@@ -196,7 +198,7 @@
                 // Change language after all plugins are initialized because we need to update plugin title based on their api
                 await Ioc.Default.GetRequiredService<Internationalization>().InitializeLanguageAsync();
 
                 await imageLoadertask;
 
                 _mainWindow = new MainWindow();
 
@@ -222,7 +224,7 @@
             });
         }
 
 #pragma warning restore VSTHRD100 // Avoid async void methods
 
         /// <summary>
         /// Check startup only for Release

Flow.Launcher/Flow.Launcher.csproj

@@ -90,6 +90,11 @@
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
     <PackageReference Include="InputSimulator" Version="1.0.4" />
+    <PackageReference Include="MdXaml" Version="1.27.0" />
+    <PackageReference Include="MdXaml.AnimatedGif" Version="1.27.0" />
+    <PackageReference Include="MdXaml.Html" Version="1.27.0" />
+    <PackageReference Include="MdXaml.Plugins" Version="1.27.0" />
+    <PackageReference Include="MdXaml.Svg" Version="1.27.0" />
     <!-- Do not upgrade Microsoft.Extensions.DependencyInjection and Microsoft.Extensions.Hosting since we are .Net7.0 -->
     <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="7.0.0" />
     <PackageReference Include="Microsoft.Extensions.Hosting" Version="7.0.1" />

Flow.Launcher/Languages/en.xaml

@@ -365,6 +365,13 @@
     <system:String x:Key="LogLevelINFO">Info</system:String>
     <system:String x:Key="settingWindowFontTitle">Setting Window Font</system:String>
 
+    <!--  Release Notes Window  -->
+    <system:String x:Key="seeMoreReleaseNotes">See more release notes on GitHub</system:String>
+    <system:String x:Key="checkNetworkConnectionTitle">Failed to fetch release notes</system:String>
+    <system:String x:Key="checkNetworkConnectionSubTitle">Please check your network connection or ensure GitHub is accessible</system:String>
+    <system:String x:Key="appUpdateTitle">Flow Launcher has been updated to {0}</system:String>
+    <system:String x:Key="appUpdateButtonContent">Click here to view the release notes</system:String>
+
     <!--  FileManager Setting Dialog  -->
     <system:String x:Key="fileManagerWindow">Select File Manager</system:String>
     <system:String x:Key="fileManager_learnMore">Learn more</system:String>

Flow.Launcher/MainWindow.xaml.cs

@@ -121,6 +121,9 @@ private void OnLoaded(object sender, RoutedEventArgs _)
                 // Set First Launch to false
                 _settings.FirstLaunch = false;
 
+                // Update release notes version
+                _settings.ReleaseNotesVersion = Constant.Version;
+
                 // Set Backdrop Type to Acrylic for Windows 11 when First Launch. Default is None
                 if (Win32Helper.IsBackdropSupported()) _settings.BackdropType = BackdropTypes.Acrylic;
 
@@ -132,6 +135,25 @@ private void OnLoaded(object sender, RoutedEventArgs _)
                 welcomeWindow.Show();
             }
 
+            if (_settings.ReleaseNotesVersion != Constant.Version)
+            {
+                // Update release notes version
+                _settings.ReleaseNotesVersion = Constant.Version;
+
+                // Display message box with button
+                App.API.ShowMsgWithButton(
+                    string.Format(App.API.GetTranslation("appUpdateTitle"), Constant.Version),
+                    App.API.GetTranslation("appUpdateButtonContent"),
+                    () =>
+                    {
+                        Application.Current.Dispatcher.Invoke(() =>
+                        {
+                            var releaseNotesWindow = new ReleaseNotesWindow();
+                            releaseNotesWindow.Show();
+                        });
+                    });
+            }
+
             // Initialize place holder
             SetupPlaceholderText();
             _viewModel.PlaceholderText = _settings.PlaceholderText;

Flow.Launcher/Msg.xaml

@@ -1,41 +1,76 @@
-<Window x:Class="Flow.Launcher.Msg"
-        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
-        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
-        Background="#ebebeb"
-        Topmost="True"
-        SizeToContent="Height"
-        ResizeMode="NoResize"
-        WindowStyle="None"
-        ShowInTaskbar="False"
-        Title="Msg" Height="60" Width="420">
+<Window
+    x:Class="Flow.Launcher.Msg"
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+    Title="Msg"
+    Width="420"
+    Height="60"
+    Background="#ebebeb"
+    ResizeMode="NoResize"
+    ShowInTaskbar="False"
+    SizeToContent="Height"
+    Topmost="True"
+    WindowStyle="None">
     <Window.Triggers>
         <EventTrigger RoutedEvent="Window.Loaded">
             <BeginStoryboard>
                 <Storyboard>
-                    <DoubleAnimation x:Name="showAnimation" Duration="0:0:0.3" Storyboard.TargetProperty="Top"
-                                     AccelerationRatio="0.2" />
+                    <DoubleAnimation
+                        x:Name="showAnimation"
+                        AccelerationRatio="0.2"
+                        Storyboard.TargetProperty="Top"
+                        Duration="0:0:0.3" />
                 </Storyboard>
             </BeginStoryboard>
         </EventTrigger>
-
     </Window.Triggers>
-    <Grid HorizontalAlignment="Stretch" VerticalAlignment="Stretch" Margin="5">
+
+    <Grid
+        Margin="5"
+        HorizontalAlignment="Stretch"
+        VerticalAlignment="Stretch">
         <Grid.ColumnDefinitions>
             <ColumnDefinition Width="32" />
             <ColumnDefinition />
             <ColumnDefinition Width="2.852" />
-            <ColumnDefinition Width="13.148"/>
+            <ColumnDefinition Width="13.148" />
         </Grid.ColumnDefinitions>
-        <Image x:Name="imgIco" Width="32" Height="32" HorizontalAlignment="Left" Margin="0,9" />
-        <Grid HorizontalAlignment="Stretch" Margin="5 0 0 0" Grid.Column="1" VerticalAlignment="Stretch">
+        <Image
+            x:Name="imgIco"
+            Width="32"
+            Height="32"
+            Margin="0 9"
+            HorizontalAlignment="Left" />
+        <Grid
+            Grid.Column="1"
+            Margin="5 0 0 0"
+            HorizontalAlignment="Stretch"
+            VerticalAlignment="Stretch">
             <Grid.RowDefinitions>
                 <RowDefinition />
                 <RowDefinition />
             </Grid.RowDefinitions>
-            <TextBlock x:Name="tbTitle" FontSize="16" Foreground="#37392c" FontWeight="Medium">Title</TextBlock>
-            <TextBlock Grid.Row="1" Foreground="#8e94a4" x:Name="tbSubTitle">sdfdsf</TextBlock>
+            <TextBlock
+                x:Name="tbTitle"
+                FontSize="16"
+                FontWeight="Medium"
+                Foreground="#37392c">
+                Title
+            </TextBlock>
+            <TextBlock
+                x:Name="tbSubTitle"
+                Grid.Row="1"
+                Foreground="#8e94a4">
+                sdfdsf
+            </TextBlock>
         </Grid>
-        <Image x:Name="imgClose" Grid.Column="2" Cursor="Hand" Width="16" VerticalAlignment="Top"
-               HorizontalAlignment="Right" Grid.ColumnSpan="2" />
+        <Image
+            x:Name="imgClose"
+            Grid.Column="2"
+            Grid.ColumnSpan="2"
+            Width="16"
+            HorizontalAlignment="Right"
+            VerticalAlignment="Top"
+            Cursor="Hand" />
     </Grid>
 </Window>

Flow.Launcher/MsgWithButton.xaml

@@ -0,0 +1,84 @@
+<Window
+    x:Class="Flow.Launcher.MsgWithButton"
+    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+    Title="Msg"
+    Width="420"
+    Height="60"
+    Background="#ebebeb"
+    ResizeMode="NoResize"
+    ShowInTaskbar="False"
+    SizeToContent="Height"
+    Topmost="True"
+    WindowStyle="None">
+    <Window.Triggers>
+        <EventTrigger RoutedEvent="Window.Loaded">
+            <BeginStoryboard>
+                <Storyboard>
+                    <DoubleAnimation
+                        x:Name="showAnimation"
+                        AccelerationRatio="0.2"
+                        Storyboard.TargetProperty="Top"
+                        Duration="0:0:0.3" />
+                </Storyboard>
+            </BeginStoryboard>
+        </EventTrigger>
+    </Window.Triggers>
+
+    <StackPanel Orientation="Vertical">
+        <Grid
+            Margin="5"
+            HorizontalAlignment="Stretch"
+            VerticalAlignment="Stretch">
+            <Grid.ColumnDefinitions>
+                <ColumnDefinition Width="32" />
+                <ColumnDefinition />
+                <ColumnDefinition Width="2.852" />
+                <ColumnDefinition Width="13.148" />
+            </Grid.ColumnDefinitions>
+            <Image
+                x:Name="imgIco"
+                Width="32"
+                Height="32"
+                Margin="0 9"
+                HorizontalAlignment="Left" />
+            <Grid
+                Grid.Column="1"
+                Margin="5 0 0 0"
+                HorizontalAlignment="Stretch"
+                VerticalAlignment="Stretch">
+                <Grid.RowDefinitions>
+                    <RowDefinition />
+                    <RowDefinition />
+                </Grid.RowDefinitions>
+                <TextBlock
+                    x:Name="tbTitle"
+                    FontSize="16"
+                    FontWeight="Medium"
+                    Foreground="#37392c">
+                    Title
+                </TextBlock>
+                <TextBlock
+                    x:Name="tbSubTitle"
+                    Grid.Row="1"
+                    Foreground="#8e94a4">
+                    sdfdsf
+                </TextBlock>
+            </Grid>
+            <Image
+                x:Name="imgClose"
+                Grid.Column="2"
+                Grid.ColumnSpan="2"
+                Width="16"
+                HorizontalAlignment="Right"
+                VerticalAlignment="Top"
+                Cursor="Hand" />
+        </Grid>
+        <Button
+            x:Name="btn"
+            Margin="5 0 5 5"
+            HorizontalAlignment="Stretch"
+            Content="fwafaw"
+            Foreground="#dcdcdc" />
+    </StackPanel>
+</Window>