Inform regarding background activity when quitting

Author: mhaeuser

BatteryToolkit/BTLocalization.swift

@@ -9,7 +9,7 @@ internal enum BTLocalization {
     enum Prompts {
         static let ok = NSLocalizedString(
             "OK",
-            comment: "Prompt button to acknowledge an situation"
+            comment: "Prompt button to acknowledge a situation"
         )
 
         static let approve = NSLocalizedString(
@@ -37,6 +37,26 @@ internal enum BTLocalization {
             comment: "Prompt button to disable a core function and quit the app"
         )
 
+        static let openSystemSettings = NSLocalizedString(
+            "Open System Settings",
+            comment: "Prompt button to open System Settings"
+        )
+
+        static let quitMessage = NSLocalizedString(
+            "Quit Battery Toolkit?",
+            comment: "Prompt caption asking whether to quit the app"
+        )
+
+        static let quitInfo = NSLocalizedString(
+            "Battery Toolkit will continue to run in the background. To permanently suspend it, disable the background activity from the Battery Toolkit menu.",
+            comment: "Prompt caption asking whether to quit the app"
+        )
+
+        static let quitInfoMacOS13 = NSLocalizedString(
+            "To temporarily suspend it, disable the background activity in System Settings.",
+            comment: "Prompt caption asking whether to quit the app"
+        )
+
         static let unexpectedErrorMessage = NSLocalizedString(
             "An unexpected error has occured.",
             comment: "Prompt caption informing the user of an unexpected error"

BatteryToolkit/Views/BTAppPrompts.swift

@@ -1,14 +1,50 @@
 //
-// Copyright (C) 2022 Marvin Häuser. All rights reserved.
+// Copyright (C) 2022 - 2024 Marvin Häuser. All rights reserved.
 // SPDX-License-Identifier: BSD-3-Clause
 //
 
 import Cocoa
+import ServiceManagement
 
 @MainActor
 internal enum BTAppPrompts {
     private(set) static var open: UInt8 = 0
 
+    static func promptQuit() {
+        let alert = NSAlert()
+        alert.messageText = BTLocalization.Prompts.quitMessage
+        if #available(macOS 13.0, *) {
+            alert.informativeText = BTLocalization.Prompts.quitInfo + " " + BTLocalization.Prompts.quitInfoMacOS13
+        } else {
+            alert.informativeText = BTLocalization.Prompts.quitInfo
+        }
+        alert.alertStyle = NSAlert.Style.informational
+        _ = alert.addButton(withTitle: BTLocalization.Prompts.quit)
+        _ = alert.addButton(withTitle: BTLocalization.Prompts.cancel)
+        if #available(macOS 13.0, *) {
+            _ = alert.addButton(withTitle: BTLocalization.Prompts.openSystemSettings)
+        }
+        let response = self.runPromptStandalone(alert: alert)
+        switch response {
+        case NSApplication.ModalResponse.alertFirstButtonReturn:
+            NSApp.terminate(self)
+            
+        case NSApplication.ModalResponse.alertSecondButtonReturn:
+            break
+            
+        case NSApplication.ModalResponse.alertThirdButtonReturn:
+            if #available(macOS 13.0, *) {
+                SMAppService.openSystemSettingsLoginItems()
+            } else {
+                assertionFailure()
+            }
+            break
+
+        default:
+            assertionFailure()
+        }
+    }
+
     static func promptApproveDaemon(timeout: UInt8) async throws {
         let alert = NSAlert()
         alert.messageText = BTLocalization.Prompts.Daemon.allowMessage

BatteryToolkit/Views/Main/BTCommandsMenuDelegate.swift

@@ -240,6 +240,10 @@ internal final class BTCommandsMenuDelegate: NSObject, NSMenuDelegate {
         self.refreshTimer = nil
     }
 
+    @IBAction private func quitHandler(sender _: NSMenuItem) {
+        BTAppPrompts.promptQuit()
+    }
+
     @IBAction private func disablePowerAdapterHandler(sender _: NSMenuItem) {
         Task {
             do {

BatteryToolkit/Views/Main/Base.lproj/Main.storyboard

@@ -59,7 +59,7 @@
                                         <menuItem isSeparatorItem="YES" id="kCx-OE-vgT"/>
                                         <menuItem title="Quit Battery Toolkit" keyEquivalent="q" id="4sb-4s-VLi">
                                             <connections>
-                                                <action selector="terminate:" target="Ady-hI-5gd" id="Te7-pn-YzF"/>
+                                                <action selector="quitHandlerWithSender:" target="Yoz-Et-jXW" id="XwH-9q-S0c"/>
                                             </connections>
                                         </menuItem>
                                     </items>
@@ -373,7 +373,7 @@
                         <menuItem isSeparatorItem="YES" id="9fM-fx-Sxj"/>
                         <menuItem title="Quit Battery Toolkit" keyEquivalent="q" id="Smu-3d-BCn">
                             <connections>
-                                <action selector="terminate:" target="Ady-hI-5gd" id="lXW-g6-h5X"/>
+                                <action selector="quitHandlerWithSender:" target="Yoz-Et-jXW" id="WbX-gg-kmB"/>
                             </connections>
                         </menuItem>
                     </items>