iPadOS16+浅色模式下GKGameCenterViewController子视图显示异常求助

问题背景 #

在SwiftUI应用中通过UIViewControllerRepresentable封装GKGameCenterViewController并嵌入ZStack后，出现以下特定场景的UI异常：

• 仅在iPadOS 16.1及以上版本的iPad浅色模式下，控制器子视图出现黑字配深色背景的情况，可读性极差
• 控制器顶层父视图显示正常，仅子视图受影响
• 无问题场景：
  • 全版本iPhone设备
  • iPadOS 14/15的iPad设备
  • iPadOS 16.1+设备首次展示时处于深色模式
• Game Center官方接入点打开仪表盘无此问题，推测官方采用了不同展示逻辑

环境信息 #

• 应用兼容iOS/iPadOS 14.0及以上
• 集成方式：SwiftUI标准方案，通过UIViewControllerRepresentable将GKGameCenterViewController作为ZStack的一层展示

已尝试无效操作 #

• 多种常规UI适配方案均未解决问题
• 已向苹果提交反馈，暂未收到回复

可行解决办法 #

方案1：强制同步外观模式 #

在UIViewControllerRepresentable的创建和更新方法中，强制让GKGameCenterViewController的外观与当前系统外观保持一致，避免样式不匹配：

struct GameCenterView: UIViewControllerRepresentable {
    func makeUIViewController(context: Context) -> GKGameCenterViewController {
        let gcVC = GKGameCenterViewController()
        if #available(iPadOS 16.1, *) {
            gcVC.overrideUserInterfaceStyle = UITraitCollection.current.userInterfaceStyle
        }
        return gcVC
    }
    
    func updateUIViewController(_ uiViewController: GKGameCenterViewController, context: Context) {
        // 适配模式切换场景
        if #available(iPadOS 16.1, *) {
            uiViewController.overrideUserInterfaceStyle = UITraitCollection.current.userInterfaceStyle
        }
    }
}

方案2：改用UIKit容器嵌套展示 #

通过封装UIKit容器ViewController，将GKGameCenterViewController作为子控制器添加，模拟官方接入点的层级逻辑，规避SwiftUI视图层级的样式冲突：

struct GameCenterContainerView: UIViewControllerRepresentable {
    func makeUIViewController(context: Context) -> UIViewController {
        let containerVC = UIViewController()
        let gcVC = GKGameCenterViewController()
        
        gcVC.view.frame = containerVC.view.bounds
        gcVC.autoresizingMask = [.flexibleWidth, .flexibleHeight]
        
        containerVC.addChild(gcVC)
        containerVC.view.addSubview(gcVC.view)
        gcVC.didMove(toParent: containerVC)
        
        return containerVC
    }
    
    func updateUIViewController(_ uiViewController: UIViewController, context: Context) {}
}

方案3：延迟初始化控制器 #

在iPadOS 16.1+的浅色模式下，延迟一小段时间再展示GKGameCenterViewController，给系统足够时间完成样式初始化：

struct ContentView: View {
    @State private var showGameCenter = false
    
    var body: some View {
        Button("打开Game Center") {
            triggerGameCenterPresentation()
        }
        .sheet(isPresented: $showGameCenter) {
            GameCenterView()
        }
    }
    
    private func triggerGameCenterPresentation() {
        if #available(iPadOS 16.1, *), UITraitCollection.current.userInterfaceStyle == .light {
            DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
                showGameCenter = true
            }
        } else {
            showGameCenter = true
        }
    }
}

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