AntigravityでmacOSメニューバーアプリを完全制作する — SwiftUI × StatusItem × Shortcuts連携の実装マスタークラス

# Project Context
 
## Platform
macOS 13+ (Universal Binary: Apple Silicon + Intel)
Swift 5.10 / SwiftUI + AppKit hybrid
Deployment target: macOS 13.0
 
## App Type
MenuBar-only app (no Dock icon)
LSUIElement = YES in Info.plist
 
## Key Frameworks
- SwiftUI (MenuBarExtra API)
- AppKit (NSStatusItem for advanced customization)
- ServiceManagement (LaunchAtLogin)
- AppIntents (Shortcuts integration)
 
## Architecture
MVVM. ObservableObject for state. No UIKit dependency.

// MyMenuBarApp.swift
import SwiftUI
 
@main
struct MyMenuBarApp: App {
    var body: some Scene {
        MenuBarExtra("MyApp", systemImage: "star.fill") {
            // ここに表示するView
            ContentView()
        }
        .menuBarExtraStyle(.window) // または .menu
    }
}

<\!-- Info.plist -->
<key>LSUIElement</key>
<true/>

// StatusBarController.swift
import AppKit
import SwiftUI
 
class StatusBarController: NSObject {
    private var statusItem: NSStatusItem
    private var popover: NSPopover
    
    override init() {
        // ステータスバーアイテムの作成
        statusItem = NSStatusBar.system.statusItem(
            withLength: NSStatusItem.squareLength
        )
        
        // ポップオーバーの設定
        popover = NSPopover()
        popover.contentSize = NSSize(width: 320, height: 480)
        popover.behavior = .transient // 他の場所クリックで自動的に閉じる
        popover.contentViewController = NSHostingController(
            rootView: ContentView()
        )
        
        super.init()
        
        // アイコンの設定
        if let button = statusItem.button {
            button.image = NSImage(systemSymbolName: "star.fill",
                                   accessibilityDescription: "MyApp")
            button.action = #selector(togglePopover)
            button.target = self
        }
    }
    
    @objc func togglePopover() {
        guard let button = statusItem.button else { return }
        
        if popover.isShown {
            popover.performClose(nil)
        } else {
            popover.show(relativeTo: button.bounds,
                        of: button,
                        preferredEdge: .minY)
            // ポップオーバーにフォーカスを与える
            popover.contentViewController?.view.window?.makeKeyAndOrderFront(nil)
        }
    }
}

// AppState.swift
import Foundation
import Combine
 
@MainActor
class AppState: ObservableObject {
    @Published var isRunning: Bool = false
    @Published var message: String = ""
    
    func toggle() {
        isRunning.toggle()
        message = isRunning ? "実行中" : "停止"
    }
}

// MyMenuBarApp.swift
@main
struct MyMenuBarApp: App {
    @StateObject private var appState = AppState()
    
    var body: some Scene {
        MenuBarExtra("MyApp", systemImage: appState.isRunning ? "play.fill" : "stop.fill") {
            ContentView()
                .environmentObject(appState)
        }
        .menuBarExtraStyle(.window)
    }
}

// Intents/ToggleAppIntent.swift
import AppIntents
 
struct ToggleRunningIntent: AppIntent {
    static var title: LocalizedStringResource = "実行/停止を切り替える"
    static var description = IntentDescription("MyAppの実行状態を切り替えます")
    
    // Siri・Shortcutsからパラメータを受け取る例
    @Parameter(title: "メッセージ", optionsProvider: nil)
    var customMessage: String?
    
    func perform() async throws -> some IntentResult & ProvidesDialog {
        // AppStateへのアクセス（シングルトンを使う場合）
        await MainActor.run {
            AppStateStore.shared.appState.toggle()
            if let msg = customMessage {
                AppStateStore.shared.appState.message = msg
            }
        }
        
        let resultMessage = AppStateStore.shared.appState.isRunning
            ? "MyAppを開始しました"
            : "MyAppを停止しました"
        
        return .result(dialog: IntentDialog(stringLiteral: resultMessage))
    }
}

// Shortcuts自動登録（App起動時に呼ぶ）
struct MyAppShortcuts: AppShortcutsProvider {
    static var appShortcuts: [AppShortcut] {
        AppShortcut(
            intent: ToggleRunningIntent(),
            phrases: [
                "MyAppを\(.applicationName)で切り替えて",
                "Toggle \(.applicationName)"
            ],
            shortTitle: "実行/停止",
            systemImageName: "play.pause.fill"
        )
    }
}

import ServiceManagement
 
// ログイン時起動を登録
func enableLaunchAtLogin() throws {
    // ヘルパーアプリを使う場合は SMAppService.loginItem(identifier:)
    // メインアプリ自体をログイン時起動させる場合:
    try SMAppService.mainApp.register()
}
 
// 登録解除
func disableLaunchAtLogin() throws {
    try SMAppService.mainApp.unregister()
}
 
// 現在の状態確認
var isLaunchAtLoginEnabled: Bool {
    SMAppService.mainApp.status == .enabled
}

// Info.plist にURLスキームを登録後
// myapp://action?param=value の形式で受け取る
 
// AppDelegate.swift または Scene
func application(_ application: NSApplication,
                 open urls: [URL]) {
    for url in urls {
        handleURL(url)
    }
}
 
func handleURL(_ url: URL) {
    guard url.scheme == "myapp",
          let components = URLComponents(url: url, resolvingAgainstBaseURL: false),
          let action = url.host else { return }
    
    switch action {
    case "toggle":
        AppStateStore.shared.appState.toggle()
    case "message":
        let msg = components.queryItems?.first(where: { $0.name == "text" })?.value
        AppStateStore.shared.appState.message = msg ?? ""
    default:
        break
    }
}

// Security-Scoped Bookmarkで永続的なアクセス権を確保
func saveBookmark(for url: URL) throws -> Data {
    return try url.bookmarkData(
        options: .withSecurityScope,
        includingResourceValuesForKeys: nil,
        relativeTo: nil
    )
}
 
func restoreAccess(from bookmarkData: Data) throws -> URL {
    var isStale = false
    let url = try URL(
        resolvingBookmarkData: bookmarkData,
        options: .withSecurityScope,
        relativeTo: nil,
        bookmarkDataIsStale: &isStale
    )
    
    if isStale {
        // ユーザーに再選択を求める
        throw AppError.bookmarkStale
    }
    
    url.startAccessingSecurityScopedResource()
    return url
}

# エクスポート（xcrunを使う場合）
xcodebuild -exportArchive \
  -archivePath MyApp.xcarchive \
  -exportPath ./export \
  -exportOptionsPlist ExportOptions.plist
 
# Notarization送信
xcrun notarytool submit ./export/MyApp.zip \
  --apple-id "YOUR_APPLE_ID" \
  --team-id "YOUR_TEAM_ID" \
  --password "YOUR_APP_SPECIFIC_PASSWORD" \
  --wait
 
# Notarization完了後にStaple（証明書を埋め込む）
xcrun stapler staple ./export/MyApp.app

// ポップオーバー表示後にフォーカスを強制的に付与
DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
    self.popover.contentViewController?.view.window?.makeKeyAndOrderFront(nil)
    NSApp.activate(ignoringOtherApps: true)
}

# ライブラリのアーキテクチャを確認
lipo -info /path/to/SomeLibrary.framework/SomeLibrary