Deliver age-appropriate experiences in your app

Highlight

Apple 在 iOS 26 推出了 Declared Age Range API，让 App 能以隐私保护的方式获取用户的年龄段，而不是精确生日。核心思路是：App 提交自己关心的年龄节点（比如 13 岁和 16 岁），系统返回一个区间（比如”13 到 15 岁”），而不是精确出生日期。这解决了开发者长期以来的一个两难问题——需要知道用户年龄来做内容分级，但又不想承担存储精确生日的隐私风险。

核心内容

做内容分级的开发者长期面临一个尴尬场景：要判断”这个用户能不能用社交分享功能”，最准确的办法是问生日，但一旦把精确生日存进数据库，就要面对 COPPA、GDPR-K 等一连串的合规审计。结果很多 App 干脆做一道弹窗”请确认你已年满 13 岁”，让用户随手一点过去——既没真正保护未成年人，也没解决合规问题。

iOS 26 给出了新的中间层。Declared Age Range 框架让 App 提交关心的年龄节点（最多 3 个，每个区间至少跨 2 年），系统返回一个区间值。Olivia 14 岁，App 问 13 和 16，系统就回答”13 到 15”；Emily 9 岁，得到的是”12 或更小”；42 岁的 Ann 则是”16 或更大”。生日始终留在系统里，App 只拿到决策需要的最小信息。年龄声明背后还有家长流程：儿童账号下的年龄由监护人确认，三种共享模式（Always Share / Ask First / Never Share）都由家长在”屏幕使用时间”或”家庭”设置里管理。响应有一年缓存，跨设备同步，到了周年才会重新提示，避免 App 被反复弹窗骚扰，也避免连续追问反推出生日。

详细内容

接入分两步：先在 Xcode 的 Signing & Capabilities 里加上 Declared Age Range capability，然后在 SwiftUI 里通过环境值发起请求。下面是官方示例（08:03）：

// Request an age range

import SwiftUI
import DeclaredAgeRange

struct LandmarkDetail: View {
    // ...
    @State var photoSharingEnabled = false
    @Environment(\.requestAgeRange) var requestAgeRange

    var body: some View {
        ScrollView {
            // ...
            Button("Share Photos") {}
                .disabled(!photoSharingEnabled)
        }
        .task {
            await requestAgeRangeHelper()
        }
    }

    func requestAgeRangeHelper() async {
        do {
            // TODO: Check user region
            let ageRangeResponse = try await requestAgeRange(ageGates: 16)
            switch ageRangeResponse {
            case let .sharing(range):
                 // Age range shared
                if let lowerBound = range.lowerBound, lowerBound >= 16 {
                    photoSharingEnabled = true
                }
                // guardianDeclared, selfDeclared
                print(range.ageRangeDeclaration)
            case .declinedSharing:
                // Declined to share
                print("Declined to share")
            }
        } catch AgeRangeService.Error.invalidRequest {
            print("Handle invalid request error")
        } catch AgeRangeService.Error.notAvailable {
            print("Handle not available error")
        } catch {
            print("Unhandled error: \(error)")
        }
    }
}

关键点：

import DeclaredAgeRange 引入新框架，必须先在 capability 列表里勾选才能编译通过。
@Environment(\.requestAgeRange) 拿到一个异步闭包，把请求挂在环境上是为了让系统知道在哪个窗口弹提示——iPad 多窗口、Mac 多窗口都靠它。
requestAgeRange(ageGates: 16) 只传一个年龄节点，意味着 App 只关心”16 岁分界”。需要更精细的分级可以传多个节点（最多 3 个）。
case let .sharing(range) 解出 range.lowerBound 和 range.upperBound，两端都可能为 nil：上界 nil 表示”X 岁及以上”，下界 nil 表示”X 岁及以下”。所以代码先 if let lowerBound 再比较。
range.ageRangeDeclaration 返回 guardianDeclared 或 selfDeclared：儿童恒为 guardianDeclared，加入 iCloud 家庭的青少年也是 guardianDeclared，单飞青少年和成人是 selfDeclared，可以用来决定是否需要更严格的家长背书。
invalidRequest 是开发者错误（10:33），常见原因是某个区间不足两年；notAvailable 是设备配置问题，比如用户没登 Apple 账号——这两个错误要分别处理，不能一锅端。

如果年龄区间的上界低于该地区的成年年龄，响应里还会带上 activeParentalControls，App 可以据此进一步收敛体验（11:49）：

// Request an age range

func requestAgeRangeHelper() async {
    do {
        // TODO: Check user region
        let ageRangeResponse = try await requestAgeRange(ageGates: 16)
        switch ageRangeResponse {
        case let .sharing(range):
            if range.activeParentalControls.contains(.communicationLimits) {
                print("Communication Limits enabled")
            }
            // ...
        case .declinedSharing:
            // Declined to share
            print("Declined to share")
        }
    } catch {
        // ...
    }
}