Mac Catalyst 17中dialogIcon视图修饰符报错咨询：提示iOS不可用

问题原因 #

Mac Catalyst基于iOS运行时环境，即使你通过#if targetEnvironment(macCatalyst)做了编译时判断，编译器仍会检查iOS平台的API可用性。而dialogIcon是Mac Catalyst 17专属的SwiftUI修饰符，在iOS中不存在，因此触发了「‘dialogIcon' is unavailable in iOS」的错误。

解决方案 #

以下两种方法均可规避该编译错误：

方法一：封装专属扩展方法

创建一个仅在Mac Catalyst 17+环境下可用的View扩展，将dialogIcon的调用封装进去，让编译器正确识别API的可用性范围：

import SwiftUI

// 封装仅Mac Catalyst 17+可用的dialogIcon调用
extension View {
    @available(macCatalyst 17.0, *)
    private func _macDialogIcon(_ image: Image) -> some View {
        self.dialogIcon(image)
    }
}

struct DialogIcon: ViewModifier {
    let icon: String

    func body(content: Content) -> some View {
        if #available(macCatalyst 17.0, *) {
            content._macDialogIcon(Image(systemName: icon))
        } else {
            content
        }
    }
}

extension View {
    func dialogIconModifier(icon: String) -> some View {
        modifier(DialogIcon(icon: icon))
    }
}

方法二：结合编译时与运行时判断

通过#if targetEnvironment(macCatalyst)限定编译范围，同时用@available标注运行时版本要求，将dialogIcon的调用隔离在专属代码块中：

import SwiftUI

struct DialogIcon: ViewModifier {
    let icon: String

    func body(content: Content) -> some View {
#if targetEnvironment(macCatalyst)
        @available(macCatalyst 17.0, *)
        func applyDialogIcon() -> some View {
            content.dialogIcon(Image(systemName: icon))
        }
        
        if #available(macCatalyst 17.0, *) {
            applyDialogIcon()
        } else {
            content
        }
#else
        content
#endif
    }
}

extension View {
    func dialogIconModifier(icon: String) -> some View {
        modifier(DialogIcon(icon: icon))
    }
}

额外注意事项 #

• 若需支持macOS 13.6（对应Mac Catalyst 16.4），请勿将项目的Mac Catalyst部署目标直接升到17.0，保留版本判断逻辑即可。
• dialogIcon在「缩放以匹配iPad」和「针对Mac优化」两种界面模式下均可用，只要系统版本满足Mac Catalyst 17+要求。

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