Add launch at login support

Sources/Config/LaunchAtLoginService.swift

@@ -0,0 +1,41 @@
+import ServiceManagement
+
+protocol LoginItemServicing {
+ var status: SMAppService.Status { get }
+ func register() throws
+ func unregister() throws
+}
+
+extension SMAppService: LoginItemServicing {}
+
+enum LaunchAtLoginService {
+ static var isEnabled: Bool {
+ isEnabled(status: SMAppService.mainApp.status)
+ }
+
+ static var requiresApproval: Bool {
+ requiresApproval(status: SMAppService.mainApp.status)
+ }
+
+ static func setEnabled(_ enabled: Bool) throws {
+ try setEnabled(enabled, service: SMAppService.mainApp)
+ }
+
+ static func isEnabled(status: SMAppService.Status) -> Bool {
+ status == .enabled
+ }
+
+ static func requiresApproval(status: SMAppService.Status) -> Bool {
+ status == .requiresApproval
+ }
+
+ static func setEnabled(_ enabled: Bool, service: LoginItemServicing) throws {
+ if enabled {
+ guard service.status != .enabled, service.status != .requiresApproval else { return }
+ try service.register()
+ } else {
+ guard service.status != .notRegistered else { return }
+ try service.unregister()
+ }
+ }
+}

Sources/Resources/en.lproj/Localizable.strings

@@ -97,6 +97,12 @@
 
 /* ── Settings ── */
 "settings.activation" = "Activation";
+"settings.startup" = "Startup";
+"settings.launch_at_login" = "Launch at login";
+"settings.launch_at_login_help" = "Automatically start Utter when you log in to your Mac.";
+"settings.launch_at_login_requires_approval" = "Allow Utter in System Settings → General → Login Items.";
+"settings.launch_at_login_error_title" = "Login Item Could Not Be Updated";
+"settings.launch_at_login_error" = "Utter could not update its login item: %@";
 "settings.interface" = "Interface";
 "settings.recognition" = "Recognition";
 "settings.audio" = "Audio";

Sources/Resources/zh-Hans.lproj/Localizable.strings

@@ -97,6 +97,12 @@
 
 /* ── Settings ── */
 "settings.activation" = "激活方式";
+"settings.startup" = "启动";
+"settings.launch_at_login" = "登录时启动";
+"settings.launch_at_login_help" = "登录 Mac 后自动启动 Utter。";
+"settings.launch_at_login_requires_approval" = "请在“系统设置”→“通用”→“登录项”中允许 Utter。";
+"settings.launch_at_login_error_title" = "无法更新登录项";
+"settings.launch_at_login_error" = "Utter 无法更新登录项：%@";
 "settings.interface" = "界面";
 "settings.recognition" = "识别引擎";
 "settings.audio" = "音频";

Sources/UI/GeneralSettingsView.swift

@@ -1,7 +1,12 @@
+import AppKit
 import SwiftUI
 
 struct GeneralSettingsView: View {
  @EnvironmentObject private var settings: AppSettings
+ @State private var launchAtLoginEnabled = false
+ @State private var launchAtLoginRequiresApproval = false
+ @State private var launchAtLoginErrorMessage = ""
+ @State private var showsLaunchAtLoginError = false
 
  var body: some View {
  VStack(spacing: 0) {
@@ -19,6 +24,15 @@ struct GeneralSettingsView: View {
  settingsForm
  }
  .settingsPageSurface()
+ .onAppear(perform: refreshLaunchAtLoginStatus)
+ .onReceive(NotificationCenter.default.publisher(for: NSApplication.didBecomeActiveNotification)) { _ in
+ refreshLaunchAtLoginStatus()
+ }
+ .alert(L("settings.launch_at_login_error_title"), isPresented: $showsLaunchAtLoginError) {
+ Button(L("common.ok"), role: .cancel) {}
+ } message: {
+ Text(launchAtLoginErrorMessage)
+ }
  }
 
  private var settingsForm: some View {
@@ -134,6 +148,27 @@ struct GeneralSettingsView: View {
  Text(L("settings.memory_help"))
  }
 
+ Section {
+ Toggle(isOn: Binding(
+ get: { launchAtLoginEnabled },
+ set: updateLaunchAtLogin
+ )) {
+ VStack(alignment: .leading, spacing: 2) {
+ Text(L("settings.launch_at_login"))
+ Text(L("settings.launch_at_login_help"))
+ .font(.caption)
+ .foregroundStyle(.secondary)
+ }
+ }
+ if launchAtLoginRequiresApproval {
+ Label(L("settings.launch_at_login_requires_approval"), systemImage: "exclamationmark.triangle")
+ .font(.caption)
+ .foregroundStyle(.orange)
+ }
+ } header: {
+ SettingsSectionHeader(title: L("settings.startup"), symbol: "power")
+ }
+
  Section {
  Picker(L("settings.ui_language"), selection: $settings.uiLanguage) {
  ForEach(UILanguage.allCases, id: \.self) { language in
@@ -202,6 +237,25 @@ struct GeneralSettingsView: View {
  .padding(.vertical, 4)
  .background(.quaternary, in: RoundedRectangle(cornerRadius: 6))
  }
+
+ private func updateLaunchAtLogin(_ enabled: Bool) {
+ do {
+ try LaunchAtLoginService.setEnabled(enabled)
+ } catch {
+ Log.error("Failed to update launch at login: \(error.localizedDescription)")
+ launchAtLoginErrorMessage = String(
+ format: L("settings.launch_at_login_error"),
+ error.localizedDescription
+ )
+ showsLaunchAtLoginError = true
+ }
+ refreshLaunchAtLoginStatus()
+ }
+
+ private func refreshLaunchAtLoginStatus() {
+ launchAtLoginEnabled = LaunchAtLoginService.isEnabled
+ launchAtLoginRequiresApproval = LaunchAtLoginService.requiresApproval
+ }
 }
 
 private struct SettingsSectionHeader: View {

Tests/OpenTypeTests/LaunchAtLoginServiceTests.swift

@@ -0,0 +1,56 @@
+import ServiceManagement
+import XCTest
+@testable import OpenType
+
+final class LaunchAtLoginServiceTests: XCTestCase {
+ func testStatusMappingUsesEnabledAsTheOnlyActiveState() {
+ XCTAssertTrue(LaunchAtLoginService.isEnabled(status: .enabled))
+ XCTAssertFalse(LaunchAtLoginService.isEnabled(status: .notRegistered))
+ XCTAssertFalse(LaunchAtLoginService.isEnabled(status: .requiresApproval))
+ XCTAssertTrue(LaunchAtLoginService.requiresApproval(status: .requiresApproval))
+ }
+
+ func testEnablingRegistersOnlyWhenNeeded() throws {
+ let disabledService = LoginItemServiceStub(status: .notRegistered)
+ try LaunchAtLoginService.setEnabled(true, service: disabledService)
+ XCTAssertEqual(disabledService.registerCallCount, 1)
+
+ let enabledService = LoginItemServiceStub(status: .enabled)
+ try LaunchAtLoginService.setEnabled(true, service: enabledService)
+ XCTAssertEqual(enabledService.registerCallCount, 0)
+
+ let approvalService = LoginItemServiceStub(status: .requiresApproval)
+ try LaunchAtLoginService.setEnabled(true, service: approvalService)
+ XCTAssertEqual(approvalService.registerCallCount, 0)
+ }
+
+ func testDisablingUnregistersOnlyWhenNeeded() throws {
+ let enabledService = LoginItemServiceStub(status: .enabled)
+ try LaunchAtLoginService.setEnabled(false, service: enabledService)
+ XCTAssertEqual(enabledService.unregisterCallCount, 1)
+
+ let disabledService = LoginItemServiceStub(status: .notRegistered)
+ try LaunchAtLoginService.setEnabled(false, service: disabledService)
+ XCTAssertEqual(disabledService.unregisterCallCount, 0)
+ }
+}
+
+private final class LoginItemServiceStub: LoginItemServicing {
+ var status: SMAppService.Status
+ private(set) var registerCallCount = 0
+ private(set) var unregisterCallCount = 0
+
+ init(status: SMAppService.Status) {
+ self.status = status
+ }
+
+ func register() throws {
+ registerCallCount += 1
+ status = .enabled
+ }
+
+ func unregister() throws {
+ unregisterCallCount += 1
+ status = .notRegistered
+ }
+}

Sources/Config/LaunchAtLoginService.swift

@@ -0,0 +1,41 @@
+import ServiceManagement
+
+protocol LoginItemServicing {
+ var status: SMAppService.Status { get }
+ func register() throws
+ func unregister() throws
+}
+
+extension SMAppService: LoginItemServicing {}
+
+enum LaunchAtLoginService {
+ static var isEnabled: Bool {
+ isEnabled(status: SMAppService.mainApp.status)
+ }
+
+ static var requiresApproval: Bool {
+ requiresApproval(status: SMAppService.mainApp.status)
+ }
+
+ static func setEnabled(_ enabled: Bool) throws {
+ try setEnabled(enabled, service: SMAppService.mainApp)
+ }
+
+ static func isEnabled(status: SMAppService.Status) -> Bool {
+ status == .enabled
+ }
+
+ static func requiresApproval(status: SMAppService.Status) -> Bool {
+ status == .requiresApproval
+ }
+
+ static func setEnabled(_ enabled: Bool, service: LoginItemServicing) throws {
+ if enabled {
+ guard service.status != .enabled, service.status != .requiresApproval else { return }
+ try service.register()
+ } else {
+ guard service.status != .notRegistered else { return }
+ try service.unregister()
+ }
+ }
+}

Sources/Resources/en.lproj/Localizable.strings

@@ -97,6 +97,12 @@
 
 /* ── Settings ── */
 "settings.activation" = "Activation";
+"settings.startup" = "Startup";
+"settings.launch_at_login" = "Launch at login";
+"settings.launch_at_login_help" = "Automatically start Utter when you log in to your Mac.";
+"settings.launch_at_login_requires_approval" = "Allow Utter in System Settings → General → Login Items.";
+"settings.launch_at_login_error_title" = "Login Item Could Not Be Updated";
+"settings.launch_at_login_error" = "Utter could not update its login item: %@";
 "settings.interface" = "Interface";
 "settings.recognition" = "Recognition";
 "settings.audio" = "Audio";

Sources/Resources/zh-Hans.lproj/Localizable.strings

@@ -97,6 +97,12 @@
 
 /* ── Settings ── */
 "settings.activation" = "激活方式";
+"settings.startup" = "启动";
+"settings.launch_at_login" = "登录时启动";
+"settings.launch_at_login_help" = "登录 Mac 后自动启动 Utter。";
+"settings.launch_at_login_requires_approval" = "请在“系统设置”→“通用”→“登录项”中允许 Utter。";
+"settings.launch_at_login_error_title" = "无法更新登录项";
+"settings.launch_at_login_error" = "Utter 无法更新登录项：%@";
 "settings.interface" = "界面";
 "settings.recognition" = "识别引擎";
 "settings.audio" = "音频";

Sources/UI/GeneralSettingsView.swift

@@ -1,7 +1,12 @@
+import AppKit
 import SwiftUI
 
 struct GeneralSettingsView: View {
  @EnvironmentObject private var settings: AppSettings
+ @State private var launchAtLoginEnabled = false
+ @State private var launchAtLoginRequiresApproval = false
+ @State private var launchAtLoginErrorMessage = ""
+ @State private var showsLaunchAtLoginError = false
 
  var body: some View {
  VStack(spacing: 0) {
@@ -19,6 +24,15 @@ struct GeneralSettingsView: View {
  settingsForm
  }
  .settingsPageSurface()
+ .onAppear(perform: refreshLaunchAtLoginStatus)
+ .onReceive(NotificationCenter.default.publisher(for: NSApplication.didBecomeActiveNotification)) { _ in
+ refreshLaunchAtLoginStatus()
+ }
+ .alert(L("settings.launch_at_login_error_title"), isPresented: $showsLaunchAtLoginError) {
+ Button(L("common.ok"), role: .cancel) {}
+ } message: {
+ Text(launchAtLoginErrorMessage)
+ }
  }
 
  private var settingsForm: some View {
@@ -134,6 +148,27 @@ struct GeneralSettingsView: View {
  Text(L("settings.memory_help"))
  }
 
+ Section {
+ Toggle(isOn: Binding(
+ get: { launchAtLoginEnabled },
+ set: updateLaunchAtLogin
+ )) {
+ VStack(alignment: .leading, spacing: 2) {
+ Text(L("settings.launch_at_login"))
+ Text(L("settings.launch_at_login_help"))
+ .font(.caption)
+ .foregroundStyle(.secondary)
+ }
+ }
+ if launchAtLoginRequiresApproval {
+ Label(L("settings.launch_at_login_requires_approval"), systemImage: "exclamationmark.triangle")
+ .font(.caption)
+ .foregroundStyle(.orange)
+ }
+ } header: {
+ SettingsSectionHeader(title: L("settings.startup"), symbol: "power")
+ }
+
  Section {
  Picker(L("settings.ui_language"), selection: $settings.uiLanguage) {
  ForEach(UILanguage.allCases, id: \.self) { language in
@@ -202,6 +237,25 @@ struct GeneralSettingsView: View {
  .padding(.vertical, 4)
  .background(.quaternary, in: RoundedRectangle(cornerRadius: 6))
  }
+
+ private func updateLaunchAtLogin(_ enabled: Bool) {
+ do {
+ try LaunchAtLoginService.setEnabled(enabled)
+ } catch {
+ Log.error("Failed to update launch at login: \(error.localizedDescription)")
+ launchAtLoginErrorMessage = String(
+ format: L("settings.launch_at_login_error"),
+ error.localizedDescription
+ )
+ showsLaunchAtLoginError = true
+ }
+ refreshLaunchAtLoginStatus()
+ }
+
+ private func refreshLaunchAtLoginStatus() {
+ launchAtLoginEnabled = LaunchAtLoginService.isEnabled
+ launchAtLoginRequiresApproval = LaunchAtLoginService.requiresApproval
+ }
 }
 
 private struct SettingsSectionHeader: View {

Tests/OpenTypeTests/LaunchAtLoginServiceTests.swift

@@ -0,0 +1,56 @@
+import ServiceManagement
+import XCTest
+@testable import OpenType
+
+final class LaunchAtLoginServiceTests: XCTestCase {
+ func testStatusMappingUsesEnabledAsTheOnlyActiveState() {
+ XCTAssertTrue(LaunchAtLoginService.isEnabled(status: .enabled))
+ XCTAssertFalse(LaunchAtLoginService.isEnabled(status: .notRegistered))
+ XCTAssertFalse(LaunchAtLoginService.isEnabled(status: .requiresApproval))
+ XCTAssertTrue(LaunchAtLoginService.requiresApproval(status: .requiresApproval))
+ }
+
+ func testEnablingRegistersOnlyWhenNeeded() throws {
+ let disabledService = LoginItemServiceStub(status: .notRegistered)
+ try LaunchAtLoginService.setEnabled(true, service: disabledService)
+ XCTAssertEqual(disabledService.registerCallCount, 1)
+
+ let enabledService = LoginItemServiceStub(status: .enabled)
+ try LaunchAtLoginService.setEnabled(true, service: enabledService)
+ XCTAssertEqual(enabledService.registerCallCount, 0)
+
+ let approvalService = LoginItemServiceStub(status: .requiresApproval)
+ try LaunchAtLoginService.setEnabled(true, service: approvalService)
+ XCTAssertEqual(approvalService.registerCallCount, 0)
+ }
+
+ func testDisablingUnregistersOnlyWhenNeeded() throws {
+ let enabledService = LoginItemServiceStub(status: .enabled)
+ try LaunchAtLoginService.setEnabled(false, service: enabledService)
+ XCTAssertEqual(enabledService.unregisterCallCount, 1)
+
+ let disabledService = LoginItemServiceStub(status: .notRegistered)
+ try LaunchAtLoginService.setEnabled(false, service: disabledService)
+ XCTAssertEqual(disabledService.unregisterCallCount, 0)
+ }
+}
+
+private final class LoginItemServiceStub: LoginItemServicing {
+ var status: SMAppService.Status
+ private(set) var registerCallCount = 0
+ private(set) var unregisterCallCount = 0
+
+ init(status: SMAppService.Status) {
+ self.status = status
+ }
+
+ func register() throws {
+ registerCallCount += 1
+ status = .enabled
+ }
+
+ func unregister() throws {
+ unregisterCallCount += 1
+ status = .notRegistered
+ }
+}

Sources/Config/LaunchAtLoginService.swift

@@ -0,0 +1,41 @@
+import ServiceManagement
+
+protocol LoginItemServicing {
+ var status: SMAppService.Status { get }
+ func register() throws
+ func unregister() throws
+}
+
+extension SMAppService: LoginItemServicing {}
+
+enum LaunchAtLoginService {
+ static var isEnabled: Bool {
+ isEnabled(status: SMAppService.mainApp.status)
+ }
+
+ static var requiresApproval: Bool {
+ requiresApproval(status: SMAppService.mainApp.status)
+ }
+
+ static func setEnabled(_ enabled: Bool) throws {
+ try setEnabled(enabled, service: SMAppService.mainApp)
+ }
+
+ static func isEnabled(status: SMAppService.Status) -> Bool {
+ status == .enabled
+ }
+
+ static func requiresApproval(status: SMAppService.Status) -> Bool {
+ status == .requiresApproval
+ }
+
+ static func setEnabled(_ enabled: Bool, service: LoginItemServicing) throws {
+ if enabled {
+ guard service.status != .enabled, service.status != .requiresApproval else { return }
+ try service.register()
+ } else {
+ guard service.status != .notRegistered else { return }
+ try service.unregister()
+ }
+ }
+}

Sources/Resources/en.lproj/Localizable.strings

@@ -97,6 +97,12 @@
 
 /* ── Settings ── */
 "settings.activation" = "Activation";
+"settings.startup" = "Startup";
+"settings.launch_at_login" = "Launch at login";
+"settings.launch_at_login_help" = "Automatically start Utter when you log in to your Mac.";
+"settings.launch_at_login_requires_approval" = "Allow Utter in System Settings → General → Login Items.";
+"settings.launch_at_login_error_title" = "Login Item Could Not Be Updated";
+"settings.launch_at_login_error" = "Utter could not update its login item: %@";
 "settings.interface" = "Interface";
 "settings.recognition" = "Recognition";
 "settings.audio" = "Audio";

Sources/Resources/zh-Hans.lproj/Localizable.strings

@@ -97,6 +97,12 @@
 
 /* ── Settings ── */
 "settings.activation" = "激活方式";
+"settings.startup" = "启动";
+"settings.launch_at_login" = "登录时启动";
+"settings.launch_at_login_help" = "登录 Mac 后自动启动 Utter。";
+"settings.launch_at_login_requires_approval" = "请在“系统设置”→“通用”→“登录项”中允许 Utter。";
+"settings.launch_at_login_error_title" = "无法更新登录项";
+"settings.launch_at_login_error" = "Utter 无法更新登录项：%@";
 "settings.interface" = "界面";
 "settings.recognition" = "识别引擎";
 "settings.audio" = "音频";

Sources/UI/GeneralSettingsView.swift

@@ -1,7 +1,12 @@
+import AppKit
 import SwiftUI
 
 struct GeneralSettingsView: View {
  @EnvironmentObject private var settings: AppSettings
+ @State private var launchAtLoginEnabled = false
+ @State private var launchAtLoginRequiresApproval = false
+ @State private var launchAtLoginErrorMessage = ""
+ @State private var showsLaunchAtLoginError = false
 
  var body: some View {
  VStack(spacing: 0) {
@@ -19,6 +24,15 @@ struct GeneralSettingsView: View {
  settingsForm
  }
  .settingsPageSurface()
+ .onAppear(perform: refreshLaunchAtLoginStatus)
+ .onReceive(NotificationCenter.default.publisher(for: NSApplication.didBecomeActiveNotification)) { _ in
+ refreshLaunchAtLoginStatus()
+ }
+ .alert(L("settings.launch_at_login_error_title"), isPresented: $showsLaunchAtLoginError) {
+ Button(L("common.ok"), role: .cancel) {}
+ } message: {
+ Text(launchAtLoginErrorMessage)
+ }
  }
 
  private var settingsForm: some View {
@@ -134,6 +148,27 @@ struct GeneralSettingsView: View {
  Text(L("settings.memory_help"))
  }
 
+ Section {
+ Toggle(isOn: Binding(
+ get: { launchAtLoginEnabled },
+ set: updateLaunchAtLogin
+ )) {
+ VStack(alignment: .leading, spacing: 2) {
+ Text(L("settings.launch_at_login"))
+ Text(L("settings.launch_at_login_help"))
+ .font(.caption)
+ .foregroundStyle(.secondary)
+ }
+ }
+ if launchAtLoginRequiresApproval {
+ Label(L("settings.launch_at_login_requires_approval"), systemImage: "exclamationmark.triangle")
+ .font(.caption)
+ .foregroundStyle(.orange)
+ }
+ } header: {
+ SettingsSectionHeader(title: L("settings.startup"), symbol: "power")
+ }
+
  Section {
  Picker(L("settings.ui_language"), selection: $settings.uiLanguage) {
  ForEach(UILanguage.allCases, id: \.self) { language in
@@ -202,6 +237,25 @@ struct GeneralSettingsView: View {
  .padding(.vertical, 4)
  .background(.quaternary, in: RoundedRectangle(cornerRadius: 6))
  }
+
+ private func updateLaunchAtLogin(_ enabled: Bool) {
+ do {
+ try LaunchAtLoginService.setEnabled(enabled)
+ } catch {
+ Log.error("Failed to update launch at login: \(error.localizedDescription)")
+ launchAtLoginErrorMessage = String(
+ format: L("settings.launch_at_login_error"),
+ error.localizedDescription
+ )
+ showsLaunchAtLoginError = true
+ }
+ refreshLaunchAtLoginStatus()
+ }
+
+ private func refreshLaunchAtLoginStatus() {
+ launchAtLoginEnabled = LaunchAtLoginService.isEnabled
+ launchAtLoginRequiresApproval = LaunchAtLoginService.requiresApproval
+ }
 }
 
 private struct SettingsSectionHeader: View {

Tests/OpenTypeTests/LaunchAtLoginServiceTests.swift

@@ -0,0 +1,56 @@
+import ServiceManagement
+import XCTest
+@testable import OpenType
+
+final class LaunchAtLoginServiceTests: XCTestCase {
+ func testStatusMappingUsesEnabledAsTheOnlyActiveState() {
+ XCTAssertTrue(LaunchAtLoginService.isEnabled(status: .enabled))
+ XCTAssertFalse(LaunchAtLoginService.isEnabled(status: .notRegistered))
+ XCTAssertFalse(LaunchAtLoginService.isEnabled(status: .requiresApproval))
+ XCTAssertTrue(LaunchAtLoginService.requiresApproval(status: .requiresApproval))
+ }
+
+ func testEnablingRegistersOnlyWhenNeeded() throws {
+ let disabledService = LoginItemServiceStub(status: .notRegistered)
+ try LaunchAtLoginService.setEnabled(true, service: disabledService)
+ XCTAssertEqual(disabledService.registerCallCount, 1)
+
+ let enabledService = LoginItemServiceStub(status: .enabled)
+ try LaunchAtLoginService.setEnabled(true, service: enabledService)
+ XCTAssertEqual(enabledService.registerCallCount, 0)
+
+ let approvalService = LoginItemServiceStub(status: .requiresApproval)
+ try LaunchAtLoginService.setEnabled(true, service: approvalService)
+ XCTAssertEqual(approvalService.registerCallCount, 0)
+ }
+
+ func testDisablingUnregistersOnlyWhenNeeded() throws {
+ let enabledService = LoginItemServiceStub(status: .enabled)
+ try LaunchAtLoginService.setEnabled(false, service: enabledService)
+ XCTAssertEqual(enabledService.unregisterCallCount, 1)
+
+ let disabledService = LoginItemServiceStub(status: .notRegistered)
+ try LaunchAtLoginService.setEnabled(false, service: disabledService)
+ XCTAssertEqual(disabledService.unregisterCallCount, 0)
+ }
+}
+
+private final class LoginItemServiceStub: LoginItemServicing {
+ var status: SMAppService.Status
+ private(set) var registerCallCount = 0
+ private(set) var unregisterCallCount = 0
+
+ init(status: SMAppService.Status) {
+ self.status = status
+ }
+
+ func register() throws {
+ registerCallCount += 1
+ status = .enabled
+ }
+
+ func unregister() throws {
+ unregisterCallCount += 1
+ status = .notRegistered
+ }
+}

Sources/Config/LaunchAtLoginService.swift

@@ -0,0 +1,41 @@
+import ServiceManagement
+
+protocol LoginItemServicing {
+ var status: SMAppService.Status { get }
+ func register() throws
+ func unregister() throws
+}
+
+extension SMAppService: LoginItemServicing {}
+
+enum LaunchAtLoginService {
+ static var isEnabled: Bool {
+ isEnabled(status: SMAppService.mainApp.status)
+ }
+
+ static var requiresApproval: Bool {
+ requiresApproval(status: SMAppService.mainApp.status)
+ }
+
+ static func setEnabled(_ enabled: Bool) throws {
+ try setEnabled(enabled, service: SMAppService.mainApp)
+ }
+
+ static func isEnabled(status: SMAppService.Status) -> Bool {
+ status == .enabled
+ }
+
+ static func requiresApproval(status: SMAppService.Status) -> Bool {
+ status == .requiresApproval
+ }
+
+ static func setEnabled(_ enabled: Bool, service: LoginItemServicing) throws {
+ if enabled {
+ guard service.status != .enabled, service.status != .requiresApproval else { return }
+ try service.register()
+ } else {
+ guard service.status != .notRegistered else { return }
+ try service.unregister()
+ }
+ }
+}

Sources/Resources/en.lproj/Localizable.strings

@@ -97,6 +97,12 @@
 
 /* ── Settings ── */
 "settings.activation" = "Activation";
+"settings.startup" = "Startup";
+"settings.launch_at_login" = "Launch at login";
+"settings.launch_at_login_help" = "Automatically start Utter when you log in to your Mac.";
+"settings.launch_at_login_requires_approval" = "Allow Utter in System Settings → General → Login Items.";
+"settings.launch_at_login_error_title" = "Login Item Could Not Be Updated";
+"settings.launch_at_login_error" = "Utter could not update its login item: %@";
 "settings.interface" = "Interface";
 "settings.recognition" = "Recognition";
 "settings.audio" = "Audio";

Sources/Resources/zh-Hans.lproj/Localizable.strings

@@ -97,6 +97,12 @@
 
 /* ── Settings ── */
 "settings.activation" = "激活方式";
+"settings.startup" = "启动";
+"settings.launch_at_login" = "登录时启动";
+"settings.launch_at_login_help" = "登录 Mac 后自动启动 Utter。";
+"settings.launch_at_login_requires_approval" = "请在“系统设置”→“通用”→“登录项”中允许 Utter。";
+"settings.launch_at_login_error_title" = "无法更新登录项";
+"settings.launch_at_login_error" = "Utter 无法更新登录项：%@";
 "settings.interface" = "界面";
 "settings.recognition" = "识别引擎";
 "settings.audio" = "音频";

Sources/UI/GeneralSettingsView.swift

@@ -1,7 +1,12 @@
+import AppKit
 import SwiftUI
 
 struct GeneralSettingsView: View {
  @EnvironmentObject private var settings: AppSettings
+ @State private var launchAtLoginEnabled = false
+ @State private var launchAtLoginRequiresApproval = false
+ @State private var launchAtLoginErrorMessage = ""
+ @State private var showsLaunchAtLoginError = false
 
  var body: some View {
  VStack(spacing: 0) {
@@ -19,6 +24,15 @@ struct GeneralSettingsView: View {
  settingsForm
  }
  .settingsPageSurface()
+ .onAppear(perform: refreshLaunchAtLoginStatus)
+ .onReceive(NotificationCenter.default.publisher(for: NSApplication.didBecomeActiveNotification)) { _ in
+ refreshLaunchAtLoginStatus()
+ }
+ .alert(L("settings.launch_at_login_error_title"), isPresented: $showsLaunchAtLoginError) {
+ Button(L("common.ok"), role: .cancel) {}
+ } message: {
+ Text(launchAtLoginErrorMessage)
+ }
  }
 
  private var settingsForm: some View {
@@ -134,6 +148,27 @@ struct GeneralSettingsView: View {
  Text(L("settings.memory_help"))
  }
 
+ Section {
+ Toggle(isOn: Binding(
+ get: { launchAtLoginEnabled },
+ set: updateLaunchAtLogin
+ )) {
+ VStack(alignment: .leading, spacing: 2) {
+ Text(L("settings.launch_at_login"))
+ Text(L("settings.launch_at_login_help"))
+ .font(.caption)
+ .foregroundStyle(.secondary)
+ }
+ }
+ if launchAtLoginRequiresApproval {
+ Label(L("settings.launch_at_login_requires_approval"), systemImage: "exclamationmark.triangle")
+ .font(.caption)
+ .foregroundStyle(.orange)
+ }
+ } header: {
+ SettingsSectionHeader(title: L("settings.startup"), symbol: "power")
+ }
+
  Section {
  Picker(L("settings.ui_language"), selection: $settings.uiLanguage) {
  ForEach(UILanguage.allCases, id: \.self) { language in
@@ -202,6 +237,25 @@ struct GeneralSettingsView: View {
  .padding(.vertical, 4)
  .background(.quaternary, in: RoundedRectangle(cornerRadius: 6))
  }
+
+ private func updateLaunchAtLogin(_ enabled: Bool) {
+ do {
+ try LaunchAtLoginService.setEnabled(enabled)
+ } catch {
+ Log.error("Failed to update launch at login: \(error.localizedDescription)")
+ launchAtLoginErrorMessage = String(
+ format: L("settings.launch_at_login_error"),
+ error.localizedDescription
+ )
+ showsLaunchAtLoginError = true
+ }
+ refreshLaunchAtLoginStatus()
+ }
+
+ private func refreshLaunchAtLoginStatus() {
+ launchAtLoginEnabled = LaunchAtLoginService.isEnabled
+ launchAtLoginRequiresApproval = LaunchAtLoginService.requiresApproval
+ }
 }
 
 private struct SettingsSectionHeader: View {

Tests/OpenTypeTests/LaunchAtLoginServiceTests.swift

@@ -0,0 +1,56 @@
+import ServiceManagement
+import XCTest
+@testable import OpenType
+
+final class LaunchAtLoginServiceTests: XCTestCase {
+ func testStatusMappingUsesEnabledAsTheOnlyActiveState() {
+ XCTAssertTrue(LaunchAtLoginService.isEnabled(status: .enabled))
+ XCTAssertFalse(LaunchAtLoginService.isEnabled(status: .notRegistered))
+ XCTAssertFalse(LaunchAtLoginService.isEnabled(status: .requiresApproval))
+ XCTAssertTrue(LaunchAtLoginService.requiresApproval(status: .requiresApproval))
+ }
+
+ func testEnablingRegistersOnlyWhenNeeded() throws {
+ let disabledService = LoginItemServiceStub(status: .notRegistered)
+ try LaunchAtLoginService.setEnabled(true, service: disabledService)
+ XCTAssertEqual(disabledService.registerCallCount, 1)
+
+ let enabledService = LoginItemServiceStub(status: .enabled)
+ try LaunchAtLoginService.setEnabled(true, service: enabledService)
+ XCTAssertEqual(enabledService.registerCallCount, 0)
+
+ let approvalService = LoginItemServiceStub(status: .requiresApproval)
+ try LaunchAtLoginService.setEnabled(true, service: approvalService)
+ XCTAssertEqual(approvalService.registerCallCount, 0)
+ }
+
+ func testDisablingUnregistersOnlyWhenNeeded() throws {
+ let enabledService = LoginItemServiceStub(status: .enabled)
+ try LaunchAtLoginService.setEnabled(false, service: enabledService)
+ XCTAssertEqual(enabledService.unregisterCallCount, 1)
+
+ let disabledService = LoginItemServiceStub(status: .notRegistered)
+ try LaunchAtLoginService.setEnabled(false, service: disabledService)
+ XCTAssertEqual(disabledService.unregisterCallCount, 0)
+ }
+}
+
+private final class LoginItemServiceStub: LoginItemServicing {
+ var status: SMAppService.Status
+ private(set) var registerCallCount = 0
+ private(set) var unregisterCallCount = 0
+
+ init(status: SMAppService.Status) {
+ self.status = status
+ }
+
+ func register() throws {
+ registerCallCount += 1
+ status = .enabled
+ }
+
+ func unregister() throws {
+ unregisterCallCount += 1
+ status = .notRegistered
+ }
+}

Sources/Config/LaunchAtLoginService.swift

@@ -0,0 +1,41 @@
+import ServiceManagement
+
+protocol LoginItemServicing {
+ var status: SMAppService.Status { get }
+ func register() throws
+ func unregister() throws
+}
+
+extension SMAppService: LoginItemServicing {}
+
+enum LaunchAtLoginService {
+ static var isEnabled: Bool {
+ isEnabled(status: SMAppService.mainApp.status)
+ }
+
+ static var requiresApproval: Bool {
+ requiresApproval(status: SMAppService.mainApp.status)
+ }
+
+ static func setEnabled(_ enabled: Bool) throws {
+ try setEnabled(enabled, service: SMAppService.mainApp)
+ }
+
+ static func isEnabled(status: SMAppService.Status) -> Bool {
+ status == .enabled
+ }
+
+ static func requiresApproval(status: SMAppService.Status) -> Bool {
+ status == .requiresApproval
+ }
+
+ static func setEnabled(_ enabled: Bool, service: LoginItemServicing) throws {
+ if enabled {
+ guard service.status != .enabled, service.status != .requiresApproval else { return }
+ try service.register()
+ } else {
+ guard service.status != .notRegistered else { return }
+ try service.unregister()
+ }
+ }
+}

Sources/Resources/en.lproj/Localizable.strings

@@ -97,6 +97,12 @@
 
 /* ── Settings ── */
 "settings.activation" = "Activation";
+"settings.startup" = "Startup";
+"settings.launch_at_login" = "Launch at login";
+"settings.launch_at_login_help" = "Automatically start Utter when you log in to your Mac.";
+"settings.launch_at_login_requires_approval" = "Allow Utter in System Settings → General → Login Items.";
+"settings.launch_at_login_error_title" = "Login Item Could Not Be Updated";
+"settings.launch_at_login_error" = "Utter could not update its login item: %@";
 "settings.interface" = "Interface";
 "settings.recognition" = "Recognition";
 "settings.audio" = "Audio";

Sources/Resources/zh-Hans.lproj/Localizable.strings

@@ -97,6 +97,12 @@
 
 /* ── Settings ── */
 "settings.activation" = "激活方式";
+"settings.startup" = "启动";
+"settings.launch_at_login" = "登录时启动";
+"settings.launch_at_login_help" = "登录 Mac 后自动启动 Utter。";
+"settings.launch_at_login_requires_approval" = "请在“系统设置”→“通用”→“登录项”中允许 Utter。";
+"settings.launch_at_login_error_title" = "无法更新登录项";
+"settings.launch_at_login_error" = "Utter 无法更新登录项：%@";
 "settings.interface" = "界面";
 "settings.recognition" = "识别引擎";
 "settings.audio" = "音频";

Sources/UI/GeneralSettingsView.swift

@@ -1,7 +1,12 @@
+import AppKit
 import SwiftUI
 
 struct GeneralSettingsView: View {
  @EnvironmentObject private var settings: AppSettings
+ @State private var launchAtLoginEnabled = false
+ @State private var launchAtLoginRequiresApproval = false
+ @State private var launchAtLoginErrorMessage = ""
+ @State private var showsLaunchAtLoginError = false
 
  var body: some View {
  VStack(spacing: 0) {
@@ -19,6 +24,15 @@ struct GeneralSettingsView: View {
  settingsForm
  }
  .settingsPageSurface()
+ .onAppear(perform: refreshLaunchAtLoginStatus)
+ .onReceive(NotificationCenter.default.publisher(for: NSApplication.didBecomeActiveNotification)) { _ in
+ refreshLaunchAtLoginStatus()
+ }
+ .alert(L("settings.launch_at_login_error_title"), isPresented: $showsLaunchAtLoginError) {
+ Button(L("common.ok"), role: .cancel) {}
+ } message: {
+ Text(launchAtLoginErrorMessage)
+ }
  }
 
  private var settingsForm: some View {
@@ -134,6 +148,27 @@ struct GeneralSettingsView: View {
  Text(L("settings.memory_help"))
  }
 
+ Section {
+ Toggle(isOn: Binding(
+ get: { launchAtLoginEnabled },
+ set: updateLaunchAtLogin
+ )) {
+ VStack(alignment: .leading, spacing: 2) {
+ Text(L("settings.launch_at_login"))
+ Text(L("settings.launch_at_login_help"))
+ .font(.caption)
+ .foregroundStyle(.secondary)
+ }
+ }
+ if launchAtLoginRequiresApproval {
+ Label(L("settings.launch_at_login_requires_approval"), systemImage: "exclamationmark.triangle")
+ .font(.caption)
+ .foregroundStyle(.orange)
+ }
+ } header: {
+ SettingsSectionHeader(title: L("settings.startup"), symbol: "power")
+ }
+
  Section {
  Picker(L("settings.ui_language"), selection: $settings.uiLanguage) {
  ForEach(UILanguage.allCases, id: \.self) { language in
@@ -202,6 +237,25 @@ struct GeneralSettingsView: View {
  .padding(.vertical, 4)
  .background(.quaternary, in: RoundedRectangle(cornerRadius: 6))
  }
+
+ private func updateLaunchAtLogin(_ enabled: Bool) {
+ do {
+ try LaunchAtLoginService.setEnabled(enabled)
+ } catch {
+ Log.error("Failed to update launch at login: \(error.localizedDescription)")
+ launchAtLoginErrorMessage = String(
+ format: L("settings.launch_at_login_error"),
+ error.localizedDescription
+ )
+ showsLaunchAtLoginError = true
+ }
+ refreshLaunchAtLoginStatus()
+ }
+
+ private func refreshLaunchAtLoginStatus() {
+ launchAtLoginEnabled = LaunchAtLoginService.isEnabled
+ launchAtLoginRequiresApproval = LaunchAtLoginService.requiresApproval
+ }
 }
 
 private struct SettingsSectionHeader: View {

Tests/OpenTypeTests/LaunchAtLoginServiceTests.swift

@@ -0,0 +1,56 @@
+import ServiceManagement
+import XCTest
+@testable import OpenType
+
+final class LaunchAtLoginServiceTests: XCTestCase {
+ func testStatusMappingUsesEnabledAsTheOnlyActiveState() {
+ XCTAssertTrue(LaunchAtLoginService.isEnabled(status: .enabled))
+ XCTAssertFalse(LaunchAtLoginService.isEnabled(status: .notRegistered))
+ XCTAssertFalse(LaunchAtLoginService.isEnabled(status: .requiresApproval))
+ XCTAssertTrue(LaunchAtLoginService.requiresApproval(status: .requiresApproval))
+ }
+
+ func testEnablingRegistersOnlyWhenNeeded() throws {
+ let disabledService = LoginItemServiceStub(status: .notRegistered)
+ try LaunchAtLoginService.setEnabled(true, service: disabledService)
+ XCTAssertEqual(disabledService.registerCallCount, 1)
+
+ let enabledService = LoginItemServiceStub(status: .enabled)
+ try LaunchAtLoginService.setEnabled(true, service: enabledService)
+ XCTAssertEqual(enabledService.registerCallCount, 0)
+
+ let approvalService = LoginItemServiceStub(status: .requiresApproval)
+ try LaunchAtLoginService.setEnabled(true, service: approvalService)
+ XCTAssertEqual(approvalService.registerCallCount, 0)
+ }
+
+ func testDisablingUnregistersOnlyWhenNeeded() throws {
+ let enabledService = LoginItemServiceStub(status: .enabled)
+ try LaunchAtLoginService.setEnabled(false, service: enabledService)
+ XCTAssertEqual(enabledService.unregisterCallCount, 1)
+
+ let disabledService = LoginItemServiceStub(status: .notRegistered)
+ try LaunchAtLoginService.setEnabled(false, service: disabledService)
+ XCTAssertEqual(disabledService.unregisterCallCount, 0)
+ }
+}
+
+private final class LoginItemServiceStub: LoginItemServicing {
+ var status: SMAppService.Status
+ private(set) var registerCallCount = 0
+ private(set) var unregisterCallCount = 0
+
+ init(status: SMAppService.Status) {
+ self.status = status
+ }
+
+ func register() throws {
+ registerCallCount += 1
+ status = .enabled
+ }
+
+ func unregister() throws {
+ unregisterCallCount += 1
+ status = .notRegistered
+ }
+}

Sources/Config/LaunchAtLoginService.swift

@@ -0,0 +1,41 @@
+import ServiceManagement
+
+protocol LoginItemServicing {
+ var status: SMAppService.Status { get }
+ func register() throws
+ func unregister() throws
+}
+
+extension SMAppService: LoginItemServicing {}
+
+enum LaunchAtLoginService {
+ static var isEnabled: Bool {
+ isEnabled(status: SMAppService.mainApp.status)
+ }
+
+ static var requiresApproval: Bool {
+ requiresApproval(status: SMAppService.mainApp.status)
+ }
+
+ static func setEnabled(_ enabled: Bool) throws {
+ try setEnabled(enabled, service: SMAppService.mainApp)
+ }
+
+ static func isEnabled(status: SMAppService.Status) -> Bool {
+ status == .enabled
+ }
+
+ static func requiresApproval(status: SMAppService.Status) -> Bool {
+ status == .requiresApproval
+ }
+
+ static func setEnabled(_ enabled: Bool, service: LoginItemServicing) throws {
+ if enabled {
+ guard service.status != .enabled, service.status != .requiresApproval else { return }
+ try service.register()
+ } else {
+ guard service.status != .notRegistered else { return }
+ try service.unregister()
+ }
+ }
+}

Sources/Resources/en.lproj/Localizable.strings

@@ -97,6 +97,12 @@
 
 /* ── Settings ── */
 "settings.activation" = "Activation";
+"settings.startup" = "Startup";
+"settings.launch_at_login" = "Launch at login";
+"settings.launch_at_login_help" = "Automatically start Utter when you log in to your Mac.";
+"settings.launch_at_login_requires_approval" = "Allow Utter in System Settings → General → Login Items.";
+"settings.launch_at_login_error_title" = "Login Item Could Not Be Updated";
+"settings.launch_at_login_error" = "Utter could not update its login item: %@";
 "settings.interface" = "Interface";
 "settings.recognition" = "Recognition";
 "settings.audio" = "Audio";

Sources/Resources/zh-Hans.lproj/Localizable.strings

@@ -97,6 +97,12 @@
 
 /* ── Settings ── */
 "settings.activation" = "激活方式";
+"settings.startup" = "启动";
+"settings.launch_at_login" = "登录时启动";
+"settings.launch_at_login_help" = "登录 Mac 后自动启动 Utter。";
+"settings.launch_at_login_requires_approval" = "请在“系统设置”→“通用”→“登录项”中允许 Utter。";
+"settings.launch_at_login_error_title" = "无法更新登录项";
+"settings.launch_at_login_error" = "Utter 无法更新登录项：%@";
 "settings.interface" = "界面";
 "settings.recognition" = "识别引擎";
 "settings.audio" = "音频";

Sources/UI/GeneralSettingsView.swift

@@ -1,7 +1,12 @@
+import AppKit
 import SwiftUI
 
 struct GeneralSettingsView: View {
  @EnvironmentObject private var settings: AppSettings
+ @State private var launchAtLoginEnabled = false
+ @State private var launchAtLoginRequiresApproval = false
+ @State private var launchAtLoginErrorMessage = ""
+ @State private var showsLaunchAtLoginError = false
 
  var body: some View {
  VStack(spacing: 0) {
@@ -19,6 +24,15 @@ struct GeneralSettingsView: View {
  settingsForm
  }
  .settingsPageSurface()
+ .onAppear(perform: refreshLaunchAtLoginStatus)
+ .onReceive(NotificationCenter.default.publisher(for: NSApplication.didBecomeActiveNotification)) { _ in
+ refreshLaunchAtLoginStatus()
+ }
+ .alert(L("settings.launch_at_login_error_title"), isPresented: $showsLaunchAtLoginError) {
+ Button(L("common.ok"), role: .cancel) {}
+ } message: {
+ Text(launchAtLoginErrorMessage)
+ }
  }
 
  private var settingsForm: some View {
@@ -134,6 +148,27 @@ struct GeneralSettingsView: View {
  Text(L("settings.memory_help"))
  }
 
+ Section {
+ Toggle(isOn: Binding(
+ get: { launchAtLoginEnabled },
+ set: updateLaunchAtLogin
+ )) {
+ VStack(alignment: .leading, spacing: 2) {
+ Text(L("settings.launch_at_login"))
+ Text(L("settings.launch_at_login_help"))
+ .font(.caption)
+ .foregroundStyle(.secondary)
+ }
+ }
+ if launchAtLoginRequiresApproval {
+ Label(L("settings.launch_at_login_requires_approval"), systemImage: "exclamationmark.triangle")
+ .font(.caption)
+ .foregroundStyle(.orange)
+ }
+ } header: {
+ SettingsSectionHeader(title: L("settings.startup"), symbol: "power")
+ }
+
  Section {
  Picker(L("settings.ui_language"), selection: $settings.uiLanguage) {
  ForEach(UILanguage.allCases, id: \.self) { language in
@@ -202,6 +237,25 @@ struct GeneralSettingsView: View {
  .padding(.vertical, 4)
  .background(.quaternary, in: RoundedRectangle(cornerRadius: 6))
  }
+
+ private func updateLaunchAtLogin(_ enabled: Bool) {
+ do {
+ try LaunchAtLoginService.setEnabled(enabled)
+ } catch {
+ Log.error("Failed to update launch at login: \(error.localizedDescription)")
+ launchAtLoginErrorMessage = String(
+ format: L("settings.launch_at_login_error"),
+ error.localizedDescription
+ )
+ showsLaunchAtLoginError = true
+ }
+ refreshLaunchAtLoginStatus()
+ }
+
+ private func refreshLaunchAtLoginStatus() {
+ launchAtLoginEnabled = LaunchAtLoginService.isEnabled
+ launchAtLoginRequiresApproval = LaunchAtLoginService.requiresApproval
+ }
 }
 
 private struct SettingsSectionHeader: View {

Tests/OpenTypeTests/LaunchAtLoginServiceTests.swift

@@ -0,0 +1,56 @@
+import ServiceManagement
+import XCTest
+@testable import OpenType
+
+final class LaunchAtLoginServiceTests: XCTestCase {
+ func testStatusMappingUsesEnabledAsTheOnlyActiveState() {
+ XCTAssertTrue(LaunchAtLoginService.isEnabled(status: .enabled))
+ XCTAssertFalse(LaunchAtLoginService.isEnabled(status: .notRegistered))
+ XCTAssertFalse(LaunchAtLoginService.isEnabled(status: .requiresApproval))
+ XCTAssertTrue(LaunchAtLoginService.requiresApproval(status: .requiresApproval))
+ }
+
+ func testEnablingRegistersOnlyWhenNeeded() throws {
+ let disabledService = LoginItemServiceStub(status: .notRegistered)
+ try LaunchAtLoginService.setEnabled(true, service: disabledService)
+ XCTAssertEqual(disabledService.registerCallCount, 1)
+
+ let enabledService = LoginItemServiceStub(status: .enabled)
+ try LaunchAtLoginService.setEnabled(true, service: enabledService)
+ XCTAssertEqual(enabledService.registerCallCount, 0)
+
+ let approvalService = LoginItemServiceStub(status: .requiresApproval)
+ try LaunchAtLoginService.setEnabled(true, service: approvalService)
+ XCTAssertEqual(approvalService.registerCallCount, 0)
+ }
+
+ func testDisablingUnregistersOnlyWhenNeeded() throws {
+ let enabledService = LoginItemServiceStub(status: .enabled)
+ try LaunchAtLoginService.setEnabled(false, service: enabledService)
+ XCTAssertEqual(enabledService.unregisterCallCount, 1)
+
+ let disabledService = LoginItemServiceStub(status: .notRegistered)
+ try LaunchAtLoginService.setEnabled(false, service: disabledService)
+ XCTAssertEqual(disabledService.unregisterCallCount, 0)
+ }
+}
+
+private final class LoginItemServiceStub: LoginItemServicing {
+ var status: SMAppService.Status
+ private(set) var registerCallCount = 0
+ private(set) var unregisterCallCount = 0
+
+ init(status: SMAppService.Status) {
+ self.status = status
+ }
+
+ func register() throws {
+ registerCallCount += 1
+ status = .enabled
+ }
+
+ func unregister() throws {
+ unregisterCallCount += 1
+ status = .notRegistered
+ }
+}

Sources/Config/LaunchAtLoginService.swift

@@ -0,0 +1,41 @@
+import ServiceManagement
+
+protocol LoginItemServicing {
+ var status: SMAppService.Status { get }
+ func register() throws
+ func unregister() throws
+}
+
+extension SMAppService: LoginItemServicing {}
+
+enum LaunchAtLoginService {
+ static var isEnabled: Bool {
+ isEnabled(status: SMAppService.mainApp.status)
+ }
+
+ static var requiresApproval: Bool {
+ requiresApproval(status: SMAppService.mainApp.status)
+ }
+
+ static func setEnabled(_ enabled: Bool) throws {
+ try setEnabled(enabled, service: SMAppService.mainApp)
+ }
+
+ static func isEnabled(status: SMAppService.Status) -> Bool {
+ status == .enabled
+ }
+
+ static func requiresApproval(status: SMAppService.Status) -> Bool {
+ status == .requiresApproval
+ }
+
+ static func setEnabled(_ enabled: Bool, service: LoginItemServicing) throws {
+ if enabled {
+ guard service.status != .enabled, service.status != .requiresApproval else { return }
+ try service.register()
+ } else {
+ guard service.status != .notRegistered else { return }
+ try service.unregister()
+ }
+ }
+}

Sources/Resources/en.lproj/Localizable.strings

@@ -97,6 +97,12 @@
 
 /* ── Settings ── */
 "settings.activation" = "Activation";
+"settings.startup" = "Startup";
+"settings.launch_at_login" = "Launch at login";
+"settings.launch_at_login_help" = "Automatically start Utter when you log in to your Mac.";
+"settings.launch_at_login_requires_approval" = "Allow Utter in System Settings → General → Login Items.";
+"settings.launch_at_login_error_title" = "Login Item Could Not Be Updated";
+"settings.launch_at_login_error" = "Utter could not update its login item: %@";
 "settings.interface" = "Interface";
 "settings.recognition" = "Recognition";
 "settings.audio" = "Audio";

Sources/Resources/zh-Hans.lproj/Localizable.strings

@@ -97,6 +97,12 @@
 
 /* ── Settings ── */
 "settings.activation" = "激活方式";
+"settings.startup" = "启动";
+"settings.launch_at_login" = "登录时启动";
+"settings.launch_at_login_help" = "登录 Mac 后自动启动 Utter。";
+"settings.launch_at_login_requires_approval" = "请在“系统设置”→“通用”→“登录项”中允许 Utter。";
+"settings.launch_at_login_error_title" = "无法更新登录项";
+"settings.launch_at_login_error" = "Utter 无法更新登录项：%@";
 "settings.interface" = "界面";
 "settings.recognition" = "识别引擎";
 "settings.audio" = "音频";

Sources/UI/GeneralSettingsView.swift

@@ -1,7 +1,12 @@
+import AppKit
 import SwiftUI
 
 struct GeneralSettingsView: View {
  @EnvironmentObject private var settings: AppSettings
+ @State private var launchAtLoginEnabled = false
+ @State private var launchAtLoginRequiresApproval = false
+ @State private var launchAtLoginErrorMessage = ""
+ @State private var showsLaunchAtLoginError = false
 
  var body: some View {
  VStack(spacing: 0) {
@@ -19,6 +24,15 @@ struct GeneralSettingsView: View {
  settingsForm
  }
  .settingsPageSurface()
+ .onAppear(perform: refreshLaunchAtLoginStatus)
+ .onReceive(NotificationCenter.default.publisher(for: NSApplication.didBecomeActiveNotification)) { _ in
+ refreshLaunchAtLoginStatus()
+ }
+ .alert(L("settings.launch_at_login_error_title"), isPresented: $showsLaunchAtLoginError) {
+ Button(L("common.ok"), role: .cancel) {}
+ } message: {
+ Text(launchAtLoginErrorMessage)
+ }
  }
 
  private var settingsForm: some View {
@@ -134,6 +148,27 @@ struct GeneralSettingsView: View {
  Text(L("settings.memory_help"))
  }
 
+ Section {
+ Toggle(isOn: Binding(
+ get: { launchAtLoginEnabled },
+ set: updateLaunchAtLogin
+ )) {
+ VStack(alignment: .leading, spacing: 2) {
+ Text(L("settings.launch_at_login"))
+ Text(L("settings.launch_at_login_help"))
+ .font(.caption)
+ .foregroundStyle(.secondary)
+ }
+ }
+ if launchAtLoginRequiresApproval {
+ Label(L("settings.launch_at_login_requires_approval"), systemImage: "exclamationmark.triangle")
+ .font(.caption)
+ .foregroundStyle(.orange)
+ }
+ } header: {
+ SettingsSectionHeader(title: L("settings.startup"), symbol: "power")
+ }
+
  Section {
  Picker(L("settings.ui_language"), selection: $settings.uiLanguage) {
  ForEach(UILanguage.allCases, id: \.self) { language in
@@ -202,6 +237,25 @@ struct GeneralSettingsView: View {
  .padding(.vertical, 4)
  .background(.quaternary, in: RoundedRectangle(cornerRadius: 6))
  }
+
+ private func updateLaunchAtLogin(_ enabled: Bool) {
+ do {
+ try LaunchAtLoginService.setEnabled(enabled)
+ } catch {
+ Log.error("Failed to update launch at login: \(error.localizedDescription)")
+ launchAtLoginErrorMessage = String(
+ format: L("settings.launch_at_login_error"),
+ error.localizedDescription
+ )
+ showsLaunchAtLoginError = true
+ }
+ refreshLaunchAtLoginStatus()
+ }
+
+ private func refreshLaunchAtLoginStatus() {
+ launchAtLoginEnabled = LaunchAtLoginService.isEnabled
+ launchAtLoginRequiresApproval = LaunchAtLoginService.requiresApproval
+ }
 }
 
 private struct SettingsSectionHeader: View {

Tests/OpenTypeTests/LaunchAtLoginServiceTests.swift

@@ -0,0 +1,56 @@
+import ServiceManagement
+import XCTest
+@testable import OpenType
+
+final class LaunchAtLoginServiceTests: XCTestCase {
+ func testStatusMappingUsesEnabledAsTheOnlyActiveState() {
+ XCTAssertTrue(LaunchAtLoginService.isEnabled(status: .enabled))
+ XCTAssertFalse(LaunchAtLoginService.isEnabled(status: .notRegistered))
+ XCTAssertFalse(LaunchAtLoginService.isEnabled(status: .requiresApproval))
+ XCTAssertTrue(LaunchAtLoginService.requiresApproval(status: .requiresApproval))
+ }
+
+ func testEnablingRegistersOnlyWhenNeeded() throws {
+ let disabledService = LoginItemServiceStub(status: .notRegistered)
+ try LaunchAtLoginService.setEnabled(true, service: disabledService)
+ XCTAssertEqual(disabledService.registerCallCount, 1)
+
+ let enabledService = LoginItemServiceStub(status: .enabled)
+ try LaunchAtLoginService.setEnabled(true, service: enabledService)
+ XCTAssertEqual(enabledService.registerCallCount, 0)
+
+ let approvalService = LoginItemServiceStub(status: .requiresApproval)
+ try LaunchAtLoginService.setEnabled(true, service: approvalService)
+ XCTAssertEqual(approvalService.registerCallCount, 0)
+ }
+
+ func testDisablingUnregistersOnlyWhenNeeded() throws {
+ let enabledService = LoginItemServiceStub(status: .enabled)
+ try LaunchAtLoginService.setEnabled(false, service: enabledService)
+ XCTAssertEqual(enabledService.unregisterCallCount, 1)
+
+ let disabledService = LoginItemServiceStub(status: .notRegistered)
+ try LaunchAtLoginService.setEnabled(false, service: disabledService)
+ XCTAssertEqual(disabledService.unregisterCallCount, 0)
+ }
+}
+
+private final class LoginItemServiceStub: LoginItemServicing {
+ var status: SMAppService.Status
+ private(set) var registerCallCount = 0
+ private(set) var unregisterCallCount = 0
+
+ init(status: SMAppService.Status) {
+ self.status = status
+ }
+
+ func register() throws {
+ registerCallCount += 1
+ status = .enabled
+ }
+
+ func unregister() throws {
+ unregisterCallCount += 1
+ status = .notRegistered
+ }
+}

Sources/Config/LaunchAtLoginService.swift

@@ -0,0 +1,41 @@
+import ServiceManagement
+
+protocol LoginItemServicing {
+ var status: SMAppService.Status { get }
+ func register() throws
+ func unregister() throws
+}
+
+extension SMAppService: LoginItemServicing {}
+
+enum LaunchAtLoginService {
+ static var isEnabled: Bool {
+ isEnabled(status: SMAppService.mainApp.status)
+ }
+
+ static var requiresApproval: Bool {
+ requiresApproval(status: SMAppService.mainApp.status)
+ }
+
+ static func setEnabled(_ enabled: Bool) throws {
+ try setEnabled(enabled, service: SMAppService.mainApp)
+ }
+
+ static func isEnabled(status: SMAppService.Status) -> Bool {
+ status == .enabled
+ }
+
+ static func requiresApproval(status: SMAppService.Status) -> Bool {
+ status == .requiresApproval
+ }
+
+ static func setEnabled(_ enabled: Bool, service: LoginItemServicing) throws {
+ if enabled {
+ guard service.status != .enabled, service.status != .requiresApproval else { return }
+ try service.register()
+ } else {
+ guard service.status != .notRegistered else { return }
+ try service.unregister()
+ }
+ }
+}

Sources/Resources/en.lproj/Localizable.strings

@@ -97,6 +97,12 @@
 
 /* ── Settings ── */
 "settings.activation" = "Activation";
+"settings.startup" = "Startup";
+"settings.launch_at_login" = "Launch at login";
+"settings.launch_at_login_help" = "Automatically start Utter when you log in to your Mac.";
+"settings.launch_at_login_requires_approval" = "Allow Utter in System Settings → General → Login Items.";
+"settings.launch_at_login_error_title" = "Login Item Could Not Be Updated";
+"settings.launch_at_login_error" = "Utter could not update its login item: %@";
 "settings.interface" = "Interface";
 "settings.recognition" = "Recognition";
 "settings.audio" = "Audio";

Sources/Resources/zh-Hans.lproj/Localizable.strings

@@ -97,6 +97,12 @@
 
 /* ── Settings ── */
 "settings.activation" = "激活方式";
+"settings.startup" = "启动";
+"settings.launch_at_login" = "登录时启动";
+"settings.launch_at_login_help" = "登录 Mac 后自动启动 Utter。";
+"settings.launch_at_login_requires_approval" = "请在“系统设置”→“通用”→“登录项”中允许 Utter。";
+"settings.launch_at_login_error_title" = "无法更新登录项";
+"settings.launch_at_login_error" = "Utter 无法更新登录项：%@";
 "settings.interface" = "界面";
 "settings.recognition" = "识别引擎";
 "settings.audio" = "音频";

Sources/UI/GeneralSettingsView.swift

@@ -1,7 +1,12 @@
+import AppKit
 import SwiftUI
 
 struct GeneralSettingsView: View {
  @EnvironmentObject private var settings: AppSettings
+ @State private var launchAtLoginEnabled = false
+ @State private var launchAtLoginRequiresApproval = false
+ @State private var launchAtLoginErrorMessage = ""
+ @State private var showsLaunchAtLoginError = false
 
  var body: some View {
  VStack(spacing: 0) {
@@ -19,6 +24,15 @@ struct GeneralSettingsView: View {
  settingsForm
  }
  .settingsPageSurface()
+ .onAppear(perform: refreshLaunchAtLoginStatus)
+ .onReceive(NotificationCenter.default.publisher(for: NSApplication.didBecomeActiveNotification)) { _ in
+ refreshLaunchAtLoginStatus()
+ }
+ .alert(L("settings.launch_at_login_error_title"), isPresented: $showsLaunchAtLoginError) {
+ Button(L("common.ok"), role: .cancel) {}
+ } message: {
+ Text(launchAtLoginErrorMessage)
+ }
  }
 
  private var settingsForm: some View {
@@ -134,6 +148,27 @@ struct GeneralSettingsView: View {
  Text(L("settings.memory_help"))
  }
 
+ Section {
+ Toggle(isOn: Binding(
+ get: { launchAtLoginEnabled },
+ set: updateLaunchAtLogin
+ )) {
+ VStack(alignment: .leading, spacing: 2) {
+ Text(L("settings.launch_at_login"))
+ Text(L("settings.launch_at_login_help"))
+ .font(.caption)
+ .foregroundStyle(.secondary)
+ }
+ }
+ if launchAtLoginRequiresApproval {
+ Label(L("settings.launch_at_login_requires_approval"), systemImage: "exclamationmark.triangle")
+ .font(.caption)
+ .foregroundStyle(.orange)
+ }
+ } header: {
+ SettingsSectionHeader(title: L("settings.startup"), symbol: "power")
+ }
+
  Section {
  Picker(L("settings.ui_language"), selection: $settings.uiLanguage) {
  ForEach(UILanguage.allCases, id: \.self) { language in
@@ -202,6 +237,25 @@ struct GeneralSettingsView: View {
  .padding(.vertical, 4)
  .background(.quaternary, in: RoundedRectangle(cornerRadius: 6))
  }
+
+ private func updateLaunchAtLogin(_ enabled: Bool) {
+ do {
+ try LaunchAtLoginService.setEnabled(enabled)
+ } catch {
+ Log.error("Failed to update launch at login: \(error.localizedDescription)")
+ launchAtLoginErrorMessage = String(
+ format: L("settings.launch_at_login_error"),
+ error.localizedDescription
+ )
+ showsLaunchAtLoginError = true
+ }
+ refreshLaunchAtLoginStatus()
+ }
+
+ private func refreshLaunchAtLoginStatus() {
+ launchAtLoginEnabled = LaunchAtLoginService.isEnabled
+ launchAtLoginRequiresApproval = LaunchAtLoginService.requiresApproval
+ }
 }
 
 private struct SettingsSectionHeader: View {

Tests/OpenTypeTests/LaunchAtLoginServiceTests.swift

@@ -0,0 +1,56 @@
+import ServiceManagement
+import XCTest
+@testable import OpenType
+
+final class LaunchAtLoginServiceTests: XCTestCase {
+ func testStatusMappingUsesEnabledAsTheOnlyActiveState() {
+ XCTAssertTrue(LaunchAtLoginService.isEnabled(status: .enabled))
+ XCTAssertFalse(LaunchAtLoginService.isEnabled(status: .notRegistered))
+ XCTAssertFalse(LaunchAtLoginService.isEnabled(status: .requiresApproval))
+ XCTAssertTrue(LaunchAtLoginService.requiresApproval(status: .requiresApproval))
+ }
+
+ func testEnablingRegistersOnlyWhenNeeded() throws {
+ let disabledService = LoginItemServiceStub(status: .notRegistered)
+ try LaunchAtLoginService.setEnabled(true, service: disabledService)
+ XCTAssertEqual(disabledService.registerCallCount, 1)
+
+ let enabledService = LoginItemServiceStub(status: .enabled)
+ try LaunchAtLoginService.setEnabled(true, service: enabledService)
+ XCTAssertEqual(enabledService.registerCallCount, 0)
+
+ let approvalService = LoginItemServiceStub(status: .requiresApproval)
+ try LaunchAtLoginService.setEnabled(true, service: approvalService)
+ XCTAssertEqual(approvalService.registerCallCount, 0)
+ }
+
+ func testDisablingUnregistersOnlyWhenNeeded() throws {
+ let enabledService = LoginItemServiceStub(status: .enabled)
+ try LaunchAtLoginService.setEnabled(false, service: enabledService)
+ XCTAssertEqual(enabledService.unregisterCallCount, 1)
+
+ let disabledService = LoginItemServiceStub(status: .notRegistered)
+ try LaunchAtLoginService.setEnabled(false, service: disabledService)
+ XCTAssertEqual(disabledService.unregisterCallCount, 0)
+ }
+}
+
+private final class LoginItemServiceStub: LoginItemServicing {
+ var status: SMAppService.Status
+ private(set) var registerCallCount = 0
+ private(set) var unregisterCallCount = 0
+
+ init(status: SMAppService.Status) {
+ self.status = status
+ }
+
+ func register() throws {
+ registerCallCount += 1
+ status = .enabled
+ }
+
+ func unregister() throws {
+ unregisterCallCount += 1
+ status = .notRegistered
+ }
+}