Phase 2 abgeschlossen: Einstellungsfenster und Lokalisierung

Einstellungen wirken sofort statt erst nach einem Neustart. In einer App ohne
Fenster ist eine verzögerte Änderung praktisch unauffindbar — man sieht ja
nicht, dass etwas passiert ist. AppModel meldet Layout- und Anzeigeänderungen
an den Koordinator, das Panel zeichnet sich neu und die Panelgröße zieht mit.

Widgets lassen sich hinzufügen, entfernen, in der Größe ändern und per
Drag-and-Drop umsortieren. Angeboten werden nur die Größen, die ein Widget
sinnvoll ausfüllt — ein Mini-Monat in 1x1 wäre unleserlich.

Lokalisierung als String Catalog in DE und EN, Quellsprache Englisch damit die
Schlüssel im Code lesbar bleiben. Der Katalog von OnyxCore musste ausdrücklich
als Ressource deklariert werden: ohne das gibt es kein Bundle.module und die
Übersetzungen wären zur Laufzeit unauffindbar. Im gebauten Bundle liegen jetzt
de.lproj und en.lproj, auch für das Paket.

Kein Menüleisten-Tab: solange es keine Module gibt, wäre das eine Oberfläche
für ein Feature, das noch nicht existiert. Er kommt mit Phase 5.

80 Tests grün.
This commit is contained in:
Guido Schmit
2026-08-10 18:03:34 +02:00
parent c0eb44b0b0
commit dd25d788c0
8 changed files with 533 additions and 32 deletions

98
Onyx/AppModel.swift Normal file
View File

@@ -0,0 +1,98 @@
import SwiftUI
import OnyxNotch
import OnyxWidgetKit
/// Der geteilte Zustand von Onyx: was im Panel liegt und auf welchen Displays.
///
/// Änderungen wirken sofort. Eine Einstellung, die erst nach einem Neustart
/// greift, ist in einer App ohne Fenster praktisch unauffindbar man sieht ja
/// nicht, dass etwas passiert ist.
@MainActor
@Observable
final class AppModel {
private let store: LayoutStore
private let defaults: UserDefaults
/// Wird gerufen, wenn sich die Panelgröße geändert haben könnte.
var onLayoutChanged: (([WidgetPlacement]) -> Void)?
/// Wird gerufen, wenn Panels auf anderen Displays erscheinen sollen.
var onDisplayPolicyChanged: ((DisplayPolicy) -> Void)?
var layout: [WidgetPlacement] {
didSet {
guard layout != oldValue else { return }
persistLayout()
onLayoutChanged?(layout)
}
}
var displayPolicy: DisplayPolicy {
didSet {
guard displayPolicy != oldValue else { return }
defaults.set(displayPolicy.rawValue, forKey: Keys.displayPolicy)
onDisplayPolicyChanged?(displayPolicy)
}
}
var showsMenuBarIcon: Bool {
didSet { defaults.set(showsMenuBarIcon, forKey: Keys.showsMenuBarIcon) }
}
private enum Keys {
static let displayPolicy = "onyx.displayPolicy"
static let showsMenuBarIcon = "onyx.showsMenuBarIcon"
}
init(store: LayoutStore = .standard(), defaults: UserDefaults = .standard) {
self.store = store
self.defaults = defaults
let known = Set(WidgetRegistry.shared.all.map(\.id))
self.layout = store.load(knownWidgetIDs: known)
self.displayPolicy = defaults.string(forKey: Keys.displayPolicy)
.flatMap(DisplayPolicy.init(rawValue:)) ?? .builtInOnly
// Standardmäßig sichtbar: das Menüleistensymbol ist der einzige Weg
// zurück, wenn die Notch einmal nicht reagiert.
self.showsMenuBarIcon = defaults.object(forKey: Keys.showsMenuBarIcon) as? Bool ?? true
}
// MARK: - Widgets
var panelContentSize: CGSize { WidgetGrid.panelSize(for: layout) }
func isInPanel(_ widgetID: String) -> Bool {
layout.contains { $0.widgetID == widgetID }
}
func add(_ widget: any OnyxWidget) {
guard !isInPanel(widget.id) else { return }
let size = widget.supportedSizes.first ?? .small
layout.append(WidgetPlacement(widgetID: widget.id, size: size))
}
func remove(_ widgetID: String) {
layout.removeAll { $0.widgetID == widgetID }
}
func setSize(_ size: WidgetSize, for widgetID: String) {
guard let index = layout.firstIndex(where: { $0.widgetID == widgetID }) else { return }
layout[index].size = size
}
func move(fromOffsets source: IndexSet, toOffset destination: Int) {
layout.move(fromOffsets: source, toOffset: destination)
}
private func persistLayout() {
do {
try store.save(layout)
} catch {
// Ein fehlgeschlagener Schreibvorgang darf die App nicht anhalten;
// beim nächsten Start greift dann das Standardlayout.
NSLog("Onyx: Layout konnte nicht gespeichert werden — \(error.localizedDescription)")
}
}
}

135
Onyx/Localizable.xcstrings Normal file
View File

@@ -0,0 +1,135 @@
{
"sourceLanguage" : "en",
"strings" : {
"menu.openPanel" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Panel öffnen" } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "Open Panel" } }
}
},
"menu.settings" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Einstellungen …" } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "Settings…" } }
}
},
"menu.quit" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Onyx beenden" } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "Quit Onyx" } }
}
},
"settings.tab.widgets" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Widgets" } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "Widgets" } }
}
},
"settings.tab.display" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Anzeige" } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "Display" } }
}
},
"settings.widgets.hint" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Die Reihenfolge bestimmt die Anordnung im Panel. Jedes Widget rückt an die erste Stelle, an die es passt." } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "The order determines the arrangement in the panel. Each widget takes the first spot it fits into." } }
}
},
"settings.widgets.inPanel" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Im Panel" } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "In the panel" } }
}
},
"settings.widgets.available" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Verfügbar" } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "Available" } }
}
},
"settings.widgets.empty" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Keine Widgets im Panel. Das Panel bleibt leer, bis du eins hinzufügst." } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "No widgets in the panel. It stays empty until you add one." } }
}
},
"settings.widgets.add" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Hinzufügen" } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "Add" } }
}
},
"settings.widgets.remove" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Aus dem Panel entfernen" } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "Remove from panel" } }
}
},
"settings.size.small" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Klein (1×1)" } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "Small (1×1)" } }
}
},
"settings.size.medium" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Mittel (2×1)" } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "Medium (2×1)" } }
}
},
"settings.size.large" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Groß (2×2)" } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "Large (2×2)" } }
}
},
"settings.size.wide" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Breit (4×1)" } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "Wide (4×1)" } }
}
},
"settings.display.policy" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Panel anzeigen auf" } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "Show panel on" } }
}
},
"settings.display.builtInOnly" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Nur dem internen Display" } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "Built-in display only" } }
}
},
"settings.display.all" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Allen Displays" } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "All displays" } }
}
},
"settings.display.hint" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Auf Displays ohne echte Notch erscheint oben mittig ein Balken, der sich genauso verhält. Ist der Deckel geschlossen und kein internes Display vorhanden, erscheint das Panel trotzdem auf einem externen — sonst wäre Onyx nicht erreichbar." } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "On displays without a real notch, a bar appears at the top centre and behaves the same. With the lid closed and no built-in display present, the panel still appears on an external one — otherwise Onyx would be unreachable." } }
}
},
"settings.display.menuBarIcon" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Symbol in der Menüleiste anzeigen" } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "Show icon in the menu bar" } }
}
},
"settings.display.menuBarIcon.hint" : {
"localizations" : {
"de" : { "stringUnit" : { "state" : "translated", "value" : "Über das Symbol erreichst du Panel, Einstellungen und Beenden. Ohne es kommst du nur über die Notch an Onyx heran." } },
"en" : { "stringUnit" : { "state" : "translated", "value" : "The icon gives you the panel, settings and quit. Without it, the notch is the only way to reach Onyx." } }
}
}
},
"version" : "1.0"
}

View File

@@ -11,21 +11,29 @@ struct OnyxApp: App {
@NSApplicationDelegateAdaptor(AppDelegate.self) private var delegate
var body: some Scene {
// Onyx hat kein Hauptfenster. Alles lebt im Notch-Panel und in der
// Menüleiste; die Einstellungen kommen in Phase 2 als eigenes Fenster.
Settings { EmptyView() }
// Onyx hat kein Hauptfenster alles lebt in der Notch und in der
// Menüleiste. Die Einstellungen sind die einzige Ausnahme; im Panel
// wäre dafür zu wenig Platz.
Settings {
if let model = delegate.model {
SettingsView(model: model)
} else {
// Nur sichtbar, wenn die Einzelinstanz-Prüfung uns abgewiesen
// hat und die App gerade wieder verschwindet.
ProgressView().frame(width: 520, height: 420)
}
}
}
}
@MainActor
final class AppDelegate: NSObject, NSApplicationDelegate {
private(set) var model: AppModel?
private var coordinator: NotchCoordinator?
private var menuBar: MenuBarController?
private var onyxItem: NSStatusItem?
private var layout: [WidgetPlacement] = []
func applicationDidFinishLaunching(_ notification: Notification) {
NSApp.setActivationPolicy(.accessory)
@@ -39,29 +47,35 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
}
PlaceholderWidgets.registerAll()
let known = Set(WidgetRegistry.shared.all.map(\.id))
layout = LayoutStore.standard().load(knownWidgetIDs: known)
let placements = layout
let coordinator = NotchCoordinator(policy: .builtInOnly) { _, presentation in
let model = AppModel()
self.model = model
let coordinator = NotchCoordinator(policy: model.displayPolicy) { _, presentation in
NotchHostingView(
rootView: NotchContainer(presentation: presentation) {
WidgetGrid(placements: placements)
NotchPanelContent(model: model)
},
presentation: presentation)
}
coordinator.start()
// Die Panelgröße folgt dem Layout, nicht umgekehrt: wer ein Widget
// hinzufügt, soll nicht auch noch die Fenstergröße nachziehen müssen.
let size = WidgetGrid.panelSize(for: layout)
coordinator.activeControllers.forEach { $0.contentSize = size }
self.coordinator = coordinator
applyContentSize()
// Einstellungen wirken sofort. Eine Änderung, die erst nach einem
// Neustart greift, ist in einer App ohne Fenster praktisch unauffindbar.
model.onLayoutChanged = { [weak self] _ in self?.applyContentSize() }
model.onDisplayPolicyChanged = { [weak self] policy in
self?.coordinator?.policy = policy
self?.applyContentSize()
}
let menuBar = MenuBarController()
menuBar.start()
self.menuBar = menuBar
installOnyxStatusItem()
observeMenuBarPreference()
}
func applicationWillTerminate(_ notification: Notification) {
@@ -69,6 +83,14 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
menuBar?.stop()
}
private func applyContentSize() {
guard let model, let coordinator else { return }
let size = model.panelContentSize
coordinator.activeControllers.forEach { $0.contentSize = size }
}
// MARK: - Menüleiste
/// Das feste Onyx-Element: Panel öffnen, Einstellungen, Beenden. Es ist auch
/// das Sicherheitsnetz, falls die Notch einmal nicht reagiert.
private func installOnyxStatusItem() {
@@ -79,19 +101,32 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
item.button?.image?.isTemplate = true
let menu = NSMenu()
menu.addItem(withTitle: "Panel öffnen", action: #selector(togglePanel), keyEquivalent: "")
.target = self
menu.addItem(withTitle: String(localized: "menu.openPanel"),
action: #selector(togglePanel), keyEquivalent: "").target = self
menu.addItem(.separator())
menu.addItem(withTitle: "Einstellungen …", action: #selector(openSettings), keyEquivalent: ",")
.target = self
menu.addItem(withTitle: String(localized: "menu.settings"),
action: #selector(openSettings), keyEquivalent: ",").target = self
menu.addItem(.separator())
menu.addItem(withTitle: "Onyx beenden", action: #selector(quit), keyEquivalent: "q")
.target = self
menu.addItem(withTitle: String(localized: "menu.quit"),
action: #selector(quit), keyEquivalent: "q").target = self
item.menu = menu
onyxItem = item
}
private func observeMenuBarPreference() {
guard let model else { return }
withObservationTracking {
_ = model.showsMenuBarIcon
} onChange: {
Task { @MainActor [weak self] in
self?.onyxItem?.isVisible = model.showsMenuBarIcon
self?.observeMenuBarPreference()
}
}
onyxItem?.isVisible = model.showsMenuBarIcon
}
@objc private func togglePanel() { coordinator?.togglePanelUnderPointer() }
@objc private func openSettings() {
@@ -102,3 +137,12 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
@objc private func quit() { NSApp.terminate(nil) }
}
/// Der Inhalt des Panels. Liest `model.layout` und zeichnet sich damit neu,
/// sobald in den Einstellungen etwas geändert wird.
private struct NotchPanelContent: View {
let model: AppModel
var body: some View {
WidgetGrid(placements: model.layout)
}
}

143
Onyx/SettingsView.swift Normal file
View File

@@ -0,0 +1,143 @@
import SwiftUI
import OnyxDesign
import OnyxNotch
import OnyxWidgetKit
struct SettingsView: View {
@Bindable var model: AppModel
var body: some View {
TabView {
WidgetSettings(model: model)
.tabItem { Label("settings.tab.widgets", systemImage: "square.grid.2x2") }
DisplaySettings(model: model)
.tabItem { Label("settings.tab.display", systemImage: "macbook") }
}
.frame(width: 520, height: 420)
}
}
// MARK: - Widgets
private struct WidgetSettings: View {
@Bindable var model: AppModel
var body: some View {
VStack(alignment: .leading, spacing: 12) {
Text("settings.widgets.hint")
.font(.callout)
.foregroundStyle(.secondary)
List {
Section("settings.widgets.inPanel") {
// Die Reihenfolge hier ist die Reihenfolge im Panel: die
// Layout-Engine setzt die Widgets von oben links der Reihe
// nach ein.
ForEach(model.layout) { placement in
if let widget = WidgetRegistry.shared.widget(id: placement.widgetID) {
PlacementRow(model: model, placement: placement, widget: widget)
}
}
.onMove { model.move(fromOffsets: $0, toOffset: $1) }
if model.layout.isEmpty {
Text("settings.widgets.empty")
.foregroundStyle(.secondary)
}
}
let available = WidgetRegistry.shared.all.filter { !model.isInPanel($0.id) }
if !available.isEmpty {
Section("settings.widgets.available") {
ForEach(available, id: \.id) { widget in
HStack {
Label(widget.displayName, systemImage: widget.symbolName)
Spacer()
Button("settings.widgets.add") { model.add(widget) }
.buttonStyle(.borderless)
}
}
}
}
}
.listStyle(.inset)
}
.padding()
}
}
private struct PlacementRow: View {
@Bindable var model: AppModel
let placement: WidgetPlacement
let widget: any OnyxWidget
var body: some View {
HStack {
Label(widget.displayName, systemImage: widget.symbolName)
Spacer()
// Nur die Größen anbieten, die das Widget auch sinnvoll ausfüllt.
// Ein Mini-Monat in 1×1 wäre unleserlich.
Picker("", selection: Binding(
get: { placement.size },
set: { model.setSize($0, for: placement.widgetID) })) {
ForEach(widget.supportedSizes) { size in
Text(size.localizedName).tag(size)
}
}
.labelsHidden()
.frame(width: 130)
Button {
model.remove(placement.widgetID)
} label: {
Image(systemName: "minus.circle")
}
.buttonStyle(.borderless)
.help("settings.widgets.remove")
}
}
}
// MARK: - Anzeige
private struct DisplaySettings: View {
@Bindable var model: AppModel
var body: some View {
Form {
Picker("settings.display.policy", selection: $model.displayPolicy) {
Text("settings.display.builtInOnly").tag(DisplayPolicy.builtInOnly)
Text("settings.display.all").tag(DisplayPolicy.allDisplays)
}
.pickerStyle(.radioGroup)
Text("settings.display.hint")
.font(.callout)
.foregroundStyle(.secondary)
.fixedSize(horizontal: false, vertical: true)
Divider()
Toggle("settings.display.menuBarIcon", isOn: $model.showsMenuBarIcon)
Text("settings.display.menuBarIcon.hint")
.font(.callout)
.foregroundStyle(.secondary)
.fixedSize(horizontal: false, vertical: true)
}
.formStyle(.grouped)
.padding()
}
}
extension WidgetSize {
var localizedName: LocalizedStringKey {
switch self {
case .small: "settings.size.small"
case .medium: "settings.size.medium"
case .large: "settings.size.large"
case .wide: "settings.size.wide"
}
}
}