如何配置Xcode项目实现SwiftUI与AppKit兼容新旧macOS并验证入口文件

你的需求是让应用在macOS 11及以上用SwiftUI原生框架运行，旧版macOS fallback到传统AppKit模式，当前的入口文件配置存在问题，下面是完整的修正方案和配置步骤：

一、Xcode项目基础配置 #

• 打开项目设置，将「Deployment Info」里的「macOS Deployment Target」设为你要兼容的最低旧版系统（比如macOS 10.15）
• 切换到「Info」标签，删除NSMainStoryboardFile和NSApplicationSceneManifest这两个键（如果存在），因为我们要手动控制应用启动逻辑

二、修正入口文件逻辑 #

核心是创建一个统一的@main入口，根据系统版本动态选择启动方式，替换你当前的DemoSwiftUIApp.swift代码为以下内容：

import SwiftUI
import Cocoa

// 统一应用入口，根据系统版本选择启动路径
@main
struct DemoAppEntry {
    static func main() {
        if #available(macOS 11.0, *) {
            // macOS 11+ 启动SwiftUI App
            DemoSwiftUIApp.main()
        } else {
            // 旧版macOS 启动AppKit代理
            NSApplication.shared.delegate = AppDelegate()
            NSApplicationMain(CommandLine.argc, CommandLine.unsafeArgv)
        }
    }
}

// macOS 11+ 专属SwiftUI App实现
@available(macOS 11.0, *)
struct DemoSwiftUIApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

// 旧版macOS 专属AppKit代理实现
class AppDelegate: NSObject, NSApplicationDelegate {
    var window: NSWindow!

    func applicationDidFinishLaunching(_ aNotification: Notification) {
        // 用NSHostingView把SwiftUI视图包装成AppKit可识别的视图
        let contentView = ContentView()
        let hostingView = NSHostingView(rootView: contentView)
        hostingView.frame = NSRect(x: 0, y: 0, width: 480, height: 300)

        // 创建并配置窗口
        window = NSWindow(
            contentRect: NSRect(x: 0, y: 0, width: 480, height: 300),
            styleMask: [.titled, .closable, .miniaturizable, .resizable, .fullSizeContentView],
            backing: .buffered, defer: false
        )
        window.contentView = hostingView
        window.contentMinSize = NSSize(width: 480, height: 300)
        window.setContentSize(NSSize(width: 480, height: 300))
        window.center()
        window.makeKeyAndOrderFront(nil)
    }

    func applicationWillTerminate(_ aNotification: Notification) {
        // 这里可以添加应用退出前的清理逻辑
    }

    func applicationSupportsSecureRestorableState(_ app: NSApplication) -> Bool {
        return true
    }
}

关键修改说明 #

• 新增DemoAppEntry作为唯一的@main入口，解决了原代码中旧版系统找不到启动入口的问题
• 移除了原DemoSwiftUIApp上的@main标记，让它只作为SwiftUI模式的启动载体
• 删除了AppDelegate中冗余的contentView属性，避免重复实例化视图
• 优化了NSHostingView的创建方式，直接设置视图frame，不需要给SwiftUI视图额外加.frame修饰符

三、额外注意事项 #

• 确保ContentView的代码兼容所有目标版本：如果用到了macOS 11+专属的SwiftUI API，需要给对应代码块添加@available(macOS 11.0, *)标记，或者为旧版系统提供替代实现
• 测试时切换不同版本的macOS模拟器，分别验证SwiftUI和AppKit两种启动逻辑是否正常运行
• 保持项目的签名和权限配置正常，确保跨版本打包没有问题

内容的提问来源于stack exchange，提问作者Pastor J.G Seigle