如何借助WidgetKit在watchOS上隐藏Complication中的敏感数据？

API 探路者

2026-6-12

如何在Apple Watch锁定状态下隐藏Complication中的敏感信息？

问题背景

需要在Complication的两种场景下隐藏敏感信息：

Always-On 显示状态
手表锁定状态（如未佩戴、手动锁定）

目前已通过@Environment(\.isLuminanceReduced)处理Always-On状态的内容遮罩，但.privacySensitive()无法自动在锁定状态生效（仅当用户手动在系统设置中开启隐私遮罩时才起作用），需要找到强制在锁定状态隐藏敏感信息的方法。

解决方案

使用WatchOS 9及以上提供的@Environment(\.isLocked)环境变量，该变量会在手表锁定时自动变为true，结合它和isLuminanceReduced共同判断是否需要遮罩敏感内容。

步骤1：更新隐私处理方法

修改原有的preservePrivacy方法，同时监听isLocked和isLuminanceReduced状态：

@ViewBuilder func preservePrivacy(isLuminanceReduced: Bool, isLocked: Bool) -> some View {
    if isLuminanceReduced || isLocked {
        self
            .redacted(reason: .placeholder)
    } else {
        self
    }
}

步骤2：在Widget中使用更新后的方法

在Widget的View中注入isLocked环境变量，传递给处理方法：

struct YourComplicationView: View {
    let entry: Provider.Entry
    @Environment(\.isLuminanceReduced) private var isLuminanceReduced
    @Environment(\.isLocked) private var isLocked // 新增环境变量

    var body: some View {
        Text(entry.code)
            .preservePrivacy(isLuminanceReduced: isLuminanceReduced, isLocked: isLocked)
            .widgetCurvesContent()
            .widgetLabel {
                Text("PIN")
                    .widgetAccentable()
                    .foregroundStyle(.secondary)
            }
            .containerBackground(.teal.gradient, for: .widget)
    }
}