iMessage App如何基于URL路径控制视图显隐实现多视图导航

核心逻辑和普通UIKit页面切换没有本质差异，绝大多数人卡在这里的原因是URL解析逻辑放错了生命周期位置，没有覆盖iMessage扩展的所有状态变化场景，参考以下实现即可达到GamePigeon的交互效果：

1. 先做路径和视图的映射，统一管理显隐逻辑 #

不要零散写单个视图的显示/隐藏代码，先把5个视图和对应的URL路径做枚举绑定，再写统一的视图切换方法，从根源避免漏隐藏、路径硬配出错的问题：

// 路径枚举和你设置的URL path完全对应即可
enum GameViewPath: String {
    case home = "/"
    case second = "/secondView/"
    // 剩余3个视图按自己的路径补全
    case third = "/thirdView/"
    case fourth = "/fourthView/"
    case gamePlaying = "/playing/"
}

private func switchToView(path: GameViewPath) {
    // 第一步先把所有视图全部隐藏，避免多视图同时显示
    [homeView, secondView, thirdView, fourthView, playingView].forEach {
        $0.isHidden = true
    }
    // 单独显示目标视图
    switch path {
    case .home: homeView.isHidden = false
    case .second: secondView.isHidden = false
    case .third: thirdView.isHidden = false
    case .fourth: fourthView.isHidden = false
    case .gamePlaying: playingView.isHidden = false
    }
}

2. 把URL解析逻辑放到正确的系统回调中 #

注意：不要只在viewDidLoad里做一次URL判断，iMessage扩展的会话状态会随用户点击消息、切换会话动态变化，必须在系统提供的会话回调里触发视图切换
重写MSMessagesAppViewController的两个核心回调，覆盖所有触发视图切换的场景：

// 应用激活时触发（用户点击消息气泡进入扩展、切回iMessage扩展都会走这个方法）
override func willBecomeActive(with conversation: MSConversation) {
    super.willBecomeActive(with: conversation)
    // 解析当前选中消息的URL
    guard let selectedMsg = conversation.selectedMessage,
          let urlComp = URLComponents(url: selectedMsg.url, resolvingAgainstBaseURL: false),
          let targetPath = GameViewPath(rawValue: urlComp.path) else {
        // 无匹配路径默认显示首页视图
        switchToView(path: .home)
        return
    }
    switchToView(path: targetPath)
}

// 用户在会话内切换选中的消息气泡时触发
override func didSelect(_ message: MSMessage, conversation: MSConversation) {
    super.didSelect(message, conversation: conversation)
    guard let urlComp = URLComponents(url: message.url, resolvingAgainstBaseURL: false),
          let targetPath = GameViewPath(rawValue: urlComp.path) else {
        switchToView(path: .home)
        return
    }
    switchToView(path: targetPath)
}

3. 常见问题排查 #

• 路径匹配严格区分格式：/secondView和/secondView/是完全不同的path，构造MSMessage的URL时要和枚举值完全一致，不要漏写末尾斜杠
• 不要用url.absoluteString做字符串匹配，必须通过URLComponents读取path属性匹配，避免URL携带query参数、scheme差异导致匹配失败
• 发送新消息后需要立刻切视图的场景（比如用户走完操作发送游戏回合），不需要等系统回调，发送逻辑执行完直接调用switchToView传对应路径即可，GamePigeon的回合切换就是用的这个逻辑
• 视图显隐用isHidden属性实现，不要用alpha = 0，否则透明视图会拦截用户点击，导致交互异常
• 如果需要加转场动画，直接在switchToView方法里包UIView.transition动画即可，和普通UIKit页面的动画逻辑没有区别，不需要做iMessage环境特殊适配

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