如何为macOS平台GUI录屏应用添加命令行支持？

当然可行！macOS 平台的 GUI 应用完全可以同时支持命令行控制，我之前就给类似的录屏 App 做过类似功能，下面是具体的实现思路和步骤：

1. 先封装录屏核心逻辑 #

首先要把录屏的启动、停止、配置等核心逻辑从 UI 代码里抽离出来，做成一个独立的工具类（比如叫 ScreenRecorder）。这样不管是 GUI 按钮触发还是命令行指令调用，都能复用同一套逻辑，避免代码冗余。

举个 Swift 示例（用 AVFoundation 实现录屏）：

import AVFoundation

class ScreenRecorder {
    static let shared = ScreenRecorder()
    private var captureSession: AVCaptureSession?
    private var movieOutput: AVCaptureMovieFileOutput?
    
    func startRecording(outputURL: URL = URL(fileURLWithPath: "\(NSHomeDirectory())/Desktop/recording.mp4")) {
        // 检查屏幕录制权限
        guard checkScreenRecordingPermission() else {
            print("请先授予屏幕录制权限")
            return
        }
        
        // 初始化录屏会话
        captureSession = AVCaptureSession()
        guard let displayInput = AVCaptureScreenInput(displayID: CGMainDisplayID()) else { return }
        if captureSession?.canAddInput(displayInput) ?? false {
            captureSession?.addInput(displayInput)
        }
        
        // 设置输出
        movieOutput = AVCaptureMovieFileOutput()
        if captureSession?.canAddOutput(movieOutput!) ?? false {
            captureSession?.addOutput(movieOutput!)
        }
        
        captureSession?.startRunning()
        movieOutput?.startRecording(to: outputURL, recordingDelegate: self)
        print("开始录屏，文件将保存到: \(outputURL.path)")
    }
    
    func stopRecording() {
        guard let movieOutput = movieOutput else {
            print("当前没有正在进行的录屏")
            return
        }
        movieOutput.stopRecording()
        captureSession?.stopRunning()
        captureSession = nil
        self.movieOutput = nil
        print("录屏已停止")
    }
    
    private func checkScreenRecordingPermission() -> Bool {
        let status = AVCaptureDevice.authorizationStatus(for: .screen)
        switch status {
        case .authorized:
            return true
        case .notDetermined:
            var granted = false
            let semaphore = DispatchSemaphore(value: 0)
            AVCaptureDevice.requestAccess(for: .screen) { success in
                granted = success
                semaphore.signal()
            }
            semaphore.wait()
            return granted
        default:
            return false
        }
    }
}

extension ScreenRecorder: AVCaptureFileOutputRecordingDelegate {
    func fileOutput(_ output: AVCaptureFileOutput, didFinishRecordingTo outputFileURL: URL, from connections: [AVCaptureConnection], error: Error?) {
        if let error = error {
            print("录屏失败: \(error.localizedDescription)")
        } else {
            print("录屏文件已保存: \(outputFileURL.path)")
        }
    }
}

2. 添加命令行参数解析 #

接下来要让应用能识别并处理命令行传入的 -start、-stop 等参数。macOS 应用的命令行参数可以通过两种方式传入：

• 直接调用 App 包内的可执行文件：/Applications/MyApp.app/Contents/MacOS/MyApp -start
• 通过 open 命令传递参数：open -a MyApp --args -start

参数解析的实现方式 #

对于 SwiftUI 应用

在 @main 标记的 App 结构体里，直接读取 CommandLine.arguments 来判断参数：

@main
struct MyScreenRecorderApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
                .onAppear {
                    processCommandLineArguments()
                }
        }
    }
    
    private func processCommandLineArguments() {
        let args = CommandLine.arguments
        if args.contains("-start") {
            ScreenRecorder.shared.startRecording()
            // 如果希望命令行启动时不显示GUI窗口，可以关闭主窗口并设置后台运行
            NSApp.windows.first?.close()
            NSApp.setActivationPolicy(.accessory)
        } else if args.contains("-stop") {
            ScreenRecorder.shared.stopRecording()
            // 停止后可以选择退出App
            NSApp.terminate(nil)
        }
    }
}

对于 AppKit 应用

在 AppDelegate 的 applicationDidFinishLaunching 方法里处理参数：

func applicationDidFinishLaunching(_ aNotification: Notification) {
    let args = CommandLine.arguments
    if args.contains("-start") {
        ScreenRecorder.shared.startRecording()
        NSApp.windows.first?.close()
        NSApp.setActivationPolicy(.accessory)
    } else if args.contains("-stop") {
        ScreenRecorder.shared.stopRecording()
        NSApp.terminate(nil)
    }
}

3. 优化命令行调用体验 #

完成代码修改后，打包或直接运行应用，然后在终端测试：

• 启动录屏：/Applications/MyApp.app/Contents/MacOS/MyApp -start
• 停止录屏：/Applications/MyApp.app/Contents/MacOS/MyApp -stop

如果希望更方便地调用，可以给这个可执行文件加一个别名，比如在 ~/.zshrc 里添加：

alias myapp="/Applications/MyApp.app/Contents/MacOS/MyApp"

之后就可以直接用 myapp -start、myapp -stop 来操作了。

进阶：支持更多参数（可选） #

如果需要更复杂的命令行控制（比如指定录屏区域、输出路径、是否录制音频），可以用成熟的参数解析库：

• Swift 可以用 ArgumentParser（苹果官方推出的库，支持类型安全的参数解析）
• Objective-C 可以用 getopt 函数来解析短参数

内容的提问来源于stack exchange，提问作者Nick