Matched Geometry Effect与Window兼容问题：动画失效解决方案咨询

你的核心问题有两个：

1. 命名空间不共享：SomeView和ContentView各自使用私有@Namespace，导致matchedGeometryEffect无法识别两个视图是同一动画目标。
2. Window视图脱离SwiftUI层级：直接通过addSubview把UIHostingController的视图加到Window上，这个视图不在原SwiftUI视图树中，SwiftUI的动画系统无法追踪其状态变化，自然无法触发匹配几何动画。

修正步骤 #

1. 共享命名空间

把命名空间放到全局可访问的ObservableObject中，让参与动画的两个视图共用同一个命名空间：

class PopToRoot: ObservableObject {
    @Published var showOverlay = false
    let animationNamespace = Namespace() // 共享的动画命名空间
}

2. 重构顶层Window管理

不要手动添加/移除子视图，而是创建独立的UIWindow承载顶层视图，同时将共享的命名空间和环境对象注入进去，确保它处于SwiftUI的动画体系中：

class WindowManager: ObservableObject {
    private var overlayWindow: UIWindow?
    private let popRoot: PopToRoot
    
    init(popRoot: PopToRoot) {
        self.popRoot = popRoot
    }
    
    func showOverlay() {
        guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene else { return }
        
        // 构建顶层视图，注入环境对象和共享命名空间
        let overlayView = TopView()
            .environmentObject(popRoot)
            .matchedGeometryEffect(id: "squareAnim", in: popRoot.animationNamespace)
        
        // 创建独立Window，确保层级在所有内容之上
        overlayWindow = UIWindow(windowScene: windowScene)
        overlayWindow?.rootViewController = UIHostingController(rootView: overlayView)
        overlayWindow?.backgroundColor = .clear
        overlayWindow?.windowLevel = UIWindow.Level.alert + 1
        overlayWindow?.isHidden = false
    }
    
    func hideOverlay() {
        // 动画完成后再销毁Window，避免中断动画
        DispatchQueue.main.asyncAfter(deadline: .now() + 0.3) {
            self.overlayWindow?.isHidden = true
            self.overlayWindow = nil
        }
    }
}

3. 修改子视图与顶层视图

• 子视图SomeView改用共享命名空间：

struct SomeView: View {
    @EnvironmentObject var popRoot: PopToRoot
    
    var body: some View {
        ScrollView {
            RoundedRectangle(cornerRadius: 10)
                .matchedGeometryEffect(id: "squareAnim", in: popRoot.animationNamespace)
                .foregroundStyle(.blue)
                .frame(width: 50, height: 50)
                .onTapGesture {
                    withAnimation {
                        popRoot.showOverlay = true
                    }
                }
            // 其他子视图
        }
    }
}

• 顶层视图TopView添加关闭逻辑，并使用共享命名空间：

struct TopView: View {
    @EnvironmentObject var popRoot: PopToRoot
    
    var body: some View {
        ZStack {
            // 半透明背景，点击可关闭
            Color.black.opacity(0.5)
                .ignoresSafeArea()
                .onTapGesture {
                    withAnimation {
                        popRoot.showOverlay = false
                    }
                }
            
            RoundedRectangle(cornerRadius: 10)
                .foregroundStyle(.blue)
                .frame(width: 100, height: 100)
                .matchedGeometryEffect(id: "squareAnim", in: popRoot.animationNamespace)
        }
    }
}

4. 顶层视图入口整合

在ContentView中监听状态变化，调用Window管理器的显示/隐藏方法：

struct ContentView: View {
    @StateObject private var popRoot = PopToRoot()
    @StateObject private var windowManager: WindowManager
    
    init() {
        let popRoot = PopToRoot()
        _windowManager = StateObject(wrappedValue: WindowManager(popRoot: popRoot))
        _popRoot = StateObject(wrappedValue: popRoot)
    }
    
    var body: some View {
        SomeView()
            .environmentObject(popRoot)
            .onChange(of: popRoot.showOverlay) { newValue in
                if newValue {
                    windowManager.showOverlay()
                } else {
                    windowManager.hideOverlay()
                }
            }
    }
}

关键说明 #

• 命名空间共享：这是matchedGeometryEffect生效的前提，只有同一命名空间下的视图才能完成几何匹配。
• Window层级：设置windowLevel = UIWindow.Level.alert + 1确保顶层视图能显示在所有sheets、弹窗之上。
• 动画驱动：始终用SwiftUI的withAnimation包裹状态变化，让动画系统自动处理两个视图的几何过渡，不要手动操作UIKit视图的frame或alpha。

内容的提问来源于stack exchange，提问作者Ahmed Zaidan