Files

T

L'électron rare 9e1482e29d chore: archive legacy AV-Live-Body

Superseded by avlivebody-mac/ on 2026-05-18. See
docs/superpowers/specs/2026-05-18-avlivebody-macos-rewrite-design.md
for the rewrite design and rationale.

2026-05-18 21:54:48 +02:00

2.2 KiB

Raw Blame History

Note (2026-05-18): the AV-Live-Body directory has been archived to _archive-AV-Live-Body/ — superseded by the new app at /avlivebody-mac/. See docs/superpowers/specs/2026-05-18-avlivebody-macos-rewrite-design.md.

launcher — AVLiveLauncher

App menubar macOS (SwiftUI, SwiftPM, macOS 11+) qui démarre/arrête sclang+scsynth, le serveur web et oscope-of, log les sorties, et expose un mode picker.

Build

cd launcher
./build.sh                            # script standard
# ou manuellement :
swift build -c release
.build/release/AVLiveLauncher

Cible : macOS 11+, Swift 5.7+. Package Swift, pas de Xcode project requis.

Modules

Fichier	Rôle
`AVLiveLauncherApp.swift`	`@main`, scene menubar, app lifecycle
`MenuBarContent.swift`	UI du menu (start/stop, état des process)
`ModePickerWindow.swift`	Fenêtre picker de mode (data-only vs full vs ...)
`ProcessManager.swift`	Spawn / kill / monitor des process enfants
`OSCSender.swift`	Envoi OSC (typiquement vers `:57121` sclang, `:57123` oscope)
`LogView.swift`	UI live des logs stdout/stderr des process
`AV-Live-Body/`	Ressources / modèles annexes (body mesh assets)

Conventions

Toute opération asynchrone : Task { @MainActor in ... } pour UI updates.
Pas de bloc DispatchQueue.main.sync (deadlock garanti depuis MainActor).
ProcessManager est @MainActor — interactions process via async/await, jamais Process.waitUntilExit() bloquant en main.
Chemins absolus vers les binaires (sclang, node, oscope-of) résolus une fois au startup et stockés ; ne pas redécouvrir à chaque démarrage.
Logs ring-buffer borné (pas de croissance illimitée dans LogView).

Anti-patterns

Ne pas committer build/ ni .build/.
Ne pas hardcoder un chemin utilisateur (/Users/electron/...) — passer par FileManager + chemins relatifs au repo ou bookmarks.
Ne pas mélanger Process.terminate() et kill -9 sans escalade (SIGTERM → wait → SIGKILL).
Pas d'AppKit NSApp.terminate direct depuis un closure background — toujours hop sur MainActor.
Ne pas dépendre d'un Xcode project : le SwiftPM Package.swift est la source de vérité.

2.2 KiB Raw Blame History